You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

403 lines
9.2 KiB
PHP

<?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 <support@rankmath.com>
*/
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 RankMath\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;
}
}