# comments-plus/1.3.0/libs/factory/pages/includes/admin-page.class.php

Disable Comments & Delete All Comments, version 1.3.0. 578 lines.

- Page: https://pluginprobe.com/plugins/comments-plus/1.3.0/code/libs/factory/pages/includes/admin-page.class.php
- Raw: https://pluginprobe.com/plugins/comments-plus/1.3.0/raw/libs/factory/pages/includes/admin-page.class.php
- Modified: 2024-12-10T00:10:16+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/comments-plus/1.3.0/code/libs/factory/pages/includes/admin-page.class.php#L10-L20`.

```php
<?php
/**
 * Admin page class
 *
 * @author        Alex Kovalev <alex.kovalevv@gmail.com>
 * @since         1.0.0
 * @package       factory-core
 * @copyright (c) 2018, Webcraftic Ltd
 *
 */

// Exit if accessed directly
if( !defined('ABSPATH') ) {
	exit;
}

if( !class_exists('Wbcr_FactoryPages480_AdminPage') ) {

	class Wbcr_FactoryPages480_AdminPage extends Wbcr_FactoryPages480_Page {

		/**
		 * Visible page title.
		 * For example: 'License Manager'
		 *
		 * @var string
		 */
		public $page_title;

		/**
		 * Visible title in menu.
		 * For example: 'License Manager'
		 *
		 * @var string
		 */
		public $menu_title = null;

		/**
		 * If set, an extra sub menu will be created with another title.
		 *
		 * @var string
		 */
		public $menu_sub_title = null;

		/**
		 * Иконка меню в главном меню админ панели
		 *
		 * Используется только в том случае, если ссылка на страницу отображается
		 * в главном меню админ панели (левый сайдбар) и не является элементом подменю.
		 *
		 * Пример: '~/assets/img/menu-icon.png', ~/ будет заменен ссылкой на корневую
		 * директорию плагина.
		 * Можно использовать dashicons: '\f321'
		 *
		 * @var string
		 */
		public $menu_icon = null;

		/**
		 * Позиция в главном меню админ панели
		 *
		 * Если эта страница была добавлена в главное меню админ панели (левый сайдбар).
		 * Вы можете установить позицию меню. Подробнее смотрите в Wordpress кодексе.
		 *
		 * @link http://codex.wordpress.org/Function_Reference/add_menu_page
		 *
		 * Позиция может быть установлена от 0 до 100 и чем больше цифра, тем ниже будет
		 * расположен пункт меню.
		 *
		 * Внимание! Если два пункта используют одинаковую цифру-позицию, один из пунктов
		 * меню может быть перезаписан и будет показан только один пункт из двух.
		 * Чтобы избежать конфликта, можно использовать десятичные значения, вместо целых
		 * чисел: 63.3 вместо 63. Используйте кавычки: "63.3".
		 *
		 * 2 Консоль
		 * 4 Разделитель
		 * 5 Посты
		 * 10 Медиа
		 * 15 Ссылки
		 * 20 Страницы
		 * 25 Комментарии
		 * 59 Разделитель
		 * 60 Внешний вид
		 * 65 Плагины
		 * 70 Пользователи
		 * 75 Инструменты
		 * 80 Настройки
		 * 99 Разделитель
		 *
		 * @var string
		 */
		public $menu_position = null;

		/**
		 * Тип записи к меню которой, нужно прикрепить ссылку на страницу
		 *
		 * К примеру, если вы установите тип записи "post". В меню "Записи" появится
		 * ссылка на эту страницу, как элемент подменю.
		 *
		 * Пример: 'post'
		 *
		 * @var string
		 */
		public $menu_post_type = null;

		/**
		 * Название (slug) элемента главного родительского меню в админ панели, в которое будет
		 * добавлен пункт меню этой страницы, как элемент подменю.
		 *
		 * Примеры:
		 * index.php - Консоль (Dashboard). Или спец. функция: add_dashboard_page();
		 * edit.php - Посты (Posts). Или спец. функция: add_posts_page();
		 * upload.php - Медиафайлы (Media). Или спец. функция: add_media_page();
		 * link-manager.php - Ссылки (Links). Или спец. функция: add_links_page();
		 * edit.php?post_type=page - Страницы (Pages). Или спец. функция: add_pages_page();
		 * edit-comments.php - Комментарии (Comments). Или спец. функция: add_comments_page();
		 * edit.php?post_type=your_post_type - Произвольные типы записей.
		 * themes.php - Внешний вид (Appearance). Или спец. функция: add_theme_page();
		 * plugins.php - Плагины (Plugins). Или спец. функция: add_plugins_page();
		 * users.php - Пользователи (Users). Или спец. функция: add_users_page();
		 * tools.php - Инструменты (Tools). Или спец. функция: add_management_page();
		 * options-general.php - Настройки (Settings). Или спец. функция: add_options_page()
		 * settings.php - Настройки (Settings) сети сайтов в MU режиме.
		 *
		 * @var string
		 */
		public $menu_target = null;

		/**
		 * if true, then admin.php is used as a base url.
		 *
		 * @var bool
		 */
		public $custom_target = false;

		/**
		 * Разрешения пользователя, чтобы иметь доступ к странице.
		 *
		 * Этот параметр отвечает и за доступ к странице этого пункта меню. Подробнее
		 * смотрите в кодексе Wordpress:
		 *
		 * @link http://codex.wordpress.org/Roles_and_Capabilities
		 *
		 * Указывать массив разрешений, например:
		 * ['manage_options', 'manage_network']
		 *
		 * @var array
		 */
		public $capabilitiy = null;

		/**
		 * Скрыть страницу из главного меню админ панели?
		 *
		 * Если true, то закладка на эту страницу не будет добавлена в главное меню
		 * админ панели.
		 *
		 * @var bool
		 */
		public $internal = false;

		/**
		 * If true, the page is for network
		 *
		 * @var bool
		 */
		public $network = false;

		/**
		 * Предотвратить создание страницы?
		 *
		 * Если true, то страница не будет создана. Может пригодиться в тех случаях,
		 * когда страница должна быть создана только при выполнении условий.
		 *
		 * @since 3.0.6
		 * @var bool
		 */
		public $hidden = false;

		/**
		 * Сделать доступной страницу в панели управлениям сайтами (панель суперадминистратора)
		 *
		 * Если установлено true, в панели управления сайтами появится закладка на эту страницу.
		 * Также эта страница получить разрешения на просмотр для группы суперадминистраторов.
		 *
		 * @var bool
		 */
		public $available_for_multisite = false;

		/**
		 * Задать текст ссылки на странице плагинов (рядом с активировать/деактивировать)
		 *
		 * Будет работать только, свойство $add_link_to_plugin_actions=true.
		 * По умолчанию, если текст ссылки не задан, используется заголовок элемента меню
		 * или заголовок страницы.
		 *
		 * @var string
		 */
		public $title_plugin_action_link;

		/**
		 * Добавлять ссылку на странице плагинов (рядом с активировать/деактивировать)?
		 *
		 * Если true, будет автоматически добавлена ссылка на эту страницу, внутри страницы
		 * wp-admin/plugins.php (рядом с активировать/деактивировать). Чаще всего требуется
		 * добавить ссылку на страницу настроек. Если эта страница у вас является главной,
		 * то вы можете сделать это свойство активным.
		 *
		 * @link https://codex.wordpress.org/Plugin_API/Filter_Reference/plugin_action_links_(plugin_file_name)
		 * @var bool
		 */
		public $add_link_to_plugin_actions = false;

		public function __construct(Wbcr_Factory480_Plugin $plugin)
		{
			parent::__construct($plugin);
			$this->configure();

			$this->id = empty($this->id) ? str_replace('adminpage', '', strtolower(get_class($this))) : $this->id;

			if( $this->add_link_to_plugin_actions ) {
				if( $plugin->isNetworkActive() ) {
					// plugin settings link
					add_filter("network_admin_plugin_action_links_" . $this->plugin->get_paths()->basename, [
						$this,
						'addLinkToPluginActions'
					]);
				} else {
					// plugin settings link
					add_filter("plugin_action_links_" . $this->plugin->get_paths()->basename, [
						$this,
						'addLinkToPluginActions'
					]);
				}
			}
		}

		/**
		 * May be used to configure the page before uts usage.
		 */
		public function configure()
		{
		}

		/**
		 * Includes the Factory Bootstrap assets for a current page.
		 *
		 * @param string $hook
		 *
		 * @return void
		 */
		public function actionAdminBootstrapScripts($hook)
		{
			$this->scripts->connect('bootstrap');
			$this->styles->connect('bootstrap');
		}

		/**
		 * Includes the assets for a current page (all assets except Factory Bootstrap assets).
		 *
		 * @param string $hook
		 *
		 * @return void
		 */
		public function actionAdminScripts($hook)
		{
			$this->scripts->connect();
			$this->styles->connect();
		}

		/**
		 * @return string
		 */
		public function getMenuScope()
		{
			return $this->plugin->getPluginName();
		}


		/**
		 * @return string
		 */
		public function getMenuTitle()
		{
			$menu_title = !$this->menu_title ? $this->page_title : $this->menu_title;

			/**
			 * @since 4.0.9 - добавлен
			 */
			return apply_filters('wbcr/factory/pages/impressive/menu_title', $menu_title, $this->plugin->getPluginName(), $this->id);
		}

		/**
		 * @return string
		 */
		public function getPageTitle()
		{

			$page_title = !$this->page_title ? $this->getMenuTitle() : $this->page_title;

			/**
			 * @since 4.0.9 - добавлен
			 */
			return apply_filters('wbcr/factory/pages/impressive/page_title', $page_title, $this->plugin->getPluginName(), $this->id);
		}

		/**
		 * @param null $id
		 *
		 * @return mixed|string
		 */
		public function getResultId($id = null)
		{
			$id = !empty($id) ? $id : $this->id;

			if( $this->plugin ) {
				return $id . '-' . $this->getMenuScope();
			}

			return $id;
		}

		/**
		 * Registers admin page for the admin menu.
		 */
		public function connect()
		{
			$result_id = $this->getResultId();

			$this->hidden = apply_filters('wbcr_factory_480_page_is_hidden_' . $result_id, $this->hidden);

			if( $this->hidden ) {
				return;
			}

			$this->internal = apply_filters('wbcr_factory_480_page_is_internal_' . $result_id, $this->internal);

			if( $this->internal ) {
				$this->menu_target = null;
				$this->menu_post_type = null;
			}

			// makes redirect to the page
			$controller = $this->request->get('fy_page', null, true);

			if( $controller && $controller == $this->id ) {
				$plugin = $this->request->get('fy_plugin', null, true);

				if( $this->plugin->getPluginName() == $plugin ) {

					$action = $this->request->get('fy_action', 'index', true);
					$is_ajax = $this->request->get('fy_ajax', false);

					if( $is_ajax ) {
						$this->executeByName($action);
						exit;
					} else {

						$params = (array)$this->request->getAll(true);

						unset($params['fy_page']);
						unset($params['fy_plugin']);
						unset($params['fy_action']);

						$this->redirectToAction($action, $params);
					}
				}
			}

			// calls scripts and styles, adds pages to menu
			if( $this->request->get('page', 'none') == $result_id ) {
				$this->assets($this->scripts, $this->styles);

				if( !$this->scripts->isEmpty('bootstrap') || !$this->styles->isEmpty('bootstrap') ) {
					add_action('wbcr_factory_480_bootstrap_enqueue_scripts_' . $this->plugin->getPluginName(), [
						$this,
						'actionAdminBootstrapScripts'
					]);
				}

				// includes styles and scripts
				if( !$this->scripts->isEmpty() || !$this->styles->isEmpty() ) {
					add_action('admin_enqueue_scripts', [$this, 'actionAdminScripts']);
				}
			}

			// if this page for a custom menu page
			if( $this->menu_post_type ) {
				$this->menu_target = 'edit.php?post_type=' . $this->menu_post_type;

				if( empty($this->capabilitiy) ) {
					$this->capabilitiy = 'edit_' . $this->menu_post_type;
				}
			}

			// sets default capabilities
			if( empty($this->capabilitiy) ) {
				$this->capabilitiy = 'manage_options';
			}

			// submenu
			if( $this->menu_target ) {
				add_submenu_page($this->menu_target, $this->getPageTitle(), $this->getMenuTitle(), $this->capabilitiy, $result_id, [
					$this,
					'show'
				]);
				// global menu
			} else {
				add_menu_page($this->getPageTitle(), $this->getMenuTitle(), $this->capabilitiy, $result_id, [
					$this,
					'show'
				], null, $this->menu_position);

				if( !empty($this->menu_sub_title) ) {

					add_submenu_page($result_id, $this->menu_sub_title, $this->menu_sub_title, $this->capabilitiy, $result_id, [
						$this,
						'show'
					]);
				}

				add_action('admin_head', [$this, 'actionAdminHead']);
			}

			// executes an action
			if( $this->current() ) {
				ob_start();
				$action = $this->request->get('action', 'index', true);
				$this->executeByName($action);
				$this->result = ob_get_contents();
				ob_end_clean();
			}
		}

		protected function current()
		{
			$result_id = $this->getResultId();

			if( $result_id == $this->request->get('page', 'none') ) {
				return true;
			}

			return false;
		}

		/**
		 * @param string $action
		 * @param array $query_args
		 */
		public function redirectToAction($action, $query_args = [])
		{

			wp_safe_redirect($this->getActionUrl($action, $query_args));
			exit;
		}

		/**
		 * @param string $action
		 * @param array $query_args
		 */
		public function actionUrl($action = null, $query_args = [])
		{
			echo $this->getActionUrl($action, $query_args);
		}

		/**
		 * @param null $action
		 * @param array $query_args
		 *
		 * @return string
		 */
		public function getActionUrl($action = null, $query_args = [])
		{
			$url = $this->getBaseUrl(null, $query_args);

			if( !empty($action) ) {
				$url = add_query_arg('action', $action, $url);
			}

			return $url;
		}

		/**
		 * @return string
		 */
		public function getBaseUrl($id = null, $query_args = [])
		{
			$result_id = $this->getResultId($id);

			if( $this->menu_target && !$this->custom_target ) {
				$url = $this->network ? network_admin_url($this->menu_target) : admin_url($this->menu_target);

				return add_query_arg(array_merge(['page' => $result_id], $query_args), $url);
			}

			$url = $this->network ? network_admin_url('admin.php') : admin_url('admin.php');

			return add_query_arg(array_merge(['page' => $result_id, $query_args]), $url);
		}

		public function actionAdminHead()
		{
			$result_id = $this->getResultId();

			if( !empty($this->menu_icon) ) {

				if( preg_match('/\\\f\d{3}/', $this->menu_icon) ) {
					$icon_code = $this->menu_icon;
				} else {
					$icon_url = str_replace('~/', $this->plugin->get_paths()->url . '/', $this->menu_icon);
				}
			}

			global $wp_version;

			if( version_compare($wp_version, '3.7.3', '>') ) {
				?>
				<style type="text/css" media="screen">
					<?php if ( !empty($icon_url) ) { ?>

					a.toplevel_page_<?php echo $result_id ?> .wp-menu-image {
						background: url('<?php echo $icon_url ?>') no-repeat 10px -30px !important;
					}

					<?php } ?>

					a.toplevel_page_<?php echo $result_id ?> .wp-menu-image:before {
						content: "<?php echo !empty($icon_code) ? $icon_code : ''; ?>" !important;
					}

					a.toplevel_page_<?php echo $result_id ?>:hover .wp-menu-image,
					a.toplevel_page_<?php echo $result_id ?>.wp-has-current-submenu .wp-menu-image,
					a.toplevel_page_<?php echo $result_id ?>.current .wp-menu-image {
						background-position: 10px 2px !important;
					}
				</style>
			<?php } else { ?>
				<style type="text/css" media="screen">
					a.toplevel_page_<?php echo $result_id ?> .wp-menu-image {
						background: url('<?php echo $icon_url ?>') no-repeat 6px -33px !important;
					}

					a.toplevel_page_<?php echo $result_id ?>:hover .wp-menu-image,
					a.toplevel_page_<?php echo $result_id ?>.current .wp-menu-image {
						background-position: 6px -1px !important;
					}
				</style>
				<?php
			}

			if( $this->internal ) {
				?>
				<style type="text/css" media="screen">
					li.toplevel_page_<?php echo $result_id ?> {
						display: none;
					}
				</style>
				<?php
			}
		}


		/**
		 * Add settings link in plugins list
		 *
		 * @param $links
		 *
		 * @return mixed
		 */
		function addLinkToPluginActions($links)
		{
			$link_title = !empty($this->title_plugin_action_link) ? $this->title_plugin_action_link : $this->getMenuTitle();

			$settings_link = '<a href="' . $this->getBaseUrl() . '">' . $link_title . '</a>';
			array_unshift($links, $settings_link);

			return $links;
		}
	}
}
```