| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295 |
- <?php
- namespace Elementor;
- if ( ! defined( 'ABSPATH' ) ) {
- exit; // Exit if accessed directly.
- }
- /**
- * Elementor "Tools" page in WordPress Dashboard.
- *
- * Elementor settings page handler class responsible for creating and displaying
- * Elementor "Tools" page in WordPress dashboard.
- *
- * @since 1.0.0
- */
- class Tools extends Settings_Page {
- /**
- * Settings page ID for Elementor tools.
- */
- const PAGE_ID = 'elementor-tools';
- /**
- * Register admin menu.
- *
- * Add new Elementor Tools admin menu.
- *
- * Fired by `admin_menu` action.
- *
- * @since 1.0.0
- * @access public
- */
- public function register_admin_menu() {
- add_submenu_page(
- Settings::PAGE_ID,
- __( 'Tools', 'elementor' ),
- __( 'Tools', 'elementor' ),
- 'manage_options',
- self::PAGE_ID,
- [ $this, 'display_settings_page' ]
- );
- }
- /**
- * Clear cache.
- *
- * Delete post meta containing the post CSS file data. And delete the actual
- * CSS files from the upload directory.
- *
- * Fired by `wp_ajax_elementor_clear_cache` action.
- *
- * @since 1.0.0
- * @access public
- */
- public function ajax_elementor_clear_cache() {
- check_ajax_referer( 'elementor_clear_cache', '_nonce' );
- Plugin::$instance->files_manager->clear_cache();
- wp_send_json_success();
- }
- /**
- * Replace URLs.
- *
- * Sends an ajax request to replace old URLs to new URLs. This method also
- * updates all the Elementor data.
- *
- * Fired by `wp_ajax_elementor_replace_url` action.
- *
- * @since 1.1.0
- * @access public
- */
- public function ajax_elementor_replace_url() {
- check_ajax_referer( 'elementor_replace_url', '_nonce' );
- $from = ! empty( $_POST['from'] ) ? $_POST['from'] : '';
- $to = ! empty( $_POST['to'] ) ? $_POST['to'] : '';
- try {
- $results = Utils::replace_urls( $from, $to );
- wp_send_json_success( $results );
- } catch ( \Exception $e ) {
- wp_send_json_error( $e->getMessage() );
- }
- }
- /**
- * Elementor version rollback.
- *
- * Rollback to previous Elementor version.
- *
- * Fired by `admin_post_elementor_rollback` action.
- *
- * @since 1.5.0
- * @access public
- */
- public function post_elementor_rollback() {
- check_admin_referer( 'elementor_rollback' );
- $plugin_slug = basename( ELEMENTOR__FILE__, '.php' );
- $rollback = new Rollback(
- [
- 'version' => ELEMENTOR_PREVIOUS_STABLE_VERSION,
- 'plugin_name' => ELEMENTOR_PLUGIN_BASE,
- 'plugin_slug' => $plugin_slug,
- 'package_url' => sprintf( 'https://downloads.wordpress.org/plugin/%s.%s.zip', $plugin_slug, ELEMENTOR_PREVIOUS_STABLE_VERSION ),
- ]
- );
- $rollback->run();
- wp_die(
- '', __( 'Rollback to Previous Version', 'elementor' ), [
- 'response' => 200,
- ]
- );
- }
- /**
- * Tools page constructor.
- *
- * Initializing Elementor "Tools" page.
- *
- * @since 1.0.0
- * @access public
- */
- public function __construct() {
- parent::__construct();
- add_action( 'admin_menu', [ $this, 'register_admin_menu' ], 205 );
- if ( ! empty( $_POST ) ) {
- add_action( 'wp_ajax_elementor_clear_cache', [ $this, 'ajax_elementor_clear_cache' ] );
- add_action( 'wp_ajax_elementor_replace_url', [ $this, 'ajax_elementor_replace_url' ] );
- }
- add_action( 'admin_post_elementor_rollback', [ $this, 'post_elementor_rollback' ] );
- }
- /**
- * Create tabs.
- *
- * Return the tools page tabs, sections and fields.
- *
- * @since 1.5.0
- * @access protected
- *
- * @return array An array with the page tabs, sections and fields.
- */
- protected function create_tabs() {
- return [
- 'general' => [
- 'label' => __( 'General', 'elementor' ),
- 'sections' => [
- 'tools' => [
- 'fields' => [
- 'clear_cache' => [
- 'label' => __( 'Regenerate CSS', 'elementor' ),
- 'field_args' => [
- 'type' => 'raw_html',
- 'html' => sprintf( '<button data-nonce="%s" class="button elementor-button-spinner" id="elementor-clear-cache-button">%s</button>', wp_create_nonce( 'elementor_clear_cache' ), __( 'Regenerate Files', 'elementor' ) ),
- 'desc' => __( 'Styles set in Elementor are saved in CSS files in the uploads folder. Recreate those files, according to the most recent settings.', 'elementor' ),
- ],
- ],
- 'reset_api_data' => [
- 'label' => __( 'Sync Library', 'elementor' ),
- 'field_args' => [
- 'type' => 'raw_html',
- 'html' => sprintf( '<button data-nonce="%s" class="button elementor-button-spinner" id="elementor-library-sync-button">%s</button>', wp_create_nonce( 'elementor_reset_library' ), __( 'Sync Library', 'elementor' ) ),
- 'desc' => __( 'Elementor Library automatically updates on a daily basis. You can also manually update it by clicking on the sync button.', 'elementor' ),
- ],
- ],
- ],
- ],
- ],
- ],
- 'replace_url' => [
- 'label' => __( 'Replace URL', 'elementor' ),
- 'sections' => [
- 'replace_url' => [
- 'callback' => function() {
- $intro_text = sprintf(
- /* translators: %s: Codex URL */
- __( '<strong>Important:</strong> It is strongly recommended that you <a target="_blank" href="%s">backup your database</a> before using Replace URL.', 'elementor' ),
- 'https://codex.wordpress.org/WordPress_Backups'
- );
- $intro_text = '<div>' . $intro_text . '</div>';
- echo $intro_text;
- },
- 'fields' => [
- 'replace_url' => [
- 'label' => __( 'Update Site Address (URL)', 'elementor' ),
- 'field_args' => [
- 'type' => 'raw_html',
- 'html' => sprintf( '<input type="text" name="from" placeholder="http://old-url.com" class="medium-text"><input type="text" name="to" placeholder="http://new-url.com" class="medium-text"><button data-nonce="%s" class="button elementor-button-spinner" id="elementor-replace-url-button">%s</button>', wp_create_nonce( 'elementor_replace_url' ), __( 'Replace URL', 'elementor' ) ),
- 'desc' => __( 'Enter your old and new URLs for your WordPress installation, to update all Elementor data (Relevant for domain transfers or move to \'HTTPS\').', 'elementor' ),
- ],
- ],
- ],
- ],
- ],
- ],
- 'versions' => [
- 'label' => __( 'Version Control', 'elementor' ),
- 'sections' => [
- 'rollback' => [
- 'label' => __( 'Rollback to Previous Version', 'elementor' ),
- 'callback' => function() {
- $intro_text = sprintf(
- /* translators: %s: Elementor version */
- __( 'Experiencing an issue with Elementor version %s? Rollback to a previous version before the issue appeared.', 'elementor' ),
- ELEMENTOR_VERSION
- );
- $intro_text = '<p>' . $intro_text . '</p>';
- echo $intro_text;
- },
- 'fields' => [
- 'rollback' => [
- 'label' => __( 'Rollback Version', 'elementor' ),
- 'field_args' => [
- 'type' => 'raw_html',
- 'html' => sprintf(
- '<a href="%s" class="button elementor-button-spinner elementor-rollback-button">%s</a>',
- wp_nonce_url( admin_url( 'admin-post.php?action=elementor_rollback' ), 'elementor_rollback' ),
- sprintf(
- /* translators: %s: Elementor previous stable version */
- __( 'Reinstall v%s', 'elementor' ),
- ELEMENTOR_PREVIOUS_STABLE_VERSION
- )
- ),
- 'desc' => '<span style="color: red;">' . __( 'Warning: Please backup your database before making the rollback.', 'elementor' ) . '</span>',
- ],
- ],
- ],
- ],
- 'beta' => [
- 'label' => __( 'Become a Beta Tester', 'elementor' ),
- 'callback' => function() {
- $intro_text = __( 'Turn-on Beta Tester, to get notified when a new beta version of Elementor or E-Pro is available. The Beta version will not install automatically. You always have the option to ignore it.', 'elementor' );
- $intro_text = '<p>' . $intro_text . '</p>';
- echo $intro_text;
- },
- 'fields' => [
- 'beta' => [
- 'label' => __( 'Beta Tester', 'elementor' ),
- 'field_args' => [
- 'type' => 'select',
- 'default' => 'no',
- 'options' => [
- 'no' => __( 'Disable', 'elementor' ),
- 'yes' => __( 'Enable', 'elementor' ),
- ],
- 'desc' => '<span style="color: red;">' . __( 'Please Note: We do not recommend updating to a beta version on production sites.', 'elementor' ) . '</span>',
- ],
- ],
- ],
- ],
- ],
- ],
- ];
- }
- /**
- * Display settings page.
- *
- * Output the content for the settings page.
- *
- * @since 1.5.2
- * @access public
- */
- public function display_settings_page() {
- wp_enqueue_script( 'elementor-dialog' );
- parent::display_settings_page();
- }
- /**
- * Get tools page title.
- *
- * Retrieve the title for the tools page.
- *
- * @since 1.5.0
- * @access protected
- *
- * @return string Tools page title.
- */
- protected function get_page_title() {
- return __( 'Tools', 'elementor' );
- }
- }
|