File "class-setup-wizard.php"

Full path: /home/kosmetik/public_html/wp-content/plugins/seo-by-rank-math/includes/admin/class-setup-wizard.php
File size: 9.18 B
MIME-type: text/x-php
Charset: utf-8

Download   Open   Edit   Advanced Editor   Back

<?php
/**
 * The Setup Wizard - configure the SEO settings in just a few steps.
 *
 * @since      0.9.0
 * @package    RankMath
 * @subpackage RankMath\Admin
 * @author     Rank Math <[email protected]>
 */

namespace RankMath\Admin;

use RankMath\CMB2;
use RankMath\Helper;
use RankMath\Traits\Hooker;
use RankMath\Traits\Wizard;
use RankMath\Helpers\Security;
use RankMath\Admin\Importers\Detector;
use MyThemeShop\Helpers\Param;

defined( 'ABSPATH' ) || exit;

/**
 * Setup_Wizard class.
 */
class Setup_Wizard {

	use Hooker, Wizard;

	/**
	 * Hold steps data.
	 *
	 * @var array
	 */
	protected $steps = [];

	/**
	 * Hold current step.
	 *
	 * @var string
	 */
	protected $step = '';

	/**
	 * Current step slug.
	 *
	 * @var string
	 */
	protected $step_slug = '';

	/**
	 * Top level admin page.
	 *
	 * @var string
	 */
	protected $slug = 'rank-math-wizard';

	/**
	 * CMB2 object.
	 *
	 * @var \CMB2
	 */
	public $cmb = null;

	/**
	 * Wizard Step instance.
	 *
	 * @var Wizard_Step
	 */
	public $wizard_step = null;

	/**
	 * Hook suffix.
	 * 
	 * @var string
	 */
	public $hook_suffix = '';

	/**
	 * The Constructor.
	 */
	public function __construct() {
		$this->action( 'cmb2_admin_init', 'steps', 9 );
		$this->action( 'cmb2_admin_init', 'register_cmb2' );
		$this->action( 'admin_menu', 'add_admin_menu' );
		$this->action( 'admin_post_rank_math_save_wizard', 'save_wizard' );

		// If the page is not this page stop here.
		if ( ! $this->is_current_page() ) {
			return;
		}

		$this->action( 'admin_init', 'admin_page', 30 );
		$this->filter( 'user_has_cap', 'filter_user_has_cap' );
		$this->filter( 'rank_math/wizard/step/label', 'change_label' );
		$this->filter( 'rank_math/wizard/step/label_url', 'change_label_url' );
	}

	/**
	 * Setup steps.
	 */
	public function steps() {
		$this->steps = [
			'compatibility' => [
				'slug'  => 'requirements',
				'name'  => esc_html__( 'Requirements', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Compatibility',
			],
			'import'        => [
				'name'  => esc_html__( 'Import', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Import',
			],
			'yoursite'      => [
				'name'  => esc_html__( 'Your Site', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Your_Site',
			],

			'analytics'     => [
				'name'  => esc_html__( 'Analytics', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Search_Console',
			],

			'sitemaps'      => [
				'name'  => esc_html__( 'Sitemaps', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Sitemap',
			],

			'optimization'  => [
				'name'  => esc_html__( 'Optimization', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Optimization',
			],

			'ready'         => [
				'name'  => esc_html__( 'Ready', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Ready',
			],

			'role'          => [
				'slug'  => 'rolemanager',
				'name'  => esc_html__( 'Role Manager', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Role',
			],

			'redirection'   => [
				'slug'  => '404redirection',
				'name'  => esc_html__( '404 + Redirection', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Monitor_Redirection',
			],

			'schema-markup' => [
				'name'  => esc_html__( 'Schema Markup', 'rank-math' ),
				'class' => '\\RankMath\\Wizard\\Schema_Markup',
			],
		];

		if ( ! Helper::is_advanced_mode() ) {
			unset( $this->steps['sitemaps'] );
			unset( $this->steps['optimization'] );
		}

		$this->set_current_step();
	}

	/**
	 * Register CMB2 option page for setup wizard.
	 */
	public function register_cmb2() {
		$this->cmb = new_cmb2_box(
			[
				'id'           => 'rank-math-wizard',
				'object_types' => [ 'options-page' ],
				'option_key'   => 'rank-math-wizard',
				'hookup'       => false,
				'save_fields'  => false,
				'classes'      => 'wp-core-ui rank-math-ui',
			]
		);

		$this->wizard_step->form( $this );

		/**
		 * Add setting on specific Setup Wizard steps.
		 *
		 * The dynamic part of the hook name. $this->step, is the step ID.
		 *
		 * @param CMB2 $cmb CMB2 object.
		 */
		$this->do_action( 'wizard/settings/' . $this->step, $this->cmb );

		CMB2::pre_init( $this->cmb );
	}

	/**
	 * Change label.
	 *
	 * @param string $label Label.
	 *
	 * @return string
	 */
	public function change_label( $label ) {
		if ( $this->is_advance() ) {
			return esc_html__( 'Advanced Options', 'rank-math' );
		}

		return $label;
	}

	/**
	 * Change label url.
	 *
	 * @param string $url Label Url.
	 *
	 * @return string
	 */
	public function change_label_url( $url ) {

		if ( $this->is_advance() ) {
			return Helper::get_admin_url( 'wizard', 'step=ready' );
		}

		return $url;
	}

	/**
	 * Execute save handler for current step.
	 */
	public function save_wizard() {

		// If no form submission, bail!
		$referer = Param::post( '_wp_http_referer' );
		if ( empty( $_POST ) ) {
			return Helper::redirect( $referer );
		}

		check_admin_referer( 'rank-math-wizard', 'security' );
		if ( ! Helper::has_cap( 'general' ) ) {
			return false;
		}

		$values       = $this->cmb->get_sanitized_values( $_POST );
		$show_content = $this->wizard_step->save( $values, $this );

		$redirect = $show_content ? $this->step_next_link() : $referer;
		if ( is_string( $show_content ) ) {
			$redirect = $show_content;
		}
		Helper::redirect( $redirect );
		exit;
	}

	/**
	 * Add the admin menu item, under Appearance.
	 */
	public function add_admin_menu() {
		if ( Param::get( 'page' ) !== $this->slug ) {
			return;
		}

		$this->hook_suffix = add_submenu_page(
			'',
			esc_html__( 'Setup Wizard', 'rank-math' ),
			esc_html__( 'Setup Wizard', 'rank-math' ),
			'manage_options',
			$this->slug,
			[ $this, 'admin_page' ]
		);
	}

	/**
	 * Output the admin page.
	 */
	public function admin_page() {

		// Do not proceed if we're not on the right page.
		if ( Param::get( 'page' ) !== $this->slug ) {
			return;
		}

		if ( ob_get_length() ) {
			ob_end_clean();
		}

		// Enqueue styles.
		\CMB2_Hookup::enqueue_cmb_css();
		\CMB2_Hookup::enqueue_cmb_js();
		rank_math()->admin_assets->register();
		wp_enqueue_style( 'rank-math-wizard', rank_math()->plugin_url() . 'assets/admin/css/setup-wizard.css', [ 'wp-admin', 'buttons', 'cmb2-styles', 'select2-rm', 'rank-math-common', 'rank-math-cmb2' ], rank_math()->version );

		// Enqueue scripts for the SEO Score Updater tool.
		\RankMath\Tools\Update_Score::get()->enqueue();

		// Enqueue javascript.
		wp_enqueue_script( 'rank-math-wizard', rank_math()->plugin_url() . 'assets/admin/js/wizard.js', [ 'media-editor', 'select2-rm', 'lodash', 'rank-math-common' ], rank_math()->version, true );

		Helper::add_json( 'currentStep', $this->step );
		Helper::add_json( 'deactivated', esc_html__( 'Deactivated', 'rank-math' ) );
		Helper::add_json( 'confirm', esc_html__( 'Are you sure you want to import settings into Rank Math? Don\'t worry, your current configuration will be saved as a backup.', 'rank-math' ) );
		Helper::add_json( 'isConfigured', Helper::is_configured() );

		ob_start();

		/**
		 * Start the actual page content.
		 */
		include_once $this->get_view( 'header' );
		include_once $this->get_view( 'content' );
		include_once $this->get_view( 'footer' );
		exit;
	}

	/**
	 * Check if navigation item is hidden or not.
	 *
	 * @param string $slug Slug of nav item.
	 *
	 * @return bool
	 */
	public function is_nav_item_hidden( $slug ) {
		if ( 'compatibility' === $slug ) {
			return true;
		}

		$is_advanced   = $this->is_advance();
		$advance_steps = [ 'role', 'redirection', 'schema-markup' ];

		return in_array( $slug, $advance_steps, true ) ? ! $is_advanced : $is_advanced;
	}

	/**
	 * Get view file to display.
	 *
	 * @param string $view View to display.
	 * @return string
	 */
	public function get_view( $view ) {
		return rank_math()->admin_dir() . "wizard/views/{$view}.php";
	}

	/**
	 * Get the step URL.
	 *
	 * @param string $step Name of the step, appended to the URL.
	 */
	public function get_step_link( $step ) {
		return Security::add_query_arg( 'step', $step );
	}

	/**
	 * Get Skip Link.
	 */
	public function get_skip_link() {
		?>
		<a href="<?php echo esc_url( $this->step_next_link() ); ?>" class="button button-secondary button-skip"><?php esc_html_e( 'Skip Step', 'rank-math' ); ?></a>
		<?php
	}

	/**
	 * Set current step.
	 */
	private function set_current_step() {
		if ( $this->maybe_remove_import() ) {
			unset( $this->steps['import'] );
		}

		$this->steps       = $this->do_filter( 'wizard/steps', $this->steps );
		$this->step        = Param::request( 'step', current( array_keys( $this->steps ) ) );
		$this->step_slug   = isset( $this->steps[ $this->step ]['slug'] ) ? $this->steps[ $this->step ]['slug'] : $this->step;
		$this->wizard_step = new $this->steps[ $this->step ]['class'];
	}

	/**
	 * Checks if current step is advanced.
	 *
	 * @return bool
	 */
	private function is_advance() {
		$step = Param::request( 'step' );
		return $step && in_array( $step, [ 'role', 'redirection', 'schema-markup' ], true );
	}

	/**
	 * Maybe remove import step.
	 *
	 * @return bool
	 */
	private function maybe_remove_import() {
		$pre = $this->do_filter( 'wizard/pre_remove_import_step', null );
		if ( ! is_null( $pre ) ) {
			return $pre;
		}

		if ( false === get_option( 'rank_math_is_configured' ) ) {
			$detector = new Detector();
			$plugins  = $detector->detect();
			if ( ! empty( $plugins ) ) {
				return false;
			}
		}

		return true;
	}
}