namespace Elementor\Modules\SafeMode;
use Elementor\TemplateLibrary\Source_Local;
use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
class Module extends \Elementor\Core\Base\Module {
const OPTION_ENABLED = 'elementor_safe_mode';
const OPTION_TOKEN = self::OPTION_ENABLED . '_token';
const MU_PLUGIN_FILE_NAME = 'elementor-safe-mode.php';
const DOCS_HELPED_URL = 'https://go.elementor.com/safe-mode-helped/';
const DOCS_DIDNT_HELP_URL = 'https://go.elementor.com/safe-mode-didnt-helped/';
const DOCS_MU_PLUGINS_URL = 'https://go.elementor.com/safe-mode-mu-plugins/';
const DOCS_TRY_SAFE_MODE_URL = 'https://go.elementor.com/safe-mode/';
const EDITOR_NOTICE_TIMEOUT = 30000; /* ms */
public function get_name() {
public function register_ajax_actions( Ajax $ajax ) {
$ajax->register_ajax_action( 'enable_safe_mode', [ $this, 'ajax_enable_safe_mode' ] );
$ajax->register_ajax_action( 'disable_safe_mode', [ $this, 'disable_safe_mode' ] );
* @param Tools $tools_page
public function add_admin_button( $tools_page ) {
$tools_page->add_fields( Settings::TAB_GENERAL, 'tools', [
'label' => esc_html__( 'Safe Mode', 'elementor' ),
'std' => $this->is_enabled() ? 'global' : '',
'' => esc_html__( 'Disable', 'elementor' ),
'global' => esc_html__( 'Enable', 'elementor' ),
'desc' => esc_html__( 'Safe Mode allows you to troubleshoot issues by only loading the editor, without loading the theme or any other plugin.', 'elementor' ),
public function on_update_safe_mode( $value ) {
if ( 'yes' === $value || 'global' === $value ) {
$this->enable_safe_mode();
$this->disable_safe_mode();
* @throws \Exception If the safe mode cannot be enabled.
public function ajax_enable_safe_mode( $data ) {
if ( ! current_user_can( 'install_plugins' ) ) {
throw new \Exception( 'Access denied.' );
// It will run `$this->>update_safe_mode`.
update_option( 'elementor_safe_mode', 'yes' );
$document = Plugin::$instance->documents->get( $data['editor_post_id'] );
return add_query_arg( 'elementor-mode', 'safe', $document->get_edit_url() );
public function enable_safe_mode() {
if ( ! current_user_can( 'install_plugins' ) ) {
$this->update_allowed_plugins();
if ( ! is_dir( WPMU_PLUGIN_DIR ) ) {
wp_mkdir_p( WPMU_PLUGIN_DIR );
add_option( 'elementor_safe_mode_created_mu_dir', true );
if ( ! is_dir( WPMU_PLUGIN_DIR ) ) {
wp_die( esc_html__( 'Cannot enable Safe Mode', 'elementor' ) );
$results = copy_dir( __DIR__ . '/mu-plugin/', WPMU_PLUGIN_DIR );
if ( is_wp_error( $results ) ) {
$token = hash( 'sha256', wp_rand() );
// Only who own this key can use 'elementor-safe-mode'.
update_option( self::OPTION_TOKEN, $token );
setcookie( self::OPTION_TOKEN, $token, time() + HOUR_IN_SECONDS, COOKIEPATH, '', is_ssl(), true );
public function disable_safe_mode() {
if ( ! current_user_can( 'install_plugins' ) ) {
$file_path = WP_CONTENT_DIR . '/mu-plugins/elementor-safe-mode.php';
if ( file_exists( $file_path ) ) {
if ( get_option( 'elementor_safe_mode_created_mu_dir' ) ) {
// It will be removed only if it's empty and don't have other mu-plugins.
@rmdir( WPMU_PLUGIN_DIR );
delete_option( 'elementor_safe_mode' );
delete_option( 'elementor_safe_mode_allowed_plugins' );
delete_option( 'theme_mods_elementor-safe' );
delete_option( 'elementor_safe_mode_created_mu_dir' );
delete_option( self::OPTION_TOKEN );
setcookie( self::OPTION_TOKEN, '', 1, '', '', is_ssl(), true );
public function filter_preview_url( $url ) {
return add_query_arg( 'elementor-mode', 'safe', $url );
public function filter_template() {
return ELEMENTOR_PATH . 'modules/page-templates/templates/canvas.php';
public function print_safe_mode_css() {
.elementor-safe-mode-toast {
z-index: 10000; /* Over the loading layer */
color: var(--e-a-color-txt);
background: var(--e-a-bg-default);
box-shadow: 0 5px 20px rgba(0, 0, 0, 0.15);
font-family: var(--e-a-font-family);
#elementor-try-safe-mode {
.elementor-safe-mode-toast .elementor-toast-content {
.elementor-safe-mode-toast .elementor-toast-content a {
color: var(--e-a-color-info);
.elementor-safe-mode-toast .elementor-toast-content hr {
border-block-start: var(--e-a-border);
.elementor-safe-mode-toast header {
.elementor-safe-mode-toast header i {
color: var(--e-a-color-warning);
.elementor-safe-mode-toast header h2 {
.elementor-safe-mode-list {
.elementor-safe-mode-list-item {
margin-inline-start: 15px;
.elementor-safe-mode-list-item-content {
color: var(--e-a-color-txt);
.elementor-safe-mode-list-item-title {
.elementor-safe-mode-mu-plugins {
background-color: var(--e-a-bg-hover);
color: var(--e-a-color-txt-hover);
margin-block-start: 20px;
public function print_safe_mode_notice() {
$this->print_safe_mode_css()
<div class="elementor-safe-mode-toast" id="elementor-safe-mode-message">
<i class="eicon-warning" aria-hidden="true"></i>
<h2><?php echo esc_html__( 'Safe Mode ON', 'elementor' ); ?></h2>
<a class="elementor-button elementor-safe-mode-button elementor-disable-safe-mode" target="_blank" href="<?php echo esc_url( $this->get_admin_page_url() ); ?>">
<?php echo esc_html__( 'Disable Safe Mode', 'elementor' ); ?>
<div class="elementor-toast-content">
<ul class="elementor-safe-mode-list">
<li class="elementor-safe-mode-list-item">
<div class="elementor-safe-mode-list-item-title"><?php echo esc_html__( 'Editor successfully loaded?', 'elementor' ); ?></div>
<div class="elementor-safe-mode-list-item-content">
echo esc_html__( 'The issue was probably caused by one of your plugins or theme.', 'elementor' );
/* translators: %1$s Link open tag, %2$s: Link close tag. */
esc_html__( '%1$sClick here%2$s to troubleshoot', 'elementor' ),
'<a href="' . self::DOCS_HELPED_URL . '" target="_blank">', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
<li class="elementor-safe-mode-list-item">
<div class="elementor-safe-mode-list-item-title"><?php echo esc_html__( 'Still experiencing issues?', 'elementor' ); ?></div>
<div class="elementor-safe-mode-list-item-content">
/* translators: %1$s Link open tag, %2$s: Link close tag. */
esc_html__( '%1$sClick here%2$s to troubleshoot', 'elementor' ),
'<a href="' . self::DOCS_DIDNT_HELP_URL . '" target="_blank">', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
$mu_plugins = wp_get_mu_plugins();
if ( 1 < count( $mu_plugins ) ) : ?>
<div class="elementor-safe-mode-mu-plugins">
/* translators: %1$s Link open tag, %2$s: Link close tag. */
esc_html__( 'Please note! We couldn\'t deactivate all of your plugins on Safe Mode. Please %1$sread more%2$s about this issue', 'elementor' ),
'<a href="' . self::DOCS_MU_PLUGINS_URL . '" target="_blank">', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
var ElementorSafeMode = function() {
var attachEvents = function() {
jQuery( '.elementor-disable-safe-mode' ).on( 'click', function( e ) {
if ( ! elementorCommon || ! elementorCommon.ajax ) {
elementorCommon.ajax.addRequest(
if ( -1 === location.href.indexOf( 'elementor-mode=safe' ) ) {
// Need to remove the URL from browser history.
location.replace( location.href.replace( '&elementor-mode=safe', '' ) );
alert( 'An error occurred.' );
public function print_try_safe_mode() {
if ( ! $this->is_allowed_post_type() ) {
$this->print_safe_mode_css();
<div class="elementor-safe-mode-toast" id="elementor-try-safe-mode">
<?php if ( current_user_can( 'install_plugins' ) ) : ?>
<i class="eicon-warning" aria-hidden="true"></i>
<h2><?php echo esc_html__( 'Can\'t Edit?', 'elementor' ); ?></h2>
<a class="elementor-button e-primary elementor-safe-mode-button elementor-enable-safe-mode" target="_blank" href="<?php echo esc_url( $this->get_admin_page_url() ); ?>">
<?php echo esc_html__( 'Enable Safe Mode', 'elementor' ); ?>
<div class="elementor-toast-content">
<?php echo esc_html__( 'Having problems loading Elementor? Please enable Safe Mode to troubleshoot.', 'elementor' ); ?>
<a href="<?php Utils::print_unescaped_internal_string( self::DOCS_TRY_SAFE_MODE_URL ); ?>" target="_blank"><?php echo esc_html__( 'Learn More', 'elementor' ); ?></a>
<i class="eicon-warning" aria-hidden="true"></i>
<h2><?php echo esc_html__( 'Can\'t Edit?', 'elementor' ); ?></h2>
<div class="elementor-toast-content">
<?php echo esc_html__( 'If you are experiencing a loading issue, contact your site administrator to troubleshoot the problem using Safe Mode.', 'elementor' ); ?>
<a href="<?php Utils::print_unescaped_internal_string( self::DOCS_TRY_SAFE_MODE_URL ); ?>" target="_blank"><?php echo esc_html__( 'Learn More', 'elementor' ); ?></a>
var ElementorTrySafeMode = function() {
var attachEvents = function() {
jQuery( '.elementor-enable-safe-mode' ).on( 'click', function( e ) {
if ( ! elementorCommon || ! elementorCommon.ajax ) {
elementorCommon.ajax.addRequest(
// PHPCS - the method get_post_id is safe.
echo Plugin::$instance->editor->get_post_id(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
success: function( url ) {
alert( 'An error occurred.' );
var isElementorLoaded = function() {
if ( 'undefined' === typeof elementor ) {
if ( ! elementor.loaded ) {
if ( jQuery( '#elementor-loading' ).is( ':visible' ) ) {
var handleTrySafeModeNotice = function() {
var $notice = jQuery( '#elementor-try-safe-mode' );
if ( isElementorLoaded() ) {
if ( ! $notice.data( 'visible' ) ) {
$notice.attr( 'style', 'display: flex;' );
setTimeout( handleTrySafeModeNotice, 500 );
setTimeout( handleTrySafeModeNotice, <?php Utils::print_unescaped_internal_string( self::EDITOR_NOTICE_TIMEOUT ); ?> );
new ElementorTrySafeMode();
public function run_safe_mode() {
remove_action( 'elementor/editor/footer', [ $this, 'print_try_safe_mode' ] );
// Avoid notices like for comment.php.
add_filter( 'deprecated_file_trigger_error', '__return_false' );
add_filter( 'template_include', [ $this, 'filter_template' ], 999 );
add_filter( 'elementor/document/urls/preview', [ $this, 'filter_preview_url' ] );
add_action( 'elementor/editor/footer', [ $this, 'print_safe_mode_notice' ] );
add_action( 'elementor/editor/before_enqueue_scripts', [ $this, 'register_scripts' ], 11 /* After Common Scripts */ );
public function register_scripts() {
wp_add_inline_script( 'elementor-common', 'elementorCommon.ajax.addRequestConstant( "elementor-mode", "safe" );' );
private function is_enabled() {
return get_option( self::OPTION_ENABLED, '' );
private function get_admin_page_url() {
// A fallback URL if the Js doesn't work.
public function plugin_action_links( $actions ) {
$actions['disable'] = '<a href="' . self::get_admin_page_url() . '">' . esc_html__( 'Disable Safe Mode', 'elementor' ) . '</a>';
public function on_deactivated_plugin( $plugin ) {
if ( ELEMENTOR_PLUGIN_BASE === $plugin ) {
$this->disable_safe_mode();
$allowed_plugins = get_option( 'elementor_safe_mode_allowed_plugins', [] );
$plugin_key = array_search( $plugin, $allowed_plugins, true );
unset( $allowed_plugins[ $plugin_key ] );
update_option( 'elementor_safe_mode_allowed_plugins', $allowed_plugins );
public function update_allowed_plugins() {
'elementor' => ELEMENTOR_PLUGIN_BASE,