1
0
Fork 0
mirror of https://github.com/inretio/WordPress-Plugin-Boilerplate synced 2024-12-22 20:03:53 +02:00
WordPress-Plugin-Boilerplate/plugin-name/class-plugin-name.php

256 lines
6.6 KiB
PHP
Raw Normal View History

<?php
/**
2013-05-13 18:00:55 +03:00
* Plugin Name.
*
2013-05-13 18:00:55 +03:00
* @package PluginName
* @author Your Name <email@example.com>
* @copyright 2013 Your Name or Company Name
* @license GPL-2.0+
* @link http://example.com/plugin-name
*/
/**
* Plugin class.
*
2013-05-13 18:00:55 +03:00
* TODO: Rename this class to a proper name for your plugin.
*
* @package PluginName
* @author Your Name <email@example.com>
*/
class PluginName {
/**
2013-05-13 18:00:55 +03:00
* Plugin version, used for cache-busting of style and script file references.
*
* @since 1.0.0
*
* @var string
*/
protected $version = '1.0.0';
/**
2013-05-13 18:00:55 +03:00
* Unique identifier for your plugin.
*
* Use this value (not the variable name) as the text domain when internationalizing strings of text. It should
* match the Text Domain file header in the main plugin file.
*
* @since 1.0.0
*
* @var string
*/
protected $plugin_slug = 'plugin-name';
/**
2013-05-13 18:00:55 +03:00
* Instance of this class.
*
* @since 1.0.0
*
* @var object
*/
protected static $instance = null;
2013-05-13 18:00:55 +03:00
/**
* Slug of the plugin screen.
*
* @since 1.0.0
*
* @var string
*/
protected $plugin_screen_hook_suffix = null;
/**
2013-05-13 18:00:55 +03:00
* Initialize the plugin by setting localization, filters, and administration functions.
*
* @since 1.0.0
*/
private function __construct() {
// Load plugin text domain
add_action( 'init', array( $this, 'load_plugin_textdomain' ) );
2013-05-13 18:00:55 +03:00
// Add the options page and menu item.
// add_action( 'admin_menu', array( $this, 'add_plugin_admin_menu' ) );
// Load admin stylesheets and JavaScript.
2013-05-13 18:00:55 +03:00
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_styles' ) );
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_scripts' ) );
// Load public-facing stylesheets and JavaScript.
2013-05-13 18:00:55 +03:00
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_styles' ) );
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
// Define custom functionality. Read more about actions and filters: http://codex.wordpress.org/Plugin_API#Hooks.2C_Actions_and_Filters
add_action( 'TODO', array( $this, 'action_method_name' ) );
2013-05-13 15:45:22 +03:00
add_filter( 'TODO', array( $this, 'filter_method_name' ) );
2013-05-13 18:00:55 +03:00
}
2013-05-13 18:00:55 +03:00
/**
* Return an instance of this class.
*
* @since 1.0.0
*
* @return object A single instance of this class.
*/
public static function get_instance() {
// If the single instance hasn't been set, set it now.
if ( null == self::$instance ) {
self::$instance = new self;
}
return self::$instance;
}
/**
* Fired when the plugin is activated.
*
2013-05-13 18:00:55 +03:00
* @since 1.0.0
*
* @param boolean $network_wide True if WPMU superadmin uses "Network Activate" action, false if WPMU is disabled or plugin is activated on an individual blog.
*/
2013-05-13 18:00:55 +03:00
public static function activate( $network_wide ) {
// TODO: Define activation functionality here
}
/**
* Fired when the plugin is deactivated.
*
* @since 1.0.0
2013-05-13 18:00:55 +03:00
*
* @param boolean $network_wide True if WPMU superadmin uses "Network Deactivate" action, false if WPMU is disabled or plugin is deactivated on an individual blog.
*/
2013-05-13 18:00:55 +03:00
public static function deactivate( $network_wide ) {
// TODO: Define deactivation functionality here
}
/**
2013-05-13 18:00:55 +03:00
* Load the plugin text domain for translation.
*
* @since 1.0.0
*/
public function load_plugin_textdomain() {
2013-05-13 18:00:55 +03:00
$domain = $this->plugin_slug;
$locale = apply_filters( 'plugin_locale', get_locale(), $domain );
load_textdomain( $domain, WP_LANG_DIR . '/' . $domain . '/' . $domain . '-' . $locale . '.mo' );
load_plugin_textdomain( $domain, FALSE, dirname( plugin_basename( __FILE__ ) ) . '/lang/' );
}
/**
* Register and enqueue admin-specific stylesheets.
*
2013-05-13 18:00:55 +03:00
* @since 1.0.0
*
* @return null Return early if no settings page is registered.
*/
2013-05-13 18:00:55 +03:00
public function enqueue_admin_styles() {
2013-05-13 18:00:55 +03:00
if ( ! isset( $this->plugin_screen_hook_suffix ) ) {
return;
}
2013-05-13 18:00:55 +03:00
$screen = get_current_screen();
if ( $screen->id == $this->plugin_screen_hook_suffix ) {
wp_enqueue_style( $this->plugin_slug .'-admin-styles', plugins_url( 'css/admin.css', __FILE__ ), $this->version );
}
}
/**
* Register and enqueue admin-specific JavaScript.
*
2013-05-13 18:00:55 +03:00
* @since 1.0.0
*
* @return null Return early if no settings page is registered.
*/
2013-05-13 18:00:55 +03:00
public function enqueue_admin_scripts() {
2013-05-13 18:00:55 +03:00
if ( ! isset( $this->plugin_screen_hook_suffix ) ) {
return;
}
2013-05-13 18:00:55 +03:00
$screen = get_current_screen();
if ( $screen->id == $this->plugin_screen_hook_suffix ) {
wp_enqueue_script( $this->plugin_slug . '-admin-script', plugins_url( 'js/admin.js', __FILE__ ), array( 'jquery' ), $this->version );
}
}
/**
* Register and enqueue public-facing stylesheets.
*
* @since 1.0.0
*/
2013-05-13 18:00:55 +03:00
public function enqueue_styles() {
wp_enqueue_style( $this->plugin_slug . '-plugin-styles', plugins_url( 'css/public.css', __FILE__ ), $this->version );
}
/**
* Register and enqueues public-facing JavaScript files.
*
* @since 1.0.0
*/
2013-05-13 18:00:55 +03:00
public function enqueue_scripts() {
wp_enqueue_script( $this->plugin_slug . '-plugin-script', plugins_url( 'js/public.js', __FILE__ ), array( 'jquery' ), $this->version );
}
/**
2013-05-13 18:00:55 +03:00
* Register the administration menu for this plugin into the WordPress Dashboard menu.
*
* @since 1.0.0
*/
public function add_plugin_admin_menu() {
/*
* TODO:
*
* 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
*/
2013-05-13 18:00:55 +03:00
$this->plugin_screen_hook_suffix = add_plugins_page(
__('Page Title', 'plugin-name'),
__('Menu Text', 'plugin-name'),
'read',
2013-05-13 18:00:55 +03:00
$this->plugin_slug,
array( $this, 'display_plugin_admin_page' )
);
}
/**
2013-05-13 18:00:55 +03:00
* Render the settings page for this plugin.
*
* @since 1.0.0
*/
public function display_plugin_admin_page() {
2013-05-13 18:00:55 +03:00
include_once( 'views/admin.php' );
}
2013-05-13 18:00:55 +03:00
/**
* NOTE: Actions are points in the execution of a page or process
* lifecycle that WordPress fires.
*
* WordPress Actions: http://codex.wordpress.org/Plugin_API#Actions
* Action Reference: http://codex.wordpress.org/Plugin_API/Action_Reference
*
* @since 1.0.0
*/
public function action_method_name() {
2013-05-13 18:00:55 +03:00
// TODO: Define your action hook callback here
}
2013-05-13 18:00:55 +03:00
/**
* NOTE: Filters are points of execution in which WordPress modifies data
* before saving it or sending it to the browser.
*
* WordPress Filters: http://codex.wordpress.org/Plugin_API#Filters
* Filter Reference: http://codex.wordpress.org/Plugin_API/Filter_Reference
*
2013-05-13 18:00:55 +03:00
* @since 1.0.0
*/
public function filter_method_name() {
2013-05-13 18:00:55 +03:00
// TODO: Define your filter hook callback here
}
}