mirror of
https://github.com/inretio/WordPress-Plugin-Boilerplate
synced 2024-12-23 04:13:53 +02:00
initializing instance to null, initializing the plugin_screen_slug to null, updating coding conventions, improving comments, updating conditionals,
This commit is contained in:
parent
0b2021b273
commit
b4992eaf65
1 changed files with 63 additions and 51 deletions
|
@ -34,7 +34,10 @@ class PluginName {
|
||||||
*--------------------------------------------*/
|
*--------------------------------------------*/
|
||||||
|
|
||||||
/** Refers to a single instance of this class. */
|
/** Refers to a single instance of this class. */
|
||||||
private static $instance;
|
private static $instance = null;
|
||||||
|
|
||||||
|
/** Refers to the slug of the plugin screen. */
|
||||||
|
private $plugin_screen_slug = null;
|
||||||
|
|
||||||
/*--------------------------------------------*
|
/*--------------------------------------------*
|
||||||
* Constructor
|
* Constructor
|
||||||
|
@ -57,18 +60,23 @@ class PluginName {
|
||||||
// Load plugin text domain
|
// Load plugin text domain
|
||||||
add_action( 'init', array( $this, 'plugin_textdomain' ) );
|
add_action( 'init', array( $this, 'plugin_textdomain' ) );
|
||||||
|
|
||||||
// Add the options page and menu item
|
/*
|
||||||
// Uncomment the following line to enable the Settings Page for the plugin
|
* Add the options page and menu item.
|
||||||
# add_action('admin_menu', array( $this, 'plugin_admin_menu' ) );
|
* Uncomment the following line to enable the Settings Page for the plugin:
|
||||||
|
*/
|
||||||
|
add_action( 'admin_menu', array( $this, 'plugin_admin_menu' ) );
|
||||||
|
|
||||||
// Register admin styles and scripts
|
/*
|
||||||
// If the Settings page has been activated (above), the scripts and styles
|
* Register admin styles and scripts
|
||||||
// will only be loaded on the settings page. If not, they will be loaded for all
|
* If the Settings page has been activated using the above hook, the scripts and styles
|
||||||
// admin pages.
|
* will only be loaded on the settings page. If not, they will be loaded for all
|
||||||
add_action( 'admin_enqueue_scripts', array( $this, 'register_admin_styles' ) );
|
* admin pages.
|
||||||
add_action( 'admin_enqueue_scripts', array( $this, 'register_admin_scripts' ) );
|
*
|
||||||
|
* add_action( 'admin_enqueue_scripts', array( $this, 'register_admin_styles' ) );
|
||||||
|
* add_action( 'admin_enqueue_scripts', array( $this, 'register_admin_scripts' ) );
|
||||||
|
*/
|
||||||
|
|
||||||
// Register site styles and scripts
|
// Register site stylesheets and JavaScript
|
||||||
add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_styles' ) );
|
add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_styles' ) );
|
||||||
add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_scripts' ) );
|
add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_scripts' ) );
|
||||||
|
|
||||||
|
@ -78,6 +86,7 @@ class PluginName {
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* TODO:
|
* TODO:
|
||||||
|
*
|
||||||
* Define the custom functionality for your plugin. The first parameter of the
|
* Define the custom functionality for your plugin. The first parameter of the
|
||||||
* add_action/add_filter calls are the hooks into which your code should fire.
|
* add_action/add_filter calls are the hooks into which your code should fire.
|
||||||
*
|
*
|
||||||
|
@ -118,6 +127,7 @@ class PluginName {
|
||||||
// TODO: replace "plugin-name-locale" with a unique value for your plugin
|
// TODO: replace "plugin-name-locale" with a unique value for your plugin
|
||||||
$domain = 'plugin-name-locale';
|
$domain = 'plugin-name-locale';
|
||||||
$locale = apply_filters( 'plugin_locale', get_locale(), $domain );
|
$locale = apply_filters( 'plugin_locale', get_locale(), $domain );
|
||||||
|
|
||||||
load_textdomain( $domain, WP_LANG_DIR . '/' . $domain . '/' . $domain . '-' . $locale . '.mo' );
|
load_textdomain( $domain, WP_LANG_DIR . '/' . $domain . '/' . $domain . '-' . $locale . '.mo' );
|
||||||
load_plugin_textdomain( $domain, FALSE, dirname( plugin_basename( __FILE__ ) ) . '/lang/' );
|
load_plugin_textdomain( $domain, FALSE, dirname( plugin_basename( __FILE__ ) ) . '/lang/' );
|
||||||
|
|
||||||
|
@ -137,20 +147,18 @@ class PluginName {
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Check if current screen is the admin page for this plugin
|
* Check if current screen is the admin page for this plugin
|
||||||
* Don't enqueue script/style if it's not
|
* Don't enqueue stylesheet or JavaScript if it's not
|
||||||
*/
|
*/
|
||||||
|
|
||||||
$screen = get_current_screen();
|
$screen = get_current_screen();
|
||||||
if ( $screen->id != $this->plugin_screen_slug )
|
if ( $screen->id == $this->plugin_screen_slug ) {
|
||||||
return;
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
wp_enqueue_style( 'plugin-name-admin-styles', plugins_url( 'css/admin.css', __FILE__ ) );
|
wp_enqueue_style( 'plugin-name-admin-styles', plugins_url( 'css/admin.css', __FILE__ ) );
|
||||||
|
} // end if
|
||||||
|
|
||||||
|
} // end if
|
||||||
|
|
||||||
} // end register_admin_styles
|
} // end register_admin_styles
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Registers and enqueues admin-specific JavaScript.
|
* Registers and enqueues admin-specific JavaScript.
|
||||||
*/
|
*/
|
||||||
|
@ -165,16 +173,15 @@ class PluginName {
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Check if current screen is the admin page for this plugin
|
* Check if current screen is the admin page for this plugin
|
||||||
* Don't enqueue script/style if it's not
|
* Don't enqueue stylesheet or JavaScript if it's not
|
||||||
*/
|
*/
|
||||||
|
|
||||||
$screen = get_current_screen();
|
$screen = get_current_screen();
|
||||||
if ( $screen->id != $this->plugin_screen_slug )
|
if ( $screen->id == $this->plugin_screen_slug ) {
|
||||||
return;
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
wp_enqueue_script( 'plugin-name-admin-script', plugins_url( 'js/admin.js', __FILE__ ), array( 'jquery' ) );
|
wp_enqueue_script( 'plugin-name-admin-script', plugins_url( 'js/admin.js', __FILE__ ), array( 'jquery' ) );
|
||||||
|
} // end if
|
||||||
|
|
||||||
|
} // end if
|
||||||
|
|
||||||
} // end register_admin_scripts
|
} // end register_admin_scripts
|
||||||
|
|
||||||
|
@ -182,46 +189,51 @@ class PluginName {
|
||||||
* Registers and enqueues plugin-specific styles.
|
* Registers and enqueues plugin-specific styles.
|
||||||
*/
|
*/
|
||||||
public function register_plugin_styles() {
|
public function register_plugin_styles() {
|
||||||
|
|
||||||
wp_enqueue_style( 'plugin-name-plugin-styles', plugins_url( 'css/display.css', __FILE__ ) );
|
wp_enqueue_style( 'plugin-name-plugin-styles', plugins_url( 'css/display.css', __FILE__ ) );
|
||||||
|
|
||||||
} // end register_plugin_styles
|
} // end register_plugin_styles
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Registers and enqueues plugin-specific scripts.
|
* Registers and enqueues plugin-specific scripts.
|
||||||
*/
|
*/
|
||||||
public function register_plugin_scripts() {
|
public function register_plugin_scripts() {
|
||||||
|
|
||||||
wp_enqueue_script( 'plugin-name-plugin-script', plugins_url( 'js/display.js', __FILE__ ), array( 'jquery' ) );
|
wp_enqueue_script( 'plugin-name-plugin-script', plugins_url( 'js/display.js', __FILE__ ), array( 'jquery' ) );
|
||||||
|
|
||||||
} // end register_plugin_scripts
|
} // end register_plugin_scripts
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Registers the administration menu for this plugin into the WordPress Dashboard menu.
|
||||||
|
*/
|
||||||
public function plugin_admin_menu() {
|
public function plugin_admin_menu() {
|
||||||
// TODO: Change 'Page Title' to the title of your plugin admin page
|
|
||||||
// TODO: Change 'Menu Text' to the text for menu item for the plugin settings page
|
/*
|
||||||
// TODO: Change 'plugin-name' to the name of your plugin
|
* TODO:
|
||||||
$this->plugin_screen_slug = add_plugins_page('Page Title', 'Menu Text', 'read', 'plugin-name', array( $this, 'plugin_admin_page' ));
|
*
|
||||||
|
* Change 'Page Title' to the title of your plugin admin page
|
||||||
|
* Change 'Menu Text' to the text for menu item for the plugin settings page
|
||||||
|
* Change 'plugin-name' to the name of your plugin
|
||||||
|
*/
|
||||||
|
|
||||||
|
$this->plugin_screen_slug = add_plugins_page(
|
||||||
|
__( 'Page Title', 'plugin-name-locale' ),
|
||||||
|
__( 'Menu Text', 'plugin-name-locale' ),
|
||||||
|
__( 'read', 'plugin-name-locale' ),
|
||||||
|
__( 'plugin-name', 'plugin-name-locale' ),
|
||||||
|
array( $this, 'plugin_admin_page' )
|
||||||
|
);
|
||||||
|
|
||||||
} // end plugin_admin_menu
|
} // end plugin_admin_menu
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Renders the options page for this plugin.
|
||||||
|
*/
|
||||||
public function plugin_admin_page() {
|
public function plugin_admin_page() {
|
||||||
|
include_once( 'views/admin.php' );
|
||||||
// output the cpanel
|
|
||||||
include_once('views/admin_open.php');
|
|
||||||
include_once('views/admin.php'); // outputs the settings/form markup for the plugin admin markup
|
|
||||||
include_once('views/admin_close.php');
|
|
||||||
|
|
||||||
} // end plugin_admin_page
|
} // end plugin_admin_page
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/*--------------------------------------------*
|
/*--------------------------------------------*
|
||||||
* Core Functions
|
* Core Functions
|
||||||
*---------------------------------------------*/
|
*---------------------------------------------*/
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* NOTE: Actions are points in the execution of a page or process
|
* NOTE: Actions are points in the execution of a page or process
|
||||||
* lifecycle that WordPress fires.
|
* lifecycle that WordPress fires.
|
||||||
*
|
*
|
||||||
|
@ -233,7 +245,7 @@ class PluginName {
|
||||||
// TODO: Define your action method here
|
// TODO: Define your action method here
|
||||||
} // end action_method_name
|
} // end action_method_name
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* NOTE: Filters are points of execution in which WordPress modifies data
|
* NOTE: Filters are points of execution in which WordPress modifies data
|
||||||
* before saving it or sending it to the browser.
|
* before saving it or sending it to the browser.
|
||||||
*
|
*
|
||||||
|
|
Loading…
Reference in a new issue