<h2>File Contents: /home/planet5/www/wp-content/plugins/broken-link-checker/core/controllers/class-admin-page.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/broken-link-checker/core/controllers/class-admin-page.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Controller for admin pages.
 *
 * @link    https://wordpress.org/plugins/broken-link-checker/
 * @since   2.0.0
 *
 * @author  WPMUDEV (https://wpmudev.com)
 * @package WPMUDEV_BLC\Core\Controllers
 *
 * @copyright (c) 2022, Incsub (http://incsub.com)
 */

namespace WPMUDEV_BLC\Core\Controllers;

// Abort if called directly.
defined( &#039;WPINC&#039; ) || die;

use WPMUDEV_BLC\Core\Utils\Abstracts\Base;
use WPMUDEV_BLC\Core\Traits\Enqueue;
use WPMUDEV_BLC\Core\Utils\Utilities;
use function get_current_screen;

/**
 * Class Admin_Page
 *
 * @package WPMUDEV_BLC\Core\Controllers
 */
abstract class Admin_Page extends Base {
	/**
	 * Use the Enqueue Trait.
	 *
	 * @since 2.0.0
	 */
	use Enqueue;

	/**
	 * The Admin Page&#039;s Menu Type.
	 *
	 * @since 2.0.0
	 * @var bool $is_submenu Set to true if page uses submenu.
	 *
	 */
	protected $is_submenu = false;

	/**
	 * The Admin SubPage&#039;s Parent Slug.
	 *
	 * @since 2.0.0
	 * @var string $parent_slug The slug of the parent admin menu.
	 *
	 */
	protected $parent_slug;

	/**
	 * The Admin Page&#039;s Title.
	 *
	 * @since 2.0.0
	 * @var string $page_title The text to be displayed in the title tags of the page when the menu is selected.
	 *
	 */
	protected $page_title;

	/**
	 * The Admin Menu&#039;s Title.
	 *
	 * @since 2.0.0
	 * @var string $menu_title The text to be used for the menu.
	 *
	 */
	protected $menu_title;

	/**
	 * Unique ID. Used for unique DOM element id.
	 *
	 * @since 2.0.0
	 * @var string|int $unique_id Unique ID.
	 *
	 */
	protected $unique_id;

	/**
	 * The Admin Menu&#039;s capability.
	 *
	 * @since 2.0.0
	 * @var string $capability The capability required for this menu to be displayed to the user.
	 *
	 */
	protected $capability = &#039;manage_options&#039;;

	/**
	 * The Admin Menu&#039;s Slug.
	 *
	 * @since 2.0.0
	 * @var string $menu_slug The slug name to refer to this menu by. Should be unique.
	 *
	 */
	protected $menu_slug;

	/**
	 * The Admin Menu&#039;s Icon.
	 *
	 * @since 2.0.0
	 * @var string $icon_url The URL to the icon to be used for this menu.
	 *
	 */
	protected $icon_url = &#039;&#039;;

	/**
	 * The Admin Menu&#039;s position.
	 *
	 * @since 2.0.0
	 * @var int $position The position in the menu order this item should appear.
	 *
	 */
	protected $position = null;

	/**
	 * The Admin Menu&#039;s hook suffix.
	 *
	 * @since 2.1.0
	 * @var string $hook_suffix
	 *
	 */
	protected $hook_suffix;


	/**
	 * Init Admin Page
	 *
	 * @since 2.0.0
	 *
	 * @return void Initialize the Admin_Page.
	 */
	public function init() {
		if (
			apply_filters(
				&#039;wpmudev_blc_admin_page_abort_load&#039;,
				! is_admin() || wp_doing_ajax() || ( defined( &#039;WP_CLI&#039; ) &amp;&amp; WP_CLI ),
				$this::instance()
			)
		) {
			return;
		}

		$this-&gt;prepare_props();
		$this-&gt;actions();
	}

	/**
	 * Prepares the properties of the Admin Page.
	 *
	 * @since 2.0.0
	 *
	 * @return void Prepares of the admin page.
	 */
	abstract public function prepare_props();

	/**
	 * Add Actions
	 *
	 * @since 2.0.0
	 *
	 * @return void Add the Actions.
	 */
	public function actions() {
		/**
		 * Until multisites are officially supported, BLC v2 menus are disabled in subsites.
		 * Legacy menus are loaded instead.
		 */
		if ( Utilities::is_subsite() ) {
			return;
		}

		add_action( &#039;admin_menu&#039;, array( $this, &#039;admin_menu&#039; ), 9 );
		add_action( &#039;admin_menu&#039;, array( $this, &#039;admin_submenu&#039; ) );
		add_action( &#039;admin_init&#039;, array( $this, &#039;boot&#039; ) );
	}

	/**
	 * Set the admin_menu for the Admin Page.
	 *
	 * @since 2.0.0
	 *
	 * @return void Creates the admin page menu(s). Should check if menu or submenu.
	 */
	public function admin_menu() {
		if ( ! $this-&gt;is_submenu() &amp;&amp; ! empty( $this-&gt;page_prop( &#039;menu_slug&#039; ) ) ) {
			$this-&gt;hook_suffix = add_menu_page(
				$this-&gt;page_prop( &#039;page_title&#039; ),
				$this-&gt;page_prop( &#039;menu_title&#039; ),
				$this-&gt;page_prop( &#039;capability&#039; ),
				$this-&gt;page_prop( &#039;menu_slug&#039; ),
				array( $this, &#039;output&#039; ),
				$this-&gt;page_prop( &#039;icon_url&#039; ),
				$this-&gt;page_prop( &#039;position&#039; )
			);
		}

	}


	/**
	 * Returns true if page uses submenu.
	 *
	 * @since 2.0.0
	 *
	 * @return bool Returns true if page uses submenu..
	 */
	private function is_submenu() {
		return $this-&gt;is_submenu;
	}

	/**
	 * Get Admin Page&#039;s properties.
	 *
	 * @since 2.0.0
	 *
	 * @return string|int|null Returns true if page uses submenu.
	 */
	private function page_prop( $prop ) {
		$properties = $this-&gt;get_properties();

		return isset( $properties[ $prop ] ) ? $properties[ $prop ] : null;
	}

	/**
	 * Admin Page&#039;s Properties.
	 *
	 * @since 2.0.0
	 *
	 * @return array An array with all Page&#039;s Properties.
	 */
	public function get_properties() {
		return apply_filters(
			&#039;wpmudev_blc_admin_page_props&#039;,
			array(
				&#039;parent_slug&#039; =&gt; $this-&gt;parent_slug,
				&#039;page_title&#039;  =&gt; $this-&gt;page_title,
				&#039;menu_title&#039;  =&gt; $this-&gt;menu_title,
				&#039;capability&#039;  =&gt; $this-&gt;capability,
				&#039;menu_slug&#039;   =&gt; $this-&gt;menu_slug,
				&#039;icon_url&#039;    =&gt; $this-&gt;icon_url,
				&#039;position&#039;    =&gt; $this-&gt;position,
			),
			$this-&gt;menu_slug,
			$this
		);
	}

	/**
	 * Set the admin_submenu for the Admin Page.
	 *
	 * @since 2.0.0
	 *
	 * @return void Creates the admin sub menu(s). Should check if menu or submenu.
	 */
	public function admin_submenu() {
		if ( $this-&gt;is_submenu() &amp;&amp; ! empty( $this-&gt;page_prop( &#039;parent_slug&#039; ) ) ) {
			$this-&gt;hook_suffix = add_submenu_page(
				$this-&gt;page_prop( &#039;parent_slug&#039; ),
				$this-&gt;page_prop( &#039;page_title&#039; ),
				$this-&gt;page_prop( &#039;menu_title&#039; ),
				$this-&gt;page_prop( &#039;capability&#039; ),
				$this-&gt;page_prop( &#039;menu_slug&#039; ),
				array( $this, &#039;output&#039; ),
				$this-&gt;page_prop( &#039;position&#039; )
			);
		}
	}

	/**
	 * Admin init actions.
	 *
	 * @since 2.0.0
	 *
	 * @return void Admin init actions.
	 */
	public function boot() {
		add_action( &#039;current_screen&#039;, array( $this, &#039;current_screen_actions&#039; ) );
	}

	/**
	 * Current screen actions.
	 *
	 * @since 2.0.0
	 *
	 * @return void Current screen actions.
	 */
	public function current_screen_actions() {
		if ( $this-&gt;can_boot() ) {
			$this-&gt;prepare_scripts();
			$this-&gt;page_hooks();
			add_filter( &#039;admin_body_class&#039;, array( $this, &#039;admin_body_classes&#039; ), 999 );
		}
	}

	/**
	 * Admin page url.
	 *
	 * @since 2.3.0
	 *
	 * @return string The url of the admin page.
	 */
	public function admin_page_url( array $args = array() ): string {
		$args[&#039;page&#039;] = $this-&gt;menu_slug;
		/**
		 * Filters site connected result.
		 *
		 * @since 2.3.0
		 */
		return apply_filters( 
			&#039;wpmudev_blc_admin_page_url&#039;,
			add_query_arg(
				$args,
				admin_url( &#039;admin.php&#039; )
			)
		);
	}

	/**
	 * Checks if admin page actions/scripts should load in current screen.
	 *
	 * @since 2.0.0
	 *
	 * @return boolean Checks if admin page actions/scripts should load. Useful for enqueuing scripts.
	 */
	public function can_boot() {
		// Using strpos of the menu_slug, so it can be checked dynamically for toplevel or not.
		// Should also take care of translated menu_slugs.
		return (
			is_admin() &amp;&amp;
			is_callable( &#039;\get_current_screen&#039; ) &amp;&amp;
			isset( get_current_screen()-&gt;id ) &amp;&amp;
			strpos( get_current_screen()-&gt;id, $this-&gt;menu_slug )
		);
	}

	/**
	 * Adds Page specific hooks. Extends $this-&gt;actions.
	 *
	 * @since 2.0.0
	 *
	 * @return void
	 */
	public function page_hooks() {
	}

	/**
	 * Adds SUI admin body class. It will be used in all admin pages.
	 *
	 * @param $classes
	 *
	 * @return string
	 */
	public function admin_body_classes( $classes ) {
		static $added = false;

		if ( ! $added ) {
			$sui_classes   = explode( &#039; &#039;, $classes );

			if ( ! in_array( BLC_SHARED_UI_VERSION, $sui_classes, true ) ) {
				$sui_classes[] = BLC_SHARED_UI_VERSION;
			}

			if ( apply_filters( &#039;wpmudev_branding_hide_branding&#039;, false ) &amp;&amp; ! in_array( &#039;wpmudev-hide-branding&#039;, $sui_classes, true ) ) {
				$sui_classes[] = &#039;wpmudev-hide-branding&#039;;
			}

			$added = true;
			$classes = join( &#039; &#039;, $sui_classes );
		}


		return $classes;
	}

	/**
	 * Register scripts for the admin page.
	 *
	 * @since 2.0.0
	 *
	 * @return array Register scripts for the admin page.
	 */
	public function set_scripts() {
		return array();
	}

	/**
	 * Admin Menu Output.
	 *
	 * @since 2.0.0
	 *
	 * @return void The output function of the Admin Menu Page.
	 */
	abstract public function output();

}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fbroken-link-checker%2Fcore%2Fcontrollers'>⬅ Back to Directory</a>