JezK

Edit File: class.bcn_network_admin.php

<?php /* Copyright 2015-2025 John Havlik (email : john.havlik@mtekk.us) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 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 */ require_once(dirname(__FILE__) . '/includes/block_direct_access.php'); //Include admin base class if(!class_exists('bcn_admin')) { require_once(dirname(__FILE__) . '/class.bcn_admin.php'); } use mtekk\adminKit\{adminKit, form, message, setting}; /** * The administrative interface class * */ class bcn_network_admin extends bcn_admin { const version = breadcrumb_navxt::version; protected $full_name = 'Breadcrumb NavXT Network Settings'; protected $access_level = 'manage_network_options'; /** * Administrative interface class default constructor * @param bcn_breadcrumb_trail $breadcrumb_trail a breadcrumb trail object * @param string $basename The basename of the plugin */ public function __construct(array &$opts, $basename, array &$settings) { //We're going to make sure we load the parent's constructor parent::__construct($opts, $basename, $settings); //Change to the proper name $this->full_name = __('Breadcrumb NavXT Network Settings', 'breadcrumb-navxt'); //Remove the hook added by the parent as we don't want this classes settings page everywhere remove_action('admin_menu', array($this, 'add_page')); //Replace with the network_admin hook add_action('network_admin_menu', array($this, 'add_page')); } public function is_network_admin() { return true; } /** * admin initialization callback function * * is bound to wordpress action 'admin_init' on instantiation * * @since 3.2.0 * @return void */ public function init() { //We're going to make sure we run the parent's version of this function as well parent::init(); } public function wp_loaded() { parent::wp_loaded(); } /** * Return the URL of the settings page for the plugin */ public function admin_url() { return admin_url('network/settings.php?page=' . $this->identifier); } /** * Adds the adminpage the menu and the nice little settings link */ public function add_page() { //Add the submenu page to "settings" menu $hookname = add_submenu_page('settings.php', $this->full_name, $this->short_name, $this->access_level, $this->identifier, array($this, 'admin_page')); // check capability of user to manage options (access control) if(current_user_can($this->access_level)) { //Register admin_head-$hookname callback add_action('admin_head-' . $hookname, array($this, 'admin_head')); //Register admin_print_styles-$hookname callback add_action('admin_print_styles-' . $hookname, array($this, 'admin_styles')); //Register admin_print_scripts-$hookname callback add_action('admin_print_scripts-' . $hookname, array($this, 'admin_scripts')); //Register Help Output add_action('load-' . $hookname, array($this, 'help')); } } /** * help action hook function * * @return string * */ public function help() { $screen = get_current_screen(); //Exit early if the add_help_tab function doesn't exist if(!method_exists($screen, 'add_help_tab')) { return; } //Add contextual help on current screen if($screen->id == 'settings_page_' . $this->identifier . '-network') { $this->help_contents($screen); } } /** * Have to hook into get_option and replace with network wide alternate * * @param string $option The name of the option to retrieve * @return mixed The value of the option */ public function get_option($option) { return get_site_option($option); } /** * Have to hook into update_option and replace with network wide alternate * * @param string $option The name of the option to update * @param mixed $newvalue The new value to set the option to * */ public function update_option($option, $newvalue, $autoload = null) { return update_site_option($option, $newvalue); } /** * Have to hook into add_option and replace with network wide alternate * * @param string $option The name of the option to update * @param mixed $value The new value to set the option to * @param null $deprecated Deprecated parameter * @param string $autoload Whether or not to autoload the option, it's a string because WP is special * */ public function add_option($option, $value = '', $deprecated = '', $autoload = 'yes') { return add_site_option($option, $value); } /** * Have to hook into delete_option and replace with network wide alternate * * @param string $option The name of the option to delete */ public function delete_option($option) { return delete_site_option($option); } /** * A message function that checks for the BCN_SETTINGS_* define statement */ public function multisite_settings_warn() { if(is_multisite()) { if(defined('BCN_SETTINGS_USE_LOCAL') && BCN_SETTINGS_USE_LOCAL) { $this->messages[] = new message(esc_html__('Warning: Individual site settings will override any settings set in this page.', 'breadcrumb-navxt'), 'warning', true, $this->unique_prefix . '_msg_ns_isiteoveride'); } else if(defined('BCN_SETTINGS_USE_NETWORK') && BCN_SETTINGS_USE_NETWORK) { } else if(defined('BCN_SETTINGS_FAVOR_LOCAL') && BCN_SETTINGS_FAVOR_LOCAL) { $this->messages[] = new message(esc_html__('Warning: Individual site settings may override any settings set in this page.', 'breadcrumb-navxt'), 'warning', true, $this->unique_prefix . '_msg_ns_isitemayoveride'); } else if(defined('BCN_SETTINGS_FAVOR_NETWORK') && BCN_SETTINGS_FAVOR_NETWORK) { $this->messages[] = new message(esc_html__('Warning: Individual site settings may override any settings set in this page.', 'breadcrumb-navxt'), 'warning', true, $this->unique_prefix . '_msg_ns_nsmayoveride'); } //Fall through if no settings mode was set else { $this->messages[] = new message(esc_html__('Warning: No BCN_SETTINGS_* define statement found, defaulting to BCN_SETTINGS_USE_LOCAL.', 'breadcrumb-navxt'), 'warning', true, $this->unique_prefix . '_msg_ns_nosetting'); $this->messages[] = new message(esc_html__('Warning: Individual site settings will override any settings set in this page.', 'breadcrumb-navxt'), 'warning', true, $this->unique_prefix . '_msg_ns_isiteoveride'); } } } /** * A message function that checks for deprecated settings that are set and warns the user */ public function deprecated_settings_warn() { parent::deprecated_settings_warn(); } /** * Function checks the current site to see if the blog options should be disabled * * @return boool Whether or not the blog options should be disabled */ public function maybe_disable_blog_options() { return false; } /** * Function checks the current site to see if the mainsite options should be disabled * * @return bool Whether or not the mainsite options should be disabled */ public function maybe_disable_mainsite_options() { return false; } }