* @copyright Copyright (c) 2009 - 2018, Justin Tadlock * @link https://themehybrid.com/plugins/members * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html */ namespace Members\Admin; /** * Sets up and handles the plugin settings screen. * * @since 1.0.0 * @access public */ final class Settings_Page { /** * Admin page name/ID. * * @since 2.0.0 * @access public * @var string */ public $name = 'members-settings'; /** * Settings page name. * * @since 1.0.0 * @access public * @var string */ public $settings_page = ''; /** * Holds an array the settings page views. * * @since 2.0.0 * @access public * @var array */ public $views = array(); /** * Returns the instance. * * @since 1.0.0 * @access public * @return object */ public static function get_instance() { static $instance = null; if ( is_null( $instance ) ) { $instance = new self; $instance->includes(); $instance->setup_actions(); } return $instance; } /** * Constructor method. * * @since 1.0.0 * @access public * @return void */ private function __construct() {} /** * Loads settings files. * * @since 2.0.0 * @access private * @return void */ private function includes() { // Include the settings functions. require_once( members_plugin()->dir . 'admin/functions-settings.php' ); // Load settings view classes. require_once( members_plugin()->dir . 'admin/views/class-view.php' ); require_once( members_plugin()->dir . 'admin/views/class-view-general.php' ); require_once( members_plugin()->dir . 'admin/views/class-view-addons.php' ); require_once( members_plugin()->dir . 'admin/views/class-view-donate.php' ); } /** * Sets up initial actions. * * @since 2.0.0 * @access private * @return void */ private function setup_actions() { add_action( 'admin_menu', array( $this, 'admin_menu' ) ); } /** * Register a view. * * @since 2.0.0 * @access public * @param object $view * @return void */ public function register_view( $view ) { if ( ! $this->view_exists( $view->name ) ) $this->views[ $view->name ] = $view; } /** * Unregister a view. * * @since 2.0.0 * @access public * @param string $name * @return void */ public function unregister_view( $name ) { if ( $this->view_exists( $name ) ) unset( $this->view[ $name ] ); } /** * Get a view object * * @since 2.0.0 * @access public * @param string $name * @return object */ public function get_view( $name ) { return $this->view_exists( $name ) ? $this->views[ $name ] : false; } /** * Check if a view exists. * * @since 2.0.0 * @access public * @param string $name * @return bool */ public function view_exists( $name ) { return isset( $this->views[ $name ] ); } /** * Sets up custom admin menus. * * @since 1.0.0 * @access public * @return void */ public function admin_menu() { // Create the settings page. $this->settings_page = add_options_page( esc_html_x( 'Members', 'admin screen', 'members' ), esc_html_x( 'Members', 'admin screen', 'members' ), apply_filters( 'members_settings_capability', 'manage_options' ), $this->name, array( $this, 'settings_page' ) ); if ( $this->settings_page ) { do_action( 'members_register_settings_views', $this ); uasort( $this->views, 'members_priority_sort' ); // Register setings. add_action( 'admin_init', array( $this, 'register_settings' ) ); // Page load callback. add_action( "load-{$this->settings_page}", array( $this, 'load' ) ); // Enqueue scripts/styles. add_action( 'admin_enqueue_scripts', array( $this, 'enqueue' ) ); } } /** * Runs on page load. * * @since 2.0.0 * @access public * @return void */ public function load() { // Print custom styles. add_action( 'admin_head', array( $this, 'print_styles' ) ); // Add help tabs for the current view. $view = $this->get_view( members_get_current_settings_view() ); if ( $view ) { $view->load(); $view->add_help_tabs(); } } /** * Print styles to the header. * * @since 2.0.0 * @access public * @return void */ public function print_styles() { ?> settings_page !== $hook_suffix ) return; $view = $this->get_view( members_get_current_settings_view() ); if ( $view ) $view->enqueue(); } /** * Registers the plugin settings. * * @since 1.0.0 * @access public * @return void */ function register_settings() { foreach ( $this->views as $view ) $view->register_settings(); } /** * Renders the settings page. * * @since 1.0.0 * @access public * @return void */ public function settings_page() { ?>