编辑文件

编辑文件：class-database-tools.php

<?php
/**
 * The Database_Tools is responsible for the Database Tools inside Status & Tools.
 *
 * @package    RankMath
 * @subpackage RankMath\Database_Tools
 */

namespace RankMath\Tools;

use RankMath\Helper;
use RankMath\Helpers\Str;
use RankMath\Helpers\Arr;
use RankMath\Helpers\Schedule;
use RankMath\Installer;
use RankMath\Traits\Hooker;
use RankMath\Helpers\DB as DB_Helper;
use RankMath\Helpers\Sitepress;

defined( 'ABSPATH' ) || exit;

/**
 * Database_Tools class.
 */
class Database_Tools {

use Hooker;

/**
	 * Constructor.
	 */
	public function __construct() {
		if ( Helper::is_heartbeat() || ! Helper::is_advanced_mode() ) {
			return;
		}

Yoast_Blocks::get();
		AIOSEO_Blocks::get();
		Update_Score::get();
		$this->hooks();
	}

/**
	 * Register version control hooks.
	 */
	public function hooks() {
		if ( Helper::is_rest() && Str::contains( 'toolsAction', add_query_arg( [] ) ) ) {
			foreach ( $this->get_tools() as $id => $tool ) {
				if ( ! method_exists( $this, $id ) ) {
					continue;
				}

add_filter( 'rank_math/tools/' . $id, [ $this, $id ] );
			}
		}
	}

/**
	 * Get localized JSON data to be used on the Database Tools view of the Status & Tools page.
	 */
	public static function get_json_data() {
		return [
			'tools' => self::get_tools(),
		];
	}

/**
	 * Function to clear all the transients from the database.
	 */
	public function clear_transients() {
		global $wpdb;

$transients = DB_Helper::get_col(
			"SELECT `option_name` AS `name`
			FROM  $wpdb->options
			WHERE `option_name` LIKE '%\\_transient\\_rank_math%'
			ORDER BY `option_name`"
		);

if ( empty( $transients ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No Rank Math transients found.', 'seo-by-rank-math' ),
			];
		}

$count = 0;
		foreach ( $transients as $transient ) {
			delete_option( $transient );
			++$count;
		}

// Translators: placeholder is the number of transients deleted.
		return sprintf( _n( '%d Rank Math transient cleared.', '%d Rank Math transients cleared.', $count, 'seo-by-rank-math' ), $count );
	}

/**
	 * Function to reset the SEO Analyzer.
	 */
	public function clear_seo_analysis() {
		$stored = get_option( 'rank_math_seo_analysis_results' );
		if ( empty( $stored ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'SEO Analyzer data has already been cleared.', 'seo-by-rank-math' ),
			];
		}

delete_option( 'rank_math_seo_analysis_results' );
		delete_option( 'rank_math_seo_analysis_date' );

return __( 'SEO Analyzer data successfully deleted.', 'seo-by-rank-math' );
	}

/**
	 * Function to delete all the Internal Links data.
	 */
	public function delete_links() {
		global $wpdb;

$exists = DB_Helper::get_var( "SELECT EXISTS ( SELECT 1 FROM {$wpdb->prefix}rank_math_internal_links )" );
		if ( empty( $exists ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No Internal Links data found.', 'seo-by-rank-math' ),
			];
		}

DB_Helper::query( "TRUNCATE TABLE {$wpdb->prefix}rank_math_internal_links" );
		DB_Helper::query( "TRUNCATE TABLE {$wpdb->prefix}rank_math_internal_meta" );

return __( 'Internal Links successfully deleted.', 'seo-by-rank-math' );
	}

/**
	 * Function to delete all the 404 log items.
	 */
	public function delete_log() {
		global $wpdb;

$exists = DB_Helper::get_var( "SELECT EXISTS ( SELECT 1 FROM {$wpdb->prefix}rank_math_404_logs )" );
		if ( empty( $exists ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No 404 log data found.', 'seo-by-rank-math' ),
			];
		}

DB_Helper::query( "TRUNCATE TABLE {$wpdb->prefix}rank_math_404_logs;" );

return __( '404 Log successfully deleted.', 'seo-by-rank-math' );
	}

/**
	 * Function to delete all Redirections data.
	 */
	public function delete_redirections() {
		global $wpdb;

$exists = DB_Helper::get_var( "SELECT EXISTS ( SELECT 1 FROM {$wpdb->prefix}rank_math_redirections )" );
		if ( empty( $exists ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No Redirections found.', 'seo-by-rank-math' ),
			];
		}

DB_Helper::query( "TRUNCATE TABLE {$wpdb->prefix}rank_math_redirections;" );
		DB_Helper::query( "TRUNCATE TABLE {$wpdb->prefix}rank_math_redirections_cache;" );

return __( 'Redirection rules successfully deleted.', 'seo-by-rank-math' );
	}

/**
	 * Re-create Database Tables.
	 *
	 * @return string
	 */
	public function recreate_tables() {
		// Base.
		Installer::create_tables( get_option( 'rank_math_modules', [] ) );

// ActionScheduler.
		$this->maybe_recreate_actionscheduler_tables();

// Analytics module.
		if ( Helper::is_module_active( 'analytics' ) ) {
			Schedule::async_action(
				'rank_math/analytics/workflow/create_tables',
				[],
				'rank-math'
			);
		}

return __( 'Table re-creation started. It might take a couple of minutes.', 'seo-by-rank-math' );
	}

/**
	 * Recreate ActionScheduler tables if missing.
	 */
	public function maybe_recreate_actionscheduler_tables() {
		global $wpdb;

if ( Helper::is_woocommerce_active() ) {
			return;
		}

if (
			! class_exists( 'ActionScheduler_HybridStore' )
			|| ! class_exists( 'ActionScheduler_StoreSchema' )
			|| ! class_exists( 'ActionScheduler_LoggerSchema' )
		) {
			return;
		}

$table_list = [
			'actionscheduler_actions',
			'actionscheduler_logs',
			'actionscheduler_groups',
			'actionscheduler_claims',
		];

$found_tables = DB_Helper::get_col( "SHOW TABLES LIKE '{$wpdb->prefix}actionscheduler%'" );
		foreach ( $table_list as $table_name ) {
			if ( ! in_array( $wpdb->prefix . $table_name, $found_tables, true ) ) {
				$this->recreate_actionscheduler_tables();
				return;
			}
		}
	}

/**
	 * Force the data store schema updates.
	 */
	public function recreate_actionscheduler_tables() {
		$store = new \ActionScheduler_HybridStore();
		add_action( 'action_scheduler/created_table', [ $store, 'set_autoincrement' ], 10, 2 );

$store_schema  = new \ActionScheduler_StoreSchema();
		$logger_schema = new \ActionScheduler_LoggerSchema();
		$store_schema->register_tables( true );
		$logger_schema->register_tables( true );

remove_action( 'action_scheduler/created_table', [ $store, 'set_autoincrement' ], 10 );
	}

/**
	 * Function to convert Yoast blocks in posts to Rank Math blocks (FAQ & HowTo).
	 *
	 * @return string
	 */
	public function yoast_blocks() {
		$posts = Yoast_Blocks::get()->find_posts();
		if ( empty( $posts['posts'] ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No posts found to convert.', 'seo-by-rank-math' ),
			];
		}

Yoast_Blocks::get()->start( $posts['posts'] );

return __( 'Conversion started. A success message will be shown here once the process completes. You can close this page.', 'seo-by-rank-math' );
	}

/**
	 * Function to convert AIOSEO blocks in posts to Rank Math blocks (TOC).
	 *
	 * @return string
	 */
	public function aioseo_blocks() {
		$posts = AIOSEO_Blocks::get()->find_posts();
		if ( empty( $posts['posts'] ) ) {
			return [
				'status'  => 'error',
				'message' => __( 'No posts found to convert.', 'seo-by-rank-math' ),
			];
		}

AIOSEO_Blocks::get()->start( $posts['posts'] );

return __( 'Conversion started. A success message will be shown here once the process completes. You can close this page.', 'seo-by-rank-math' );
	}

/**
	 * Get tools.
	 *
	 * @return array
	 */
	private static function get_tools() {
		$tools = [];

if ( Helper::is_module_active( 'seo-analysis' ) ) {
			$tools['clear_seo_analysis'] = [
				'title'       => __( 'Flush SEO Analyzer Data', 'seo-by-rank-math' ),
				'description' => __( "Need a clean slate or not able to run the SEO Analyzer tool? Flushing the analysis data might fix the issue. Flushing SEO Analyzer data is entirely safe and doesn't remove any critical data from your website.", 'seo-by-rank-math' ),
				'button_text' => __( 'Clear SEO Analyzer', 'seo-by-rank-math' ),
			];
		}

$tools['clear_transients'] = [
			'title'       => __( 'Remove Rank Math Transients', 'seo-by-rank-math' ),
			'description' => __( 'If you see any issue while using Rank Math or one of its options - clearing the Rank Math transients fixes the problem in most cases. Deleting transients does not delete ANY data added using Rank Math.', 'seo-by-rank-math' ),
			'button_text' => __( 'Remove transients', 'seo-by-rank-math' ),
		];

if ( Helper::is_module_active( '404-monitor' ) ) {
			$tools['delete_log'] = [
				'title'        => __( 'Clear 404 Log', 'seo-by-rank-math' ),
				'description'  => __( 'Is the 404 error log getting out of hand? Use this option to clear ALL 404 logs generated by your website in the Rank Math 404 Monitor.', 'seo-by-rank-math' ),
				'confirm_text' => __( 'Are you sure you want to delete the 404 log? This action is irreversible.', 'seo-by-rank-math' ),
				'button_text'  => __( 'Clear 404 Log', 'seo-by-rank-math' ),
			];
		}

$tools['recreate_tables'] = [
			'title'       => __( 'Re-create Missing Database Tables', 'seo-by-rank-math' ),
			'description' => __( 'Check if required tables exist and create them if not.', 'seo-by-rank-math' ),
			'button_text' => __( 'Re-create Tables', 'seo-by-rank-math' ),
		];

if ( Helper::is_module_active( 'analytics' ) ) {
			$tools['analytics_fix_collations'] = [
				'title'       => __( 'Fix Analytics table collations', 'seo-by-rank-math' ),
				'description' => __( 'In some cases, the Analytics database tables or columns don\'t match with each other, which can cause database errors. This tool can fix that issue.', 'seo-by-rank-math' ),
				'button_text' => __( 'Fix Collations', 'seo-by-rank-math' ),
			];
		}

$block_posts = Yoast_Blocks::get()->find_posts();
		if ( is_array( $block_posts ) && ! empty( $block_posts['count'] ) ) {
			$tools['yoast_blocks'] = [
				'title'        => __( 'Yoast Block Converter', 'seo-by-rank-math' ),
				'description'  => __( 'Convert FAQ, HowTo, & Table of Contents Blocks created using Yoast. Use this option to easily move your previous blocks into Rank Math.', 'seo-by-rank-math' ),
				'confirm_text' => __( 'Are you sure you want to convert Yoast blocks into Rank Math blocks? This action is irreversible.', 'seo-by-rank-math' ),
				'button_text'  => __( 'Convert Blocks', 'seo-by-rank-math' ),
			];
		}

$aio_block_posts = AIOSEO_Blocks::get()->find_posts();
		if ( is_array( $aio_block_posts ) && ! empty( $aio_block_posts['count'] ) ) {
			$tools['aioseo_blocks'] = [
				'title'        => __( 'AIOSEO Block Converter', 'seo-by-rank-math' ),
				'description'  => __( 'Convert TOC block created using AIOSEO. Use this option to easily move your previous blocks into Rank Math.', 'seo-by-rank-math' ),
				'confirm_text' => __( 'Are you sure you want to convert AIOSEO blocks into Rank Math blocks? This action is irreversible.', 'seo-by-rank-math' ),
				'button_text'  => __( 'Convert Blocks', 'seo-by-rank-math' ),
			];
		}

if ( Helper::is_module_active( 'link-counter' ) ) {
			$tools['delete_links'] = [
				'title'        => __( 'Delete Internal Links Data', 'seo-by-rank-math' ),
				'description'  => __( 'In some instances, the internal links data might show an inflated number or no number at all. Deleting the internal links data might fix the issue.', 'seo-by-rank-math' ),
				'confirm_text' => __( 'Are you sure you want to delete Internal Links Data? This action is irreversible.', 'seo-by-rank-math' ),
				'button_text'  => __( 'Delete Internal Links', 'seo-by-rank-math' ),
			];
		}

if ( Helper::is_module_active( 'redirections' ) ) {
			$tools['delete_redirections'] = [
				'title'        => __( 'Delete Redirections Rules', 'seo-by-rank-math' ),
				'description'  => __( 'Getting a redirection loop or need a fresh start? Delete all the redirections using this tool. Note: This process is irreversible and will delete ALL your redirection rules.', 'seo-by-rank-math' ),
				'confirm_text' => __( 'Are you sure you want to delete all the Redirection Rules? This action is irreversible.', 'seo-by-rank-math' ),
				'button_text'  => __( 'Delete Redirections', 'seo-by-rank-math' ),
			];
		}

if ( ! empty( Update_Score::get()->find() ) ) {
			$tools['update_seo_score'] = [
				'title'       => __( 'Update SEO Scores', 'seo-by-rank-math' ),
				'description' => __( 'This tool will calculate the SEO score for the posts/pages that have a Focus Keyword set. Note: This process may take some time and the browser tab must be kept open while it is running.', 'seo-by-rank-math' ),
				'button_text' => __( 'Recalculate Scores', 'seo-by-rank-math' ),
			];
		}

if ( Helper::is_module_active( 'analytics' ) && Helper::has_cap( 'analytics' ) ) {

Arr::insert(
				$tools,
				[
					'analytics_clear_caches' => [
						'title'       => __( 'Purge Analytics Cache', 'seo-by-rank-math' ),
						'description' => __( 'Clear analytics cache to re-calculate all the stats again.', 'seo-by-rank-math' ),
						'button_text' => __( 'Clear Cache', 'seo-by-rank-math' ),
					],
				],
				3
			);

$description = __( 'Missing some posts/pages in the Analytics data? Clear the index and build a new one for more accurate stats.', 'seo-by-rank-math' );

$sitepress = Sitepress::get()->is_active() ? Sitepress::get()->get_var() : false;
			if ( Sitepress::get()->is_per_domain() && ! empty( $sitepress->get_setting( 'auto_adjust_ids', null ) ) ) {
				$description .= '<br /><br /><i>' . sprintf(
					/* translators: 1: settings URL, 2: settings text */
					__( 'To properly rebuild Analytics posts in secondary languages, please disable the %1$s when using a different domain per language.', 'seo-by-rank-math' ),
					'<a href="' . esc_url( admin_url( 'admin.php?page=sitepress-multilingual-cms/menu/languages.php#lang-sec-8' ) ) . '">' . __( 'Make themes work multilingual option in WPML settings', 'seo-by-rank-math' ) . '</a>'
				) . '</i>';
			}

Arr::insert(
				$tools,
				[
					'analytics_reindex_posts' => [
						'title'       => __( 'Rebuild Index for Analytics', 'seo-by-rank-math' ),
						'description' => $description,
						'button_text' => __( 'Rebuild Index', 'seo-by-rank-math' ),
					],
				],
				3
			);
		}

/**
		 * Filters the list of tools available on the Database Tools page.
		 *
		 * @param array $tools The tools.
		 */
		$tools = apply_filters( 'rank_math/database/tools', $tools );

return $tools;
	}
}