From ded15b4a70908616498f133d404d9dd420226bd9 Mon Sep 17 00:00:00 2001 From: Steve Sutton Date: Mon, 10 Oct 2016 14:25:48 -0400 Subject: [PATCH] First Sources --- activate.php | 165 +++++++++++++ assets/readme.txt | 2 + classes/data/dataSample.php | 162 +++++++++++++ config/plugin.ini | 8 + css/readme.txt | 1 + deactivate.php | 73 ++++++ defines.php | 67 +++++ index.php | 229 ++++++++++++++++++ js/readme.txt | 1 + misc/documentation/AddAnAdminTab.txt | 15 ++ misc/documentation/CreateNewAddOn.txt | 54 +++++ models/admin/info/index.php | 125 ++++++++++ models/admin/members/sample.php | 103 ++++++++ models/admin/readme.txt | 5 + models/admin/sample/index.php | 125 ++++++++++ models/admin/sample/more.php | 125 ++++++++++ models/front/readme.txt | 7 + readme.txt | 27 +++ setup/adminHooks.php | 39 +++ setup/adminMenus.php | 100 ++++++++ setup/adminTabs.php | 62 +++++ .../examples/create_database_V0.0.1.sql | 42 ++++ setup/databaseScripts/examples/dbVersions.php | 40 +++ .../examples/drop_database_V0.0.1.sql | 12 + setup/databaseScripts/examples/readme.txt | 25 ++ .../examples/update_database_V0.0.2.php | 54 +++++ .../examples/update_database_V0.0.2.sql | 21 ++ setup/databaseScripts/readme.txt | 10 + setup/frontHooks.php | 39 +++ setup/hooksHelp.html | 70 ++++++ setup/permissions.php | 56 +++++ setup/rolesAndCapabilities.php | 31 +++ setup/shortcodes.php | 107 ++++++++ setup/validActions.php | 70 ++++++ uninstall.php | 36 +++ views/admin/info/index.html | 6 + views/admin/members/sample.html | 6 + views/admin/readme.txt | 5 + views/admin/sample/index.html | 7 + views/admin/sample/more.html | 6 + views/front/readme.txt | 7 + 41 files changed, 2145 insertions(+) create mode 100644 activate.php create mode 100644 assets/readme.txt create mode 100644 classes/data/dataSample.php create mode 100644 config/plugin.ini create mode 100644 css/readme.txt create mode 100644 deactivate.php create mode 100644 defines.php create mode 100644 index.php create mode 100644 js/readme.txt create mode 100644 misc/documentation/AddAnAdminTab.txt create mode 100644 misc/documentation/CreateNewAddOn.txt create mode 100644 models/admin/info/index.php create mode 100644 models/admin/members/sample.php create mode 100644 models/admin/readme.txt create mode 100644 models/admin/sample/index.php create mode 100644 models/admin/sample/more.php create mode 100644 models/front/readme.txt create mode 100644 readme.txt create mode 100644 setup/adminHooks.php create mode 100644 setup/adminMenus.php create mode 100644 setup/adminTabs.php create mode 100644 setup/databaseScripts/examples/create_database_V0.0.1.sql create mode 100644 setup/databaseScripts/examples/dbVersions.php create mode 100644 setup/databaseScripts/examples/drop_database_V0.0.1.sql create mode 100644 setup/databaseScripts/examples/readme.txt create mode 100644 setup/databaseScripts/examples/update_database_V0.0.2.php create mode 100644 setup/databaseScripts/examples/update_database_V0.0.2.sql create mode 100644 setup/databaseScripts/readme.txt create mode 100644 setup/frontHooks.php create mode 100644 setup/hooksHelp.html create mode 100644 setup/permissions.php create mode 100644 setup/rolesAndCapabilities.php create mode 100644 setup/shortcodes.php create mode 100644 setup/validActions.php create mode 100644 uninstall.php create mode 100644 views/admin/info/index.html create mode 100644 views/admin/members/sample.html create mode 100644 views/admin/readme.txt create mode 100644 views/admin/sample/index.html create mode 100644 views/admin/sample/more.html create mode 100644 views/front/readme.txt diff --git a/activate.php b/activate.php new file mode 100644 index 0000000..fb8cc1e --- /dev/null +++ b/activate.php @@ -0,0 +1,165 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release activate.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file activates this add-on. Other than replacing the various + * versions of the work "Conditions", this code should not need editing. + * + * Remove this message before using this file in production! + **********************************************************************/ + +// Check that we're being called by WordPress. +if (!defined('ABSPATH')) { + die("Please do not call this code directly!"); +} + +/* + * This class performs all necessary additional work when this + * plugin is activated. + * + * Currently the only actions are to add role capability to display and modify + * prototypes. + */ +class glmMembersConditionsPluginActivate +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + + /* + * Constructor + * + * Note that the $noDatabaseCheck is used to access the database versions + * without triggering a database check. + * + * Performs all the work for this model + */ + public function __construct ($wpdb, $config) + { + + // Make sure the current user has this capability + if (! current_user_can('activate_plugins')) { + $this->addNotice("Interesting, you don't have permission to activate plugins."); + die(); + } + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + // Set current plugin version + update_option('glmMembersDatabaseConditionsPluginVersion', GLM_MEMBERS_CONDITIONS_PLUGIN_VERSION); + + // Set Roles and Capabilities for this plugin + require_once GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH.'/rolesAndCapabilities.php'; + } + + /* + * Add a capability to all current roles + * + * @param string $capability Name of capability to add + * @param array $default Whether capability should be on by default + * array( + * 'author' => false, + * 'contributor' => false, + * 'editor' => false, + * 'subscriber' => false + * ) + * + * @return void + * @access private + */ + private function addRoleCapability($capability, $default) + { + // Get list of role objects + $roleObjects = $GLOBALS['wp_roles']->role_objects; + + // Get list of roles we can edit + $roles = get_editable_roles(); + + // For each role object + foreach ($roleObjects as $key => $role) { + + // Check if the role exists in list of editable roles and + // the capability does not exist + if (isset($roles[$key]) && ! isset($role->capabilities[$capability])) { + + // Check if a default value has been specified in the $default array + $enabled = false; + if (isset($default[$role->name])) { + + // It has, so use that + $enabled = $default[$role->name]; + + } + + // Add the role + $role->add_cap($capability, $enabled); + + } + } + } + + + /* + * Delete a capability from all current roles + * + * @param string $capability Name of capability to add + * + * @return void + * @access private + */ + private function deleteRoleCapability($capability) + { + // Get list of role objects + $roleObjects = $GLOBALS['wp_roles']->role_objects; + + // Get list of roles we can edit + $roles = get_editable_roles(); + + // For each role object + foreach ($roleObjects as $key => $role) { + + if ( isset($role->capabilities[$capability])) { + $role->remove_cap($capability); + } + + } + + } + + + +} diff --git a/assets/readme.txt b/assets/readme.txt new file mode 100644 index 0000000..34a6135 --- /dev/null +++ b/assets/readme.txt @@ -0,0 +1,2 @@ +Assets folder for things like images and other +files that might need to be read directly. \ No newline at end of file diff --git a/classes/data/dataSample.php b/classes/data/dataSample.php new file mode 100644 index 0000000..fd774de --- /dev/null +++ b/classes/data/dataSample.php @@ -0,0 +1,162 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release SVN: $Id: dataConditions.php,v 1.0 2011/01/25 19:31:47 cscott Exp $ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * Data fields in this file are conditions only. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/** + * GlmDataConditions class + * + * PHP version 5 + * + * @category Data + * @package GLM Member DB + * @author Chuck Scott + * @license http://www.gaslightmedia.com Gaslightmedia + * @release SVN: $Id: dataMembers.php,v 1.0 2011/01/25 19:31:47 cscott + * Exp $ + */ +class GlmDataConditions extends GlmDataAbstract +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + /** + * Data Table Name + * + * @var $table + * @access public + */ + public $table; + /** + * Field definitions + * + * 'type' is type of field as defined by the application + * text Regular text field + * pointer Pointer to an entry in another table + * 'filters' is the filter name for a particular filter ID in PHP filter + * functions + * See PHP filter_id() + * + * 'use' is when to use the field + * l = List + * g = Get + * n = New + * i = Insert + * e = Edit + * u = Update + * d = Delete + * a = All + * + * @var $ini + * @access public + */ + public $fields = false; + + /** + * Constructor + * + * @param object $d database connection + * @param array $config Configuration array + * @param bool $limitedEdit Flag to say indicate limited edit requested + * + * @return void + * @access public + */ + public function __construct($wpdb, $config, $limitedEdit = false) + { + + // If this class is not being extended along with existing $wpdb and $config + if (!$this->wpdb) { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + } + + /* + * Table Name + */ + $this->table = GLM_MEMBERS_CONDITIONS_PLUGIN_DB_PREFIX . 'conditionstable'; + + /* + * Table Data Fields + */ + + $this->fields = array ( + + 'id' => array ( + 'field' => 'id', + 'type' => 'integer', + 'view_only' => true, + 'use' => 'a' + ), + + // Active flag + 'active' => array ( + 'field' => 'active', + 'type' => 'checkbox', + 'default' => true, + 'use' => 'a' + ) + + ); + + } + + /* + * Entry Post Processing Call-Back Method + * + * Perform post-processing for all result entries. + * + * In this case we're using it to append an array of category + * data to each row result and also sort by name. + * + * @param array $r Array of field result data for a single entry + * @param string $a Action being performed (l, i, g, ...) + * + * @return object Class object + * + */ + public function entryPostProcessing($r, $a) + { + return $r; + } + +} + +?> \ No newline at end of file diff --git a/config/plugin.ini b/config/plugin.ini new file mode 100644 index 0000000..1069061 --- /dev/null +++ b/config/plugin.ini @@ -0,0 +1,8 @@ +; +; Main Configuration File +; Gaslight Media Members Database Conditions Add-On Plugin +; +; Place any static configuration parameters here. +; + +[common] diff --git a/css/readme.txt b/css/readme.txt new file mode 100644 index 0000000..954cc9c --- /dev/null +++ b/css/readme.txt @@ -0,0 +1 @@ +Add admin.css and/or front.css to this directory to have those registered automatically. \ No newline at end of file diff --git a/deactivate.php b/deactivate.php new file mode 100644 index 0000000..e856591 --- /dev/null +++ b/deactivate.php @@ -0,0 +1,73 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release admin.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file deactivates this add-on. Other than replacing the various + * versions of the work "Conditions", this code should not need editing. + * + * Remove this message before using this file in production! + **********************************************************************/ + +// Check that we're being called by WordPress. +if (!defined('ABSPATH')) { + die("Please do not call this code directly!"); +} + +/* + * This class performs all necessary additional work when this + * plugin is deactivated. + */ +class glmMembersConditionsPluginDeactivate +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + + /* + * Constructor + * + * Performs all the work for this model + */ + public function __construct ($wpdb, $config) + { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + // Delete our version from WordPress Options + delete_option('glmMembersDatabaseConditionsPluginVersion'); + } + +} diff --git a/defines.php b/defines.php new file mode 100644 index 0000000..1c7be4c --- /dev/null +++ b/defines.php @@ -0,0 +1,67 @@ +prefix.'glm_membersConditions_'); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_ACTIVE_DB_OPTION', 'glmMembersConditionsDbVersion'); + +// Determine which system we're running on - If not provided, assume PRODUCTION +$host = getenv('GLM_HOST_ID'); +if (trim($host) == '') { + $host = 'PRODUCTION'; +} +define('GLM_MEMBER_CONDITIONS_PLUGIN_HOST', $host); + +// Determine current http/https protocol +$pageProtocol = 'http'; +if (isset($_SERVER['SERVER_PORT']) && $_SERVER['SERVER_PORT'] == '443') { + $pageProtocol = 'https'; +} +define('GLM_MEMBERS_CONDITIONS_PLUGIN_HTTP_PROTOCOL', $pageProtocol); + +// Get various pieces of the URL +$urlParts = parse_url(get_bloginfo('url')); +$pageUri = explode('?', $_SERVER['REQUEST_URI']); // Bust this up to access URL path and script name only + +$WPUploadDir = wp_upload_dir(); + +// URLs +define('GLM_MEMBERS_CONDITIONS_SITE_BASE_URL', home_url('/') ); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_URL', plugin_dir_url(__FILE__)); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_ADMIN_URL', admin_url('admin.php')); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_BASE_URL', WP_PLUGIN_URL.'/'.GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_CURRENT_URL', $urlParts['scheme'].'://'.$urlParts['host'].$pageUri[0]); + +// Directories +define('GLM_MEMBERS_CONDITIONS_PLUGIN_PATH', dirname(__FILE__)); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH', GLM_MEMBERS_CONDITIONS_PLUGIN_PATH.'/setup'); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_DB_SCRIPTS', GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH.'/databaseScripts'); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_CLASS_PATH', GLM_MEMBERS_CONDITIONS_PLUGIN_PATH.'/classes'); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_CONFIG_PATH', GLM_MEMBERS_CONDITIONS_PLUGIN_PATH.'/config'); + +// Parameters related to the Main GLM Member DB plugin - Depending on what's going on these may already defined by the main plugin +$pluginsPath = str_replace(GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, '', GLM_MEMBERS_CONDITIONS_PLUGIN_PATH); +define('GLM_MEMBERS_CONDITIONS_MAIN_PLUGIN_PATH', $pluginsPath.'/glm-member-db'); +define('GLM_MEMBERS_CONDITIONS_PLUGIN_LIB_PATH', GLM_MEMBERS_CONDITIONS_MAIN_PLUGIN_PATH.'/lib'); + diff --git a/index.php b/index.php new file mode 100644 index 0000000..a2ed674 --- /dev/null +++ b/index.php @@ -0,0 +1,229 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @version 1.1.1 + */ + +/* + * Plugin and Database Versions + * + * Note that the database version matches the version of the last + * plugin version where there was a change in the database. + * + * Updates to checkDatabase() in glmPluginSupport.php must be + * made together with the DB_VERSION below. ONLY bump the DB + * version when there's a change in the database!! Use the + * version nunmber of that release for the DB version. + * + * We check the plugin version stored in the WordPress option below + * so that we're sure the other add-ons see an up to date + * version from this plugin. + */ +define('GLM_MEMBERS_CONDITIONS_PLUGIN_VERSION', '0.0.7'); +// define('GLM_MEMBERS_CONDITIONS_PLUGIN_DB_VERSION', '0.0.1'); + +// This is the minimum version of the GLM Members DB plugin require for this plugin. +define('GLM_MEMBERS_CONDITIONS_PLUGIN_MIN_MEMBERS_REQUIRED_VERSION', '1.0.57'); + +// Check if plugin version is not current in WordPress option and if needed updated it +if (GLM_MEMBERS_CONDITIONS_PLUGIN_VERSION != get_option('glmMembersDatabaseConditionsPluginVersion')) { + update_option('glmMembersDatabaseConditionsPluginVersion', GLM_MEMBERS_CONDITIONS_PLUGIN_VERSION); +} + +/* + * Copyright 2014 Charles Scott (email : cscott@gaslightmedia.com) + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License, version 2, as + * published by the Free Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + */ + + +// Check that we're being called by WordPress. +if (!defined('ABSPATH')) { + die("Please do not call this code directly!"); +} + +/* +* Some initial setup and tests +*/ + +$startupNotices = ''; + +// Get standard defined parameters +require_once 'defines.php'; + +// Required to be able to get user capabilities when being called as a filter from the main plugin +require_once ABSPATH . 'wp-includes/pluggable.php'; + +// Include defines to tell if a plugin is active +include_once ABSPATH . 'wp-admin/includes/plugin.php'; + +/* + * Do some preliminary sanity checks + */ + +// Check if database version should be defined and it isn't - This would be a plugin/add-on setup issue +if (is_file(GLM_MEMBERS_CONDITIONS_PLUGIN_PATH.'/setup/databaseScripts/dbVersions.php') && !defined('GLM_MEMBERS_CONDITIONS_PLUGIN_DB_VERSION')) { + die('You have database scripts but have not defined a current database version at the top of index.php for this plugin/add-on!'); +} + +/* + * Check installation, activation, and version of main Member DB plugin + */ + +// Check for main plugin and that it's active +function glmMembersConditionsPluginRequired() { + echo ' +
+

The '.GLM_MEMBERS_CONDITIONS_PLUGIN_NAME.' add-on requires the base GLM Member DB plugin to be installed and active!

+

The '.GLM_MEMBERS_CONDITIONS_PLUGIN_NAME.' plugin has been de-activated.

+
+ '; +} +$plugin_name = 'glm-member-db/index.php'; +$is_active = is_plugin_active($plugin_name); +if ($is_active != '1') { + add_action( 'admin_notices', 'glmMembersConditionsPluginRequired' ); + deactivate_plugins('/'.GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG.'/index.php'); +} + +// Check for Minimum DB version for main Member DB +function glmMembersPluginConditionsMinVerRequired() { + echo ' +
+

The '.GLM_MEMBERS_CONDITIONS_PLUGIN_NAME.' requires that the main GLM Member DB plugin version be no older than ' + .GLM_MEMBERS_CONDITIONS_PLUGIN_MIN_MEMBERS_REQUIRED_VERSION.'!
+ '.GLM_MEMBERS_CONDITIONS_MIN_VERSION_NOTE.'

+

The '.GLM_MEMBERS_CONDITIONS_PLUGIN_NAME.' plugin has been de-activated.

+
+ '; +} +$glmMembersDatabasePluginVersion = get_option('glmMembersDatabasePluginVersion'); +if (version_compare($glmMembersDatabasePluginVersion, GLM_MEMBERS_CONDITIONS_PLUGIN_MIN_MEMBERS_REQUIRED_VERSION) < 0) { + define('GLM_MEMBERS_CONDITIONS_MIN_VERSION_NOTE', "Members DB: $glmMembersDatabasePluginVersion, Conditions Requires: ".GLM_MEMBERS_CONDITIONS_PLUGIN_MIN_MEMBERS_REQUIRED_VERSION); + add_action( 'admin_notices', 'glmMembersPluginConditionsMinVerRequired'); + deactivate_plugins('/'.GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG.'/'.GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG.'.php'); +} + +/* + * Register this add-on with the main GLM Member DB plugin and get information on all add-ons loaded. + */ +require_once GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH.'/validActions.php'; +require_once GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH.'/shortcodes.php'; +if (is_file(GLM_MEMBERS_CONDITIONS_PLUGIN_DB_SCRIPTS.'/dbVersions.php')) { + require_once GLM_MEMBERS_CONDITIONS_PLUGIN_DB_SCRIPTS.'/dbVersions.php'; +} + +// Load Conditions Management Settings data +/* None - Need to figure out a smooth way to do this. +$conditionsManagementSettings = $wpdb->get_row( "SELECT * FROM ".GLM_MEMBERS_CONDITIONS_PLUGIN_DB_PREFIX."management WHERE id = 1", ARRAY_A ); +unset($conditionsManagementSettings['id']); +*/ + +function glmMembersRegisterConditions($addOns) { + + // Add this add-on to the add-ons array + $addOns[GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG] = array( + 'dir' => GLM_MEMBERS_CONDITIONS_PLUGIN_PATH, + 'name' => GLM_MEMBERS_CONDITIONS_PLUGIN_NAME, + 'short_name' => GLM_MEMBERS_CONDITIONS_PLUGIN_SHORT_NAME, + 'slug' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, + 'actions' => $GLOBALS['glmMembersConditionsAddOnValidActions'], + 'config' => array( + ), + 'shortcodes' => $GLOBALS['glmMembersConditionsShortcodes'], + 'shortcodesDescription' => $GLOBALS['glmMembersConditionsShortcodesDescription'] + ); + + // If we have database tables for this plugin/addon, provide that data also + if (isset($GLOBALS['glmMembersConditionsDbVersions'])) { + $addOns[GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG]['database'] = array( + 'dbPrefix' => GLM_MEMBERS_CONDITIONS_PLUGIN_DB_PREFIX, + 'dbCurrentVersion' => GLM_MEMBERS_CONDITIONS_PLUGIN_DB_VERSION, + 'dbActiveVersionOption' => GLM_MEMBERS_CONDITIONS_PLUGIN_ACTIVE_DB_OPTION, + 'dbScriptPath' => GLM_MEMBERS_CONDITIONS_PLUGIN_DB_SCRIPTS, + 'dbVersions' => $GLOBALS['glmMembersConditionsDbVersions'] + ); + } else { + $addOns[GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG]['database'] = false; + } + + // Return the array with our data added + return $addOns; +} +add_filter('glm-member-db-register-addon','glmMembersRegisterConditions', 10, 1); + + /* + * + * Activate and Deactivate hooks + * + */ + + // Activate + function glmMembersConditionsPluginActivate () + { + global $wpdb, $config; + require_once GLM_MEMBERS_CONDITIONS_PLUGIN_PATH . '/activate.php'; + new glmMembersConditionsPluginActivate($wpdb, $config); + } + register_activation_hook(__FILE__, 'glmMembersConditionsPluginActivate'); + + // Deactivate + function glmMembersConditionsPluginDeactivate () + { + global $wpdb, $config; + require_once GLM_MEMBERS_CONDITIONS_PLUGIN_PATH . '/deactivate.php'; + $x = new glmMembersConditionsPluginDeactivate($wpdb, $config); + return false; + } + register_deactivation_hook(__FILE__, 'glmMembersConditionsPluginDeactivate'); + +/* + * Hooks for testing capabilities provided by this add-on + */ +require_once GLM_MEMBERS_CONDITIONS_PLUGIN_SETUP_PATH.'/permissions.php'; + diff --git a/js/readme.txt b/js/readme.txt new file mode 100644 index 0000000..f642355 --- /dev/null +++ b/js/readme.txt @@ -0,0 +1 @@ +Add admin.js and/or front.js to this directory to have those registered automatically. \ No newline at end of file diff --git a/misc/documentation/AddAnAdminTab.txt b/misc/documentation/AddAnAdminTab.txt new file mode 100644 index 0000000..c697b47 --- /dev/null +++ b/misc/documentation/AddAnAdminTab.txt @@ -0,0 +1,15 @@ +Add an admin tab + +* Add a new section in setup/adminTabs.php + +* Add a model file - models/admin/{menu}/{action}.php + +* Add a view file - views/admin/{menu}/{action}.html + +* Add action to setup/validActions.php + +* If needed add a database table to the create_database_V...sql file + and update name to current database version, add an + update_database_V....sql file, and/or update dbVersions.php + +* If required add a data definition for any new tables diff --git a/misc/documentation/CreateNewAddOn.txt b/misc/documentation/CreateNewAddOn.txt new file mode 100644 index 0000000..b180ed0 --- /dev/null +++ b/misc/documentation/CreateNewAddOn.txt @@ -0,0 +1,54 @@ +Procedure to create a new GLM Members add-on plugin +---------------------------------------------------- + +* Checkout glm-member-db-conditions and rename directory to glm-member-db-{add-on name} + +* Rename glm-member-db-conditions.php to glm-member-db-{addon name}.php + +* Review all files and change references to "conditions" (any case) to the new add-on name. + - Read the information in the "NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED" and + do anything recommended there. + - Remove all of the "NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED" blocks. + +* Create new repository named WP-Plugins/glm-member-db-{name of add-on}.git + +* If there are any databases associated with this add-on, setup the database scripts and + data under the "setup/databaseScripts" directory. If there are no database tables + with this add-on, remove all but the "readme.txt" file from that directory. + NOTE: No "update_database..." files should be there for a new add-on with new tables. + NOTE: There should be only one entry in the "dbVersions.php" file. + +* Carefully review "defines.php" file and update as needed. + +* Do a quick review of the readme.txt file and update as desired. + +* TEST - At this point the add-on should install and activate but not do anything. + - If there are any database tables, make sure they were created and are correct. + - Go to "Members" -> "Management" -> "Add-Ons" and make sure the add-on was + properly registered with the main plugin and that any database data is shown. + +* Adding menus + - Update "setup/adminMenus.php" and add menu section as described there. + - Add an entry in the validActions.php file. Pay attention to how slug name is + constructed ("glm-members-admin-{page}-{action}"). + - If needed add a database table to the create_database_V...sql file + Also add a "classes/data/data{Table}.php file + - Add a model file as "models/admin/{page}/{action}.php + - Add any desired view file as "views/admin/{page}/{action}.html + Note that additional possible view files should be named as... + "views/admin/{page}/{action}{Name}.html + - Test that when add-on is activated that the menu shows and is functional. + +* Adding tabs + - Update "setup/admin/Tabs.php" and add new tab filter as described there. + - Add an entry in the validActions.php file. Pay attention to how slug name is + constructed ("glm-members-admin-{page}-{action}"). + - If needed add a database table to the create_database_V...sql file + Also add a "classes/data/data{Table}.php file + - Add a model file as "models/admin/{page}/{action}.php + - Add any desired view file as "views/admin/{page}/{action}.html + Note that additional possible view files should be named as... + "views/admin/{page}/{action}{Name}.html + - Test that when add-on is activated that the tab shows and is functional. + + * \ No newline at end of file diff --git a/models/admin/info/index.php b/models/admin/info/index.php new file mode 100644 index 0000000..bed7037 --- /dev/null +++ b/models/admin/info/index.php @@ -0,0 +1,125 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release index.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +// Load Contacts data abstract +//require_once GLM_MEMBERS_CONTACTS_PLUGIN_CLASS_PATH.'/data/dataContacts.php'; + +class GlmMembersAdmin_info_index // extends GlmDataContacts +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + /** + * Contact Info + * + * @var $contactInfo + * @access public + */ + public $contactInfo = false; + /** + * Member ID + * + * @var $memberID + * @access public + */ + public $memberID = false; + /** + * Contact ID + * + * @var $contactID + * @access public + */ + public $contactID = false; + + + /* + * Constructor + * + * This contructor performs the work for this model. This model returns + * an array containing the following. + * + * 'status' + * + * True if successfull and false if there was a fatal failure. + * + * 'view' + * + * A suggested view name that the contoller should use instead of the + * default view for this model or false to indicate that the default view + * should be used. + * + * 'data' + * + * Data that the model is returning for use in merging with the view to + * produce output. + * + * @wpdb object WordPress database object + * + * @return array Array containing status, suggested view, and any data + */ + public function __construct ($wpdb, $config) + { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + /* + * Run constructor for the Contacts data class + * + * Note, the third parameter is a flag that indicates to the Contacts + * data class that it should flag a group of fields as 'view_only'. + */ +// parent::__construct(false, false, true); + + + } + + public function modelAction($actionData = false) + { + + $displayData = 'This is the Conditions Add-On "Info" model talking to you from inside WordPress.'; + + // Compile template data + $templateData = array( + 'displayData' => $displayData + ); + + // Return status, any suggested view, and any data to controller + return array( + 'status' => true, + 'modelRedirect' => false, + 'view' => 'admin/info/index.html', + 'data' => $templateData + ); + + } + + +} diff --git a/models/admin/members/sample.php b/models/admin/members/sample.php new file mode 100644 index 0000000..ab48059 --- /dev/null +++ b/models/admin/members/sample.php @@ -0,0 +1,103 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release index.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +// Load Conditions data abstract +require_once GLM_MEMBERS_CONDITIONS_PLUGIN_CLASS_PATH.'/data/dataConditions.php'; + +class GlmMembersAdmin_members_conditions extends GlmDataConditions +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + + /* + * Constructor + * + * This contructor performs the work for this model. This model returns + * an array containing the following. + * + * 'status' + * + * True if successfull and false if there was a fatal failure. + * + * 'view' + * + * A suggested view name that the contoller should use instead of the + * default view for this model or false to indicate that the default view + * should be used. + * + * 'data' + * + * Data that the model is returning for use in merging with the view to + * produce output. + * + * @wpdb object WordPress database object + * + * @return array Array containing status, suggested view, and any data + */ + public function __construct ($wpdb, $config) + { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + /* + * Run constructor for the Contacts data class + * + * Note, the third parameter is a flag that indicates to the Contacts + * data class that it should flag a group of fields as 'view_only'. + */ +// parent::__construct(false, false, true); + + + } + + public function modelAction($actionData = false) + { + + $displayData = 'This is the Conditions model talking to you from inside WordPress.'; + + // Compile template data + $templateData = array( + 'displayData' => $displayData + ); + + // Return status, any suggested view, and any data to controller + return array( + 'status' => true, + 'modelRedirect' => false, + 'view' => 'admin/members/conditions.html', + 'data' => $templateData + ); + + } + + +} diff --git a/models/admin/readme.txt b/models/admin/readme.txt new file mode 100644 index 0000000..e9a199d --- /dev/null +++ b/models/admin/readme.txt @@ -0,0 +1,5 @@ +The admin controller executes models under this directory. + +Typically you should add a directory here that matches the page where the action should take place. + +Under that directory place the model for the various actions. \ No newline at end of file diff --git a/models/admin/sample/index.php b/models/admin/sample/index.php new file mode 100644 index 0000000..dddc03e --- /dev/null +++ b/models/admin/sample/index.php @@ -0,0 +1,125 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release index.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +// Load Contacts data abstract +//require_once GLM_MEMBERS_CONTACTS_PLUGIN_CLASS_PATH.'/data/dataContacts.php'; + +class GlmMembersAdmin_conditions_index // extends GlmDataContacts +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + /** + * Contact Info + * + * @var $contactInfo + * @access public + */ + public $contactInfo = false; + /** + * Member ID + * + * @var $memberID + * @access public + */ + public $memberID = false; + /** + * Contact ID + * + * @var $contactID + * @access public + */ + public $contactID = false; + + + /* + * Constructor + * + * This contructor performs the work for this model. This model returns + * an array containing the following. + * + * 'status' + * + * True if successfull and false if there was a fatal failure. + * + * 'view' + * + * A suggested view name that the contoller should use instead of the + * default view for this model or false to indicate that the default view + * should be used. + * + * 'data' + * + * Data that the model is returning for use in merging with the view to + * produce output. + * + * @wpdb object WordPress database object + * + * @return array Array containing status, suggested view, and any data + */ + public function __construct ($wpdb, $config) + { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + /* + * Run constructor for the Contacts data class + * + * Note, the third parameter is a flag that indicates to the Contacts + * data class that it should flag a group of fields as 'view_only'. + */ +// parent::__construct(false, false, true); + + + } + + public function modelAction($actionData = false) + { + + $displayData = 'Hello, World! This is the Conditions Add-On "conditions" model talking to you from inside WordPress.'; + + // Compile template data + $templateData = array( + 'displayData' => $displayData + ); + + // Return status, any suggested view, and any data to controller + return array( + 'status' => true, + 'modelRedirect' => false, + 'view' => 'admin/conditions/index.html', + 'data' => $templateData + ); + + } + + +} diff --git a/models/admin/sample/more.php b/models/admin/sample/more.php new file mode 100644 index 0000000..40c5719 --- /dev/null +++ b/models/admin/sample/more.php @@ -0,0 +1,125 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release index.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +// Load Contacts data abstract +// require_once GLM_MEMBERS_CONTACTS_PLUGIN_CLASS_PATH.'/data/dataContacts.php'; + +class GlmMembersAdmin_conditions_more // extends GlmDataContacts +{ + + /** + * WordPress Database Object + * + * @var $wpdb + * @access public + */ + public $wpdb; + /** + * Plugin Configuration Data + * + * @var $config + * @access public + */ + public $config; + /** + * Contact Info + * + * @var $contactInfo + * @access public + */ + public $contactInfo = false; + /** + * Member ID + * + * @var $memberID + * @access public + */ + public $memberID = false; + /** + * Contact ID + * + * @var $contactID + * @access public + */ + public $contactID = false; + + + /* + * Constructor + * + * This contructor performs the work for this model. This model returns + * an array containing the following. + * + * 'status' + * + * True if successfull and false if there was a fatal failure. + * + * 'view' + * + * A suggested view name that the contoller should use instead of the + * default view for this model or false to indicate that the default view + * should be used. + * + * 'data' + * + * Data that the model is returning for use in merging with the view to + * produce output. + * + * @wpdb object WordPress database object + * + * @return array Array containing status, suggested view, and any data + */ + public function __construct ($wpdb, $config) + { + + // Save WordPress Database object + $this->wpdb = $wpdb; + + // Save plugin configuration object + $this->config = $config; + + /* + * Run constructor for the Contacts data class + * + * Note, the third parameter is a flag that indicates to the Contacts + * data class that it should flag a group of fields as 'view_only'. + */ +// parent::__construct(false, false, true); + + + } + + public function modelAction($actionData = false) + { + + $displayData = 'Welcome to more information!
This is the Conditions Add-On "conditions" model with action "more" talking to you from inside WordPress.'; + + // Compile template data + $templateData = array( + 'displayData' => $displayData + ); + + // Return status, any suggested view, and any data to controller + return array( + 'status' => true, + 'modelRedirect' => false, + 'view' => 'admin/conditions/more.html', + 'data' => $templateData + ); + + } + + +} diff --git a/models/front/readme.txt b/models/front/readme.txt new file mode 100644 index 0000000..4c54852 --- /dev/null +++ b/models/front/readme.txt @@ -0,0 +1,7 @@ +The front controller executes models under this directory. + +Typically you should add a directory here that matches the category of actions that will take place. + +Under that directory place the model for the various actions. + +Actions under this directory would normally be called due to processing of a shortcode. \ No newline at end of file diff --git a/readme.txt b/readme.txt new file mode 100644 index 0000000..ba934d4 --- /dev/null +++ b/readme.txt @@ -0,0 +1,27 @@ +=== Gaslight Media Member Database Conditions Child Plugin === +Contributors: cscott@gaslightmedia.com +Donate link: http://www.gaslightmedia.com +Tags: Gaslight Media,Plugin,Members Conditions +Requires at least: 3.0.1 +Tested up to: 3.4 +Stable tag: 4.3 +License: GPLv2 or later +License URI: http://www.gnu.org/licenses/gpl-2.0.html + +This is the Gaslight Media Members Database Conditions Child Plugin. + +== Description == + +The Gaslight Media Members Database Conditions Child Plugin is an add-on to the Gaslight Media Members Database, +which is required to install and run this plugin + +== Installation == + +This section describes how to install the plugin and get it working. + +e.g. + +1. Upload `plugin-name.php` to the `/wp-content/plugins/` directory +1. Activate the plugin through the 'Plugins' menu in WordPress + + diff --git a/setup/adminHooks.php b/setup/adminHooks.php new file mode 100644 index 0000000..2ab608a --- /dev/null +++ b/setup/adminHooks.php @@ -0,0 +1,39 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release adminHooks.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to create hooks into the main plugin or other + * add-ons. If no such hooks are needed, this file may be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Place Misc Hooks and Filters here. If this file exists, it will be included + * by the add-on main plugin script. + * + * Note that filter and hook callback functions must be included in-line as shown below... + * + * add_filter( 'filter_title', function( $parameter ) { + * // Function code + * }); + * + * Also note that parameters will be in the context of the main admin controller constructor. + */ diff --git a/setup/adminMenus.php b/setup/adminMenus.php new file mode 100644 index 0000000..b770c60 --- /dev/null +++ b/setup/adminMenus.php @@ -0,0 +1,100 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release admin.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to add main menus or sub-menus to the admin + * area. If this add-on does not create additional menus, this file + * should be omitted. + * + * If adding a main menu, use "add_menu_page()" WordPress function + * instead and note any differences. + * + * The menu slug should be constructed as + * "glm-members-admin-{page}-{action}" + * The default action for a page is usually "index". + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Added menus or sub-menus examples + * + * // Add a main menu item + * add_menu_page( + * 'GLM Conditions', // Page Title + * 'GLM Conditions', // Menu Title + * 'glm-members-members', // Capability + * 'glm-members-admin-menu-glm-conditions', // Menu Slug + * function() {$this->controller('conditions');}, // Called function - typically controller() with the menu name + * false, // Icon URL + * '92' // Menu Position + * ); + * + * // Add a sub-menu item + * add_submenu_page( + * 'glm-members-admin-menu-conditions', // Parent slug + * 'Conditions', // Page title + * 'Conditions', // Menu Title + * 'glm_members_edit', // Capability required + * 'glm-members-admin-menu-conditions', // Menu slug + * function() {$this->controller('conditions');} + * ); + * + * If creating a main menu item with add_menu_page(), please document + * that structure here. + * + * NOTE: The menu slug is the link for the page. It is also parsed by + * the controller and used to find the model to load. The + * "glm-members-admin-menu-" portion should not change, the last + * segment is the model directory name. By default the "index.php" file + * in that directory is executed. If the URL includes a "glm_action" + * parameter, then the model file called is in the same directory but + * is named the same as the "glm_action" parameter. + * + */ + +// Add a main menu item +add_menu_page( + 'GLM Conditions', // Page Title + 'GLM Conditions', // Menu Title + 'glm-members-members', // Capability + 'glm-members-admin-menu-conditions', // Menu Slug + function() {$this->controller('conditions');}, // Called function + false, // Icon URL + '92' // Menu Position +); + +add_submenu_page( + 'glm-members-admin-menu-conditions', // Parent slug + 'Conditions', // Page title + 'Conditions', // Menu Title + 'glm_members_members', // Capability required + 'glm-members-admin-menu-conditions-conditions', // Menu slug + function() {$this->controller('conditions');} +); + +add_submenu_page( + 'glm-members-admin-menu-conditions', // Parent slug + 'Info', // Page title + 'Info', // Menu Title + 'glm_members_members', // Capability required + 'glm-members-admin-menu-conditions-info', // Menu slug + function() {$this->controller('info');} +); diff --git a/setup/adminTabs.php b/setup/adminTabs.php new file mode 100644 index 0000000..70ae8fb --- /dev/null +++ b/setup/adminTabs.php @@ -0,0 +1,62 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release admin.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to add tabs to existing admin pages in the main + * plugin or other add-ons. If this add-on does not create additional + * tabs, this file should be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * To add a new tab to an existing Member DB page use a block + * like this and replace the {} parameters. + * + * add_filter('glm-member-db-add-tab-for-{menu name}', + * function($addOnTabs) { + * $newTabs = array( + * array( + * 'text' => '{text for display on tab}', + * 'menu' => '{menu name}', + * 'action' => '{action to perform}' + * ) + * ); + * $addOnTabs = array_merge($addOnTabs, $newTabs); + * return $addOnTabs; + * } + * ); + * + */ + +add_filter('glm-member-db-add-tab-for-members', + function($addOnTabs) { + $newTabs = array( + array( + 'text' => 'Conditions', + 'menu' => 'members', + 'action' => 'conditions' + ) + ); + $addOnTabs = array_merge($addOnTabs, $newTabs); + return $addOnTabs; + } +); + diff --git a/setup/databaseScripts/examples/create_database_V0.0.1.sql b/setup/databaseScripts/examples/create_database_V0.0.1.sql new file mode 100644 index 0000000..3705c64 --- /dev/null +++ b/setup/databaseScripts/examples/create_database_V0.0.1.sql @@ -0,0 +1,42 @@ +-- Gaslight Media Members Database - Conditions +-- File Created: 12/02/15 15:27:15 +-- Database Version: 0.0.1 +-- Database Creation Script +-- +-- This file is called to create a new set of tables for this +-- add-on for the most receint database version for this add-on. +-- +-- There should only be one such file in this directory +-- +-- To permit each query below to be executed separately, +-- all queries must be separated by a line with four dashes + + +-- ********************************************************************** +-- NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED +-- +-- Please change all references to conditions, Conditions, or CONDITIONS to a name +-- appropriate for your new Add-On. +-- +-- Tables and queries in this file are conditions only. +-- +-- Remove this message before using this file in production! +-- **********************************************************************/ + + +-- Conditions Table +CREATE TABLE {prefix}sometablename ( + id INT NOT NULL AUTO_INCREMENT, + somefield TINYTEXT NULL, + PRIMARY KEY (id) +); + +---- + +-- Conditions default entry in table +INSERT INTO {prefix}sometablename + ( id, somefield ) + VALUES + ( 1, 'conditions data' ) +; + diff --git a/setup/databaseScripts/examples/dbVersions.php b/setup/databaseScripts/examples/dbVersions.php new file mode 100644 index 0000000..8e17b5e --- /dev/null +++ b/setup/databaseScripts/examples/dbVersions.php @@ -0,0 +1,40 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release dbVersions.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file lists all versions of the database tables for this add-on. + * The last entry in the array below should be for the most recent + * version and should match the "create_database_V..." file in this + * directory. + * + * NOTE: When first creating a new add-on with database tables, there + * should only be one line in the array below and there should be no + * "update_database..." files in this directory. + * + * Remove this message before using this file in production! + **********************************************************************/ + + +$glmMembersConditionsDbVersions = array( + '0.0.1' => array('version' => '0.0.1', 'tables' => 1, 'date' => '1/1/2016'), + '0.0.2' => array('version' => '0.0.2', 'tables' => 2) +); + diff --git a/setup/databaseScripts/examples/drop_database_V0.0.1.sql b/setup/databaseScripts/examples/drop_database_V0.0.1.sql new file mode 100644 index 0000000..f04ce11 --- /dev/null +++ b/setup/databaseScripts/examples/drop_database_V0.0.1.sql @@ -0,0 +1,12 @@ +-- Gaslight Media Members Database +-- File Created: 12/09/14 15:27:15 +-- Database Version: 1.1.5 +-- Database Deletion Script +-- Note: Tables with DELETE CASCADE must appear before referenced table +-- +-- Multiple tables may be separated by ",". + +DROP TABLE IF EXISTS + {prefix}sometablename +; + diff --git a/setup/databaseScripts/examples/readme.txt b/setup/databaseScripts/examples/readme.txt new file mode 100644 index 0000000..eeecde4 --- /dev/null +++ b/setup/databaseScripts/examples/readme.txt @@ -0,0 +1,25 @@ +DATABASE EXAMPLE FILES +---------------------- + +*** THESE ARE EXAMPLES ONLY *** + +The files in this directory are examples only. Do not use any of these as they are! + +The example here is of a set of one table for the add-on that is initially created +by the create_database_V0.0.1.sql script. That file creates one table and inserts +one entry into that table. + +In this example, the database is later updated by two files. Either of these may +be included separately if only a PHP file is needed to update the database, or +just an SQL script. Sometimes both are needed. + +There is also an entry in the dbVersions.php file that describes the update. + +Note that the number of tables needs to be set to the updated number for each update. + +Also note that the SQL update scripts are run before the PHP update scripts. + +NOTE: When doing a database version update be sure to update the version numbers +on the "create_database_V..." and "drop_database_V..." files. Also the drop_database +file must reference all off the tables in the create_database file. + diff --git a/setup/databaseScripts/examples/update_database_V0.0.2.php b/setup/databaseScripts/examples/update_database_V0.0.2.php new file mode 100644 index 0000000..b7d80cb --- /dev/null +++ b/setup/databaseScripts/examples/update_database_V0.0.2.php @@ -0,0 +1,54 @@ +wpdb->get_results('SELECT id, title FROM '.GLM_MEMBERS_CONDITIONS_PLUGIN_DB_PREFIX.'sometablename;', ARRAY_A); + +// If there's any records +if ($conditionsRecords && count($conditionsRecords) > 0) { + + // For each record + foreach ($conditionsRecords as $p) { + + // Create a slug from the somefield field + $newData = sanitize_title($p['somefield']).'-'.$p['id']; + + // Store this value back into the record in the new yetanotherfield field + $this->wpdb->update( + GLM_MEMBERS_CONDITIONS_PLUGIN_DB_PREFIX.'sometablename', + array( + 'yetanotherfield' => $slug + ), + array( 'id' => $p['id'] ), + array( '%s' ), + array( '%d') + ); + } + +} diff --git a/setup/databaseScripts/examples/update_database_V0.0.2.sql b/setup/databaseScripts/examples/update_database_V0.0.2.sql new file mode 100644 index 0000000..68022c1 --- /dev/null +++ b/setup/databaseScripts/examples/update_database_V0.0.2.sql @@ -0,0 +1,21 @@ +-- Gaslight Media Members Database +-- File Created: 12/09/14 15:27:15 +-- Database Version: 0.0.2 +-- Database Update From Previous Version Script +-- +-- To permit each query below to be executed separately, +-- all queries must be separated by a line with four dashses + +-- A conditions database update script +CREATE TABLE {prefix}anothertablename ( + id INT NOT NULL AUTO_INCREMENT, + anotherfield TINYTEXT NULL, + PRIMARY KEY (id) +); + +---- + +ALTER TABLE {prefix}sometablename ADD COLUMN yetanotherfield TINYTEXT; + + + diff --git a/setup/databaseScripts/readme.txt b/setup/databaseScripts/readme.txt new file mode 100644 index 0000000..73d03b2 --- /dev/null +++ b/setup/databaseScripts/readme.txt @@ -0,0 +1,10 @@ +This directory contains database creation and update scripts for this add-on. + +The files in this directory are checked by the checkDatabase() function in the +main plugin classes/glmPluginSupport.php file. + +This directory is optional. If there are no data tables that need to be created +for this add-on, there should be no files in this directory. The directory may +also be deleted. + +See the "examples" directory for a conditions of what can go in this directory. diff --git a/setup/frontHooks.php b/setup/frontHooks.php new file mode 100644 index 0000000..5f30428 --- /dev/null +++ b/setup/frontHooks.php @@ -0,0 +1,39 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release frontHooks.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to create hooks into the main plugin or other + * add-ons. If no such hooks are needed, this file may be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Place Misc Hooks and Filters here. If this file exists, it will be included + * by the add-on main plugin script. + * + * Note that filter and hook callback functions must be included in-line as shown below... + * + * add_filter( 'filter_title', function( $parameter ) { + * // Function code + * }); + * + * *** Also note that parameters will be in the context of the main front controller constructor. *** + */ diff --git a/setup/hooksHelp.html b/setup/hooksHelp.html new file mode 100644 index 0000000..d1f4af8 --- /dev/null +++ b/setup/hooksHelp.html @@ -0,0 +1,70 @@ + + + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to document hooks provided by this add-on. Content + * here will be displayed in the "Management" page "Hooks" tab. If + * there is no content for this page, this file should be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + + +

Conditions Add-On

+ + User Permission Hooks + + + glm_members_permit_admin_members_conditions_tab + Filter + + + Returns boolean answer to "Is current user permitted to see multi-member Conditions tab?" + + + + glm_members_permit_admin_members_Conditions_add_conditions + Filter + + + Returns boolean answer to "Is current user permitted to add a new multi-member conditions?" + + + + glm_members_permit_admin_members_Conditions_edit_conditions + Filter + + + Returns boolean answer to "Is current user permitted to edit a multi-member conditions?" + + + + glm_members_permit_admin_member_conditions_tab + Filter + + + Returns boolean answer to "Is current user permitted to see the member Conditions tab?" + + + + glm_members_permit_admin_member_Conditions_add_conditions + Filter + + + Returns boolean answer to "Is current user permitted to add a new Member conditions?" + + + + glm_members_permit_admin_member_Conditions_edit_conditions + Filter + + + Returns boolean answer to "Is current user permitted to edit a member conditions?" + + + diff --git a/setup/permissions.php b/setup/permissions.php new file mode 100644 index 0000000..461451a --- /dev/null +++ b/setup/permissions.php @@ -0,0 +1,56 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release permissions.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to add permission checks that can be used throught + * the main plugin and add-ons. If no such permissions are needed by + * this add-on, this file should be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Below are permission checks for various specific things in this add-on and + * elsewhere in the Member DB main plugin and add-ons. + * + * Each location where a permission might be required has an apply_filters() + * hook with a tag name that includes the plugin or add-on name, the menu, + * the action, and a name for the specific thing that needs permissions. + * + * This can be included in code or in a Smarty template used in these plugins. + * For example, to check permissions for the main Members menu and it's "index" + * action to see if a member search is permitted, the template includes the + * following code... + * + * {if $membersList && apply_filters('glm_members_permit_admin_members_index_member_search', true)} + * --- some template output --- + * {/if} + * + * In the case above, it's also checking to see if the members list even exists + * before checking the permissions. The default value of "true" in the hook ensures + * that the permission is granted if nothing has linked into the hook to say otherwise. + * + * Note that each add_filter() below first checks if the permission has already + * been retracted by prior hook. This requires all that are attached to the hook + * to permit the action. + * + * Of course any of these may test more than one capability if that's desired. + */ diff --git a/setup/rolesAndCapabilities.php b/setup/rolesAndCapabilities.php new file mode 100644 index 0000000..5285546 --- /dev/null +++ b/setup/rolesAndCapabilities.php @@ -0,0 +1,31 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release rolesAndPermissions.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to add roles and capability. If none are required, + * this file should be omitted. + * + * Remove this message before using this file in production! + **********************************************************************/ + +/** + * NOTE: This file is only included in the activate.php process. + * It is not regularly used during operation. + */ diff --git a/setup/shortcodes.php b/setup/shortcodes.php new file mode 100644 index 0000000..f1bfb89 --- /dev/null +++ b/setup/shortcodes.php @@ -0,0 +1,107 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release shortcodes.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to define shortcodes that will be handled by this + * add-0n. + * + * DO NOT DELETE THIS FILE EVEN IF THERE ARE NOT SHORTCODES + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Array of short-code + * + * This array lists all of the short-codes available from the main + * member plugin and all add-ons that provide short-code features. + * + * This array is merged with the data from any registered add-ons + * providing short-code features. The plugin providing the short-code + * is designated in the 'plugin' elemeent. + * + * A shortcode is unique to a particular plugin. To provide additional + * data and features to a short-code, an add-on should use filters + * provided by the short-code to insert data into the template array, + * to insert additional format into the template, or to insert + * text directly into the completed template output. + * + * The "attributes" array is a list of available attributes for this + * shortcode and their default values. If a database table is provided, + * then the value for each attribute is a table column where we get + * the default value. If no table is provided, then the value for + * each attribute is the actual default value for that attribute. + * In the case that the data is taken from the database table, the + * "id" for the table entry where the data is stored is assumed to + * be 1. + * + * Note that if the value for a particular attribute is false, then + * it is not read from the database even if the table is specified + * but might be supplied at run-time as an attribute in the short-code. + * All attributes that might be specified in the shortcode must be + * listed in the 'attributes' array below. If an attribute is not + * specified here, it can't be read from the short-code. + * + * The following is an explanation of this array. + * + * array( + * '{shortcode-slug} => array( + * 'plugin' => '{plugin (add-on) slug}', // Identifies which plugin is providing the short-code + * 'menu' => '{menu name}', // Menu name in this context is simply where to find the action + * 'action' => '{shortcode action name}, // Action used to execute this shortcode + * 'table' => '{table prefix}{table name}', // Database table where default attribute values are stored + * 'attributes' => array( // An array of all shortcode attributes (options) + * '{attr name}' => '{field name}', // Available attribute names and the database field names with the default value + * .... + * ), + * ... additional short-codes + * ) + * + * Shortcode descriptions conditions + * + * + * [glm-members-conditions-shortcode] + *   + * + * Displays something related to this add-on. + * + * + * + *   + * type="{types}" + * + * The "type" attribute is used to select the type of data to be displayed. + * Below is a list of available list types. + *

+ * + * + * + * + *
List Types
oneType One
twoType Two
+ *

+ * + * + */ + +$glmMembersConditionsShortcodes = array( +); + +$glmMembersConditionsShortcodesDescription = ''; + diff --git a/setup/validActions.php b/setup/validActions.php new file mode 100644 index 0000000..ce31a3d --- /dev/null +++ b/setup/validActions.php @@ -0,0 +1,70 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release admin.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * This file is used to define valid actions for both admin and + * front-end pages. + * + * DO NOT DELETE THIS FILE EVEN IF THERE ARE NO ACTIONS + * + * Remove this message before using this file in production! + **********************************************************************/ + +/* + * Array of valid menu items and actions. + * + * The higher level elements are valid menu items. These correlate to + * actual menu or sub menu items that are hooks back to this controller + * class. + * + * The lower level items below each menu item are actions that may be specified + * by a "glmMembersAction" form field. + * + * The string after the action is the slug of the plugin where the model/view + * is to perform that action. + * + * This array is integrated into the valid actions array in the main GLM Member + * DB plugin when this plugin registers itself. + */ + +$glmMembersConditionsAddOnValidActions = array( + 'adminActions' => array( + 'members' => array( + 'conditions' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, + ), + 'conditions' => array( + 'index' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, + 'more' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, + ), + 'info' => array( + 'index' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG + ) + ), + 'frontActions' => array( +/* + 'conditions' => array( + 'list' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG, + 'detail' => GLM_MEMBERS_CONDITIONS_PLUGIN_SLUG + ) +*/ + ) +); + +?> \ No newline at end of file diff --git a/uninstall.php b/uninstall.php new file mode 100644 index 0000000..d081ed6 --- /dev/null +++ b/uninstall.php @@ -0,0 +1,36 @@ + + * @license http://www.gaslightmedia.com Gaslightmedia + * @release admin.php,v 1.0 2014/10/31 19:31:47 cscott Exp $ + * @link http://dev.gaslightmedia.com/ + */ + +/********************************************************************** + * NOTE: THIS IS A CONDITIONS FILE - DO NOT USE UNMODIFIED + * + * Please change all references to conditions, Conditions, or CONDITIONS to a name + * appropriate for your new Add-On. + * + * Remove this message before using this file in production! + **********************************************************************/ + +// Check that we're being called by WordPress. +if (!defined('ABSPATH')) { + die("Please do not call this code directly!"); +} + +//if uninstall not called from WordPress exit +if (!defined('WP_UNINSTALL_PLUGIN')) { + die("Sorry, uninstall must be called by WordPress!"); +} diff --git a/views/admin/info/index.html b/views/admin/info/index.html new file mode 100644 index 0000000..eab9b97 --- /dev/null +++ b/views/admin/info/index.html @@ -0,0 +1,6 @@ +
+
+

Info Sub-menu Model

+

{$displayData}

+
+
\ No newline at end of file diff --git a/views/admin/members/sample.html b/views/admin/members/sample.html new file mode 100644 index 0000000..c959204 --- /dev/null +++ b/views/admin/members/sample.html @@ -0,0 +1,6 @@ +{include file='admin/members/header.html'} + +

{$terms.term_member_plur_cap} Conditions Tab

+

{$displayData}

+ +{include file='admin/footer.html'} \ No newline at end of file diff --git a/views/admin/readme.txt b/views/admin/readme.txt new file mode 100644 index 0000000..5a9d7ea --- /dev/null +++ b/views/admin/readme.txt @@ -0,0 +1,5 @@ +The admin controller uses views (templates) under this directory to generate final output. + +Typically you should add a directory here that matches the page where the view is used. + +Under that directory place the view (template) for the various actions. \ No newline at end of file diff --git a/views/admin/sample/index.html b/views/admin/sample/index.html new file mode 100644 index 0000000..f1b78d1 --- /dev/null +++ b/views/admin/sample/index.html @@ -0,0 +1,7 @@ +
+
+

Conditions Model

+

{$displayData}

+ Click me to see more! +
+
\ No newline at end of file diff --git a/views/admin/sample/more.html b/views/admin/sample/more.html new file mode 100644 index 0000000..c768b5d --- /dev/null +++ b/views/admin/sample/more.html @@ -0,0 +1,6 @@ +
+
+

Conditions Model - More Information

+

{$displayData}

+
+
\ No newline at end of file diff --git a/views/front/readme.txt b/views/front/readme.txt new file mode 100644 index 0000000..1138d90 --- /dev/null +++ b/views/front/readme.txt @@ -0,0 +1,7 @@ +The front controller uses views (templates) under this directory to generate final output. + +Typically you should add a directory here that matches the category of actions that will use these views. + +Under that directory place the view (template) for the various actions. + +Views under this directory would normally be called due to processing of a shortcode. \ No newline at end of file -- 2.17.1