* @copyright 2007-2022 Leotheme
* @license http://leotheme.com - prestashop template provider
*/
namespace LeoElements;
use LeoElements\Leo_Helper;
if ( ! defined( '_PS_VERSION_' ) ) {
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,
Leo_Helper::__( 'Tools', 'elementor' ),
Leo_Helper::__( '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() {
$post = $GLOBALS['_POST'];
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( LEOELEMENTS__FILE__, '.php' );
$rollback = new Rollback(
[
'version' => LEOELEMENTS_PREVIOUS_STABLE_VERSION,
'plugin_name' => LEOELEMENTS_PLUGIN_BASE,
'plugin_slug' => $plugin_slug,
'package_url' => sprintf( 'https://downloads.wordpress.org/plugin/%s.%s.zip', $plugin_slug, LEOELEMENTS_PREVIOUS_STABLE_VERSION ),
]
);
$rollback->run();
wp_die(
'', Leo_Helper::__( '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();
Leo_Helper::add_action( 'admin_menu', [ $this, 'register_admin_menu' ], 205 );
$post = $GLOBALS['_POST'];
if ( ! empty( $post ) ) {
Leo_Helper::add_action( 'wp_ajax_elementor_clear_cache', [ $this, 'ajax_elementor_clear_cache' ] );
Leo_Helper::add_action( 'wp_ajax_elementor_replace_url', [ $this, 'ajax_elementor_replace_url' ] );
}
Leo_Helper::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' => Leo_Helper::__( 'General', 'elementor' ),
'sections' => [
'tools' => [
'fields' => [
'clear_cache' => [
'label' => Leo_Helper::__( 'Regenerate CSS', 'elementor' ),
'field_args' => [
'type' => 'raw_html',
'html' => sprintf( '', wp_create_nonce( 'elementor_clear_cache' ), Leo_Helper::__( 'Regenerate Files', 'elementor' ) ),
'desc' => Leo_Helper::__( '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' => Leo_Helper::__( 'Sync Library', 'elementor' ),
'field_args' => [
'type' => 'raw_html',
'html' => sprintf( '', wp_create_nonce( 'elementor_reset_library' ), Leo_Helper::__( 'Sync Library', 'elementor' ) ),
'desc' => Leo_Helper::__( 'Elementor Library automatically updates on a daily basis. You can also manually update it by clicking on the sync button.', 'elementor' ),
],
],
],
],
],
],
'replace_url' => [
'label' => Leo_Helper::__( 'Replace URL', 'elementor' ),
'sections' => [
'replace_url' => [
'callback' => function() {
$intro_text = sprintf(
/* translators: %s: Codex URL */
Leo_Helper::__( 'Important: It is strongly recommended that you backup your database before using Replace URL.', 'elementor' ),
'https://codex.wordpress.org/WordPress_Backups'
);
$intro_text = '' . $intro_text . '
';
echo '' . Leo_Helper::esc_html__( 'Replace URL', 'elementor' ) . '
';
echo $intro_text;
},
'fields' => [
'replace_url' => [
'label' => Leo_Helper::__( 'Update Site Address (URL)', 'elementor' ),
'field_args' => [
'type' => 'raw_html',
'html' => sprintf( '', wp_create_nonce( 'elementor_replace_url' ), Leo_Helper::__( 'Replace URL', 'elementor' ) ),
'desc' => Leo_Helper::__( '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' => Leo_Helper::__( 'Version Control', 'elementor' ),
'sections' => [
'rollback' => [
'label' => Leo_Helper::__( 'Rollback to Previous Version', 'elementor' ),
'callback' => function() {
$intro_text = sprintf(
/* translators: %s: Elementor version */
Leo_Helper::__( 'Experiencing an issue with Elementor version %s? Rollback to a previous version before the issue appeared.', 'elementor' ),
LEOELEMENTS_VERSION
);
$intro_text = '' . $intro_text . '
';
echo $intro_text;
},
'fields' => [
'rollback' => [
'label' => Leo_Helper::__( 'Rollback Version', 'elementor' ),
'field_args' => [
'type' => 'raw_html',
'html' => sprintf(
'%s',
wp_nonce_url( Leo_Helper::admin_url( 'admin-post.php?action=elementor_rollback' ), 'elementor_rollback' ),
sprintf(
/* translators: %s: Elementor previous stable version */
Leo_Helper::__( 'Reinstall v%s', 'elementor' ),
LEOELEMENTS_PREVIOUS_STABLE_VERSION
)
),
'desc' => '' . Leo_Helper::__( 'Warning: Please backup your database before making the rollback.', 'elementor' ) . '',
],
],
],
],
'beta' => [
'label' => Leo_Helper::__( 'Become a Beta Tester', 'elementor' ),
'callback' => function() {
$intro_text = Leo_Helper::__( '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 = '' . $intro_text . '
';
$newsletter_opt_in_text = sprintf( Leo_Helper::__( 'Click here to join our First-To-Know email updates', 'elementor' ), '#' );
echo $intro_text;
echo $newsletter_opt_in_text;
},
'fields' => [
'beta' => [
'label' => Leo_Helper::__( 'Beta Tester', 'elementor' ),
'field_args' => [
'type' => 'select',
'default' => 'no',
'options' => [
'no' => Leo_Helper::__( 'Disable', 'elementor' ),
'yes' => Leo_Helper::__( 'Enable', 'elementor' ),
],
'desc' => '' . Leo_Helper::__( 'Please Note: We do not recommend updating to a beta version on production sites.', 'elementor' ) . '',
],
],
],
],
],
],
];
}
/**
* 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 Leo_Helper::__( 'Tools', 'elementor' );
}
}