=' );
} else {
// If `$latest_install` is not set, Elementor was never installed on this site.
$is_new_install = true;
}
if ( $already_had_onboarding || ! $is_new_install ) {
return;
}
wp_safe_redirect( admin_url( 'admin.php?page=elementor-app#onboarding' ) );
exit;
}
private function register_packages() {
$assets_config_provider = ( new Assets_Config_Provider() )
->set_path_resolver( function ( $name ) {
return ELEMENTOR_ASSETS_PATH . "js/packages/{$name}/{$name}.asset.php";
} );
Collection::make( [ 'ui', 'icons', 'query' ] )
->each( function( $package ) use ( $assets_config_provider ) {
$suffix = Utils::is_script_debug() ? '' : '.min';
$config = $assets_config_provider->load( $package )->get( $package );
if ( ! $config ) {
return;
}
wp_register_script(
$config['handle'],
ELEMENTOR_ASSETS_URL . "js/packages/{$package}/{$package}{$suffix}.js",
$config['deps'],
ELEMENTOR_VERSION,
true
);
} );
}
/**
* Enqueue admin scripts.
*
* Registers all the admin scripts and enqueues them.
*
* Fired by `admin_enqueue_scripts` action.
*
* @since 1.0.0
* @access public
*/
public function enqueue_scripts() {
wp_register_script(
'elementor-admin-modules',
$this->get_js_assets_url( 'admin-modules' ),
[],
ELEMENTOR_VERSION,
true
);
$this->register_packages();
// Temporary solution for the admin.
wp_register_script(
'elementor-ai-admin',
$this->get_js_assets_url( 'ai-admin' ),
[
'elementor-common',
'elementor-v2-ui',
'elementor-v2-icons',
],
ELEMENTOR_VERSION,
true
);
wp_register_script(
'elementor-admin',
$this->get_js_assets_url( 'admin' ),
[
'elementor-common',
'elementor-admin-modules',
],
ELEMENTOR_VERSION,
true
);
wp_enqueue_script( 'elementor-admin' );
wp_set_script_translations( 'elementor-admin', 'elementor' );
$this->maybe_enqueue_hints();
$this->print_config();
}
/**
* Enqueue admin styles.
*
* Registers all the admin styles and enqueues them.
*
* Fired by `admin_enqueue_scripts` action.
*
* @since 1.0.0
* @access public
*/
public function enqueue_styles() {
$direction_suffix = is_rtl() ? '-rtl' : '';
wp_register_style(
'elementor-admin',
$this->get_css_assets_url( 'admin' . $direction_suffix ),
[
'elementor-common',
],
ELEMENTOR_VERSION
);
wp_enqueue_style( 'elementor-admin' );
// It's for upgrade notice.
// TODO: enqueue this just if needed.
add_thickbox();
}
/**
* Print switch mode button.
*
* Adds a switch button in post edit screen (which has cpt support). To allow
* the user to switch from the native WordPress editor to Elementor builder.
*
* Fired by `edit_form_after_title` action.
*
* @since 1.0.0
* @access public
*
* @param \WP_Post $post The current post object.
*/
public function print_switch_mode_button( $post ) {
// Exit if Gutenberg are active.
if ( did_action( 'enqueue_block_editor_assets' ) ) {
return;
}
$document = Plugin::$instance->documents->get( $post->ID );
if ( ! $document || ! $document->is_editable_by_current_user() ) {
return;
}
wp_nonce_field( basename( __FILE__ ), '_elementor_edit_mode_nonce' );
?>
documents->get( $post_id )->set_is_built_with_elementor( ! empty( $_POST['_elementor_post_mode'] ) );
}
/**
* Add Elementor post state.
*
* Adds a new "Elementor" post state to the post table.
*
* Fired by `display_post_states` filter.
*
* @since 1.8.0
* @access public
*
* @param array $post_states An array of post display states.
* @param \WP_Post $post The current post object.
*
* @return array A filtered array of post display states.
*/
public function add_elementor_post_state( $post_states, $post ) {
$document = Plugin::$instance->documents->get( $post->ID );
if ( $document && $document->is_built_with_elementor() && $document->is_editable_by_current_user() ) {
$post_states['elementor'] = esc_html__( 'Elementor', 'elementor' );
}
return $post_states;
}
/**
* Body status classes.
*
* Adds CSS classes to the admin body tag.
*
* Fired by `admin_body_class` filter.
*
* @since 1.0.0
* @access public
*
* @param string $classes Space-separated list of CSS classes.
*
* @return string Space-separated list of CSS classes.
*/
public function body_status_classes( $classes ) {
global $pagenow;
if ( in_array( $pagenow, [ 'post.php', 'post-new.php' ], true ) && Utils::is_post_support() ) {
$post = get_post();
$document = Plugin::$instance->documents->get( $post->ID );
$mode_class = $document && $document->is_built_with_elementor() ? 'elementor-editor-active' : 'elementor-editor-inactive';
$classes .= ' ' . $mode_class;
}
return $classes;
}
/**
* Plugin action links.
*
* Adds action links to the plugin list table
*
* Fired by `plugin_action_links` filter.
*
* @since 1.0.0
* @access public
*
* @param array $links An array of plugin action links.
*
* @return array An array of plugin action links.
*/
public function plugin_action_links( $links ) {
$settings_link = sprintf( '%2$s', admin_url( 'admin.php?page=' . Settings::PAGE_ID ), esc_html__( 'Settings', 'elementor' ) );
array_unshift( $links, $settings_link );
$go_pro_text = esc_html__( 'Get Elementor Pro', 'elementor' );
if ( Utils::is_sale_time() ) {
$go_pro_text = esc_html__( 'Discounted Upgrades Now!', 'elementor' );
}
$links['go_pro'] = sprintf( '%2$s', 'https://go.elementor.com/go-pro-wp-plugins/', $go_pro_text );
return $links;
}
/**
* Plugin row meta.
*
* Adds row meta links to the plugin list table
*
* Fired by `plugin_row_meta` filter.
*
* @since 1.1.4
* @access public
*
* @param array $plugin_meta An array of the plugin's metadata, including
* the version, author, author URI, and plugin URI.
* @param string $plugin_file Path to the plugin file, relative to the plugins
* directory.
*
* @return array An array of plugin row meta links.
*/
public function plugin_row_meta( $plugin_meta, $plugin_file ) {
if ( ELEMENTOR_PLUGIN_BASE === $plugin_file ) {
$row_meta = [
'docs' => '' . esc_html__( 'Docs & FAQs', 'elementor' ) . '',
'ideo' => '' . esc_html__( 'Video Tutorials', 'elementor' ) . '',
];
$plugin_meta = array_merge( $plugin_meta, $row_meta );
}
return $plugin_meta;
}
/**
* Admin footer text.
*
* Modifies the "Thank you" text displayed in the admin footer.
*
* Fired by `admin_footer_text` filter.
*
* @since 1.0.0
* @access public
*
* @param string $footer_text The content that will be printed.
*
* @return string The content that will be printed.
*/
public function admin_footer_text( $footer_text ) {
$current_screen = get_current_screen();
$is_elementor_screen = ( $current_screen && false !== strpos( $current_screen->id, 'elementor' ) );
if ( $is_elementor_screen ) {
$footer_text = sprintf(
/* translators: 1: Elementor, 2: Link to plugin review */
__( 'Enjoyed %1$s? Please leave us a %2$s rating. We really appreciate your support!', 'elementor' ),
'' . esc_html__( 'Elementor', 'elementor' ) . '',
'★★★★★'
);
}
return $footer_text;
}
/**
* Register dashboard widgets.
*
* Adds a new Elementor widgets to WordPress dashboard.
*
* Fired by `wp_dashboard_setup` action.
*
* @since 1.9.0
* @access public
*/
public function register_dashboard_widgets() {
wp_add_dashboard_widget( 'e-dashboard-overview', esc_html__( 'Elementor Overview', 'elementor' ), [ $this, 'elementor_dashboard_overview_widget' ] );
// Move our widget to top.
global $wp_meta_boxes;
$dashboard = $wp_meta_boxes['dashboard']['normal']['core'];
$ours = [
'e-dashboard-overview' => $dashboard['e-dashboard-overview'],
];
$wp_meta_boxes['dashboard']['normal']['core'] = array_merge( $ours, $dashboard ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
}
/**
* Displays the Elementor dashboard widget.
*
* Fired by `wp_add_dashboard_widget` function.
*
* @since 1.9.0
* @access public
*/
public function elementor_dashboard_overview_widget() {
?>
have_posts() ) { ?>
have_posts() ) {
$recently_edited_query->the_post();
$document = Plugin::$instance->documents->get( get_the_ID() );
$date = date_i18n( _x( 'M jS', 'Dashboard Overview Widget Recently Date', 'elementor' ), get_the_modified_time( 'U' ) );
?>
-
,
0 ) {
$elementor_feed = array_slice( $elementor_feed, 0, $limit_feed );
}
if ( ! empty( $elementor_feed ) ) { ?>
[
'title' => esc_html__( 'Blog', 'elementor' ),
'link' => 'https://go.elementor.com/overview-widget-blog/',
],
'help' => [
'title' => esc_html__( 'Help', 'elementor' ),
'link' => 'https://go.elementor.com/overview-widget-docs/',
],
];
$additions_actions = [];
if ( User::get_introduction_meta( 'ai_get_started' ) ) {
$additions_actions['ai-library'] = [
'title' => esc_html__( 'AI Prompts Library', 'elementor' ),
'link' => 'https://go.elementor.com/overview-ai-prompts-library/',
];
} else {
$additions_actions['ai'] = [
'title' => esc_html__( 'Build Smart with AI', 'elementor' ),
'link' => 'https://go.elementor.com/overview-widget-ai/',
];
}
$additions_actions['go-pro'] = [
'title' => esc_html__( 'Upgrade', 'elementor' ),
'link' => 'https://go.elementor.com/go-pro-wp-overview-widget/',
];
/**
* Dashboard widget footer actions.
*
* Filters the additions actions displayed in Elementor dashboard widget.
*
* Developers can add new action links to Elementor dashboard widget
* footer using this filter.
*
* @since 1.9.0
*
* @param array $additions_actions Elementor dashboard widget footer actions.
*/
$additions_actions = apply_filters( 'elementor/admin/dashboard_overview_widget/footer_actions', $additions_actions );
$actions = $base_actions + $additions_actions;
return $actions;
}
/**
* Get elementor dashboard overview widget footer actions.
*
* Retrieves the footer action links displayed in elementor dashboard widget.
*
* @since 1.9.0
* @access private
*/
private function get_dashboard_overview_widget_footer_actions() {
return self::static_get_dashboard_overview_widget_footer_actions();
}
/**
* Admin action new post.
*
* When a new post action is fired the title is set to 'Elementor' and the post ID.
*
* Fired by `admin_action_elementor_new_post` action.
*
* @since 1.9.0
* @access public
*/
public function admin_action_new_post() {
check_admin_referer( 'elementor_action_new_post' );
$post_type = Utils::get_super_global_value( $_GET, 'post_type' ) ?? 'post';
if ( ! User::is_current_user_can_edit_post_type( $post_type ) ) {
return;
}
if ( empty( $_GET['template_type'] ) ) {
$type = 'post';
} else {
$type = sanitize_text_field( wp_unslash( $_GET['template_type'] ) );
}
$post_data = Utils::get_super_global_value( $_GET, 'post_data' ) ?? [];
$post_data = $this->filter_post_data( $post_data );
/**
* Create new post meta data.
*
* Filters the meta data of any new post created.
*
* @since 2.0.0
*
* @param array $meta Post meta data.
*/
$meta = [];
if ( isset( $_GET['meta'] ) && is_array( $_GET['meta'] ) ) {
$meta = array_map( 'sanitize_text_field', wp_unslash( $_GET['meta'] ) );
}
$meta = apply_filters( 'elementor/admin/create_new_post/meta', $meta );
$post_data['post_type'] = $post_type;
$document = Plugin::$instance->documents->create( $type, $post_data, $meta );
if ( is_wp_error( $document ) ) {
wp_die( $document ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
wp_redirect( $document->get_edit_url() );
die;
}
private function get_allowed_fields_for_role() {
$allowed_fields = array(
'post_title',
'post_content',
'post_excerpt',
'post_category',
'post_type',
'tags_input',
);
if ( current_user_can( 'publish_posts' ) ) {
$allowed_fields[] = 'post_status';
}
if ( current_user_can( 'edit_others_posts' ) ) {
$allowed_fields[] = 'post_author';
}
return $allowed_fields;
}
private function filter_post_data( $post_data ) {
$allowed_fields = $this->get_allowed_fields_for_role();
return array_filter(
$post_data,
function( $key ) use ( $allowed_fields ) {
return in_array( $key, $allowed_fields, true );
},
ARRAY_FILTER_USE_KEY
);
}
/**
* @since 2.3.0
* @access public
*/
public function add_new_template_template() {
Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/new-template.php' );
}
public function add_new_floating_elements_template() {
Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/new-floating-elements.php' );
}
public function enqueue_new_floating_elements_scripts() {
$suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
wp_enqueue_script(
'elementor-floating-elements-modal',
ELEMENTOR_ASSETS_URL . 'js/floating-elements-modal' . $suffix . '.js',
[],
ELEMENTOR_VERSION,
true
);
wp_set_script_translations( 'elementor-floating-elements-modal', 'elementor' );
}
/**
* @access public
*/
public function enqueue_new_template_scripts() {
$suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
wp_enqueue_script(
'elementor-new-template',
ELEMENTOR_ASSETS_URL . 'js/new-template' . $suffix . '.js',
[],
ELEMENTOR_VERSION,
true
);
wp_set_script_translations( 'elementor-new-template', 'elementor' );
}
/**
* @since 2.6.0
* @access public
*/
public function add_beta_tester_template() {
Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/beta-tester.php' );
}
/**
* @access public
*/
public function enqueue_beta_tester_scripts() {
$suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
wp_enqueue_script(
'elementor-beta-tester',
ELEMENTOR_ASSETS_URL . 'js/beta-tester' . $suffix . '.js',
[],
ELEMENTOR_VERSION,
true
);
wp_set_script_translations( 'elementor-beta-tester', 'elementor' );
}
public function init_floating_elements() {
$screens = [
'elementor_library_page_e-floating-buttons' => true,
'edit-e-floating-buttons' => true,
];
if ( ! isset( $screens[ get_current_screen()->id ] ) ) {
return;
}
add_action( 'admin_head', [ $this, 'add_new_floating_elements_template' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_new_floating_elements_scripts' ] );
}
/**
* @access public
*/
public function init_new_template() {
if ( 'edit-elementor_library' !== get_current_screen()->id ) {
return;
}
// Allow plugins to add their templates on admin_head.
add_action( 'admin_head', [ $this, 'add_new_template_template' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_new_template_scripts' ] );
}
public function version_update_warning( $current_version, $new_version ) {
$current_version_minor_part = explode( '.', $current_version )[1];
$new_version_minor_part = explode( '.', $new_version )[1];
if ( $current_version_minor_part === $new_version_minor_part ) {
return;
}
?>
base ) || 'elementor_page_elementor-tools' === $current_screen->id ) {
add_action( 'admin_head', [ $this, 'add_beta_tester_template' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_beta_tester_scripts' ] );
}
}
/**
* Admin constructor.
*
* Initializing Elementor in WordPress admin.
*
* @since 1.0.0
* @access public
*/
public function __construct() {
Plugin::$instance->init_common();
$this->add_component( 'feedback', new Feedback() );
$this->add_component( 'admin-notices', new Admin_Notices() );
add_action( 'admin_init', [ $this, 'maybe_redirect_to_getting_started' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_scripts' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_styles' ] );
add_action( 'edit_form_after_title', [ $this, 'print_switch_mode_button' ] );
add_action( 'save_post', [ $this, 'save_post' ] );
add_filter( 'display_post_states', [ $this, 'add_elementor_post_state' ], 10, 2 );
add_filter( 'plugin_action_links_' . ELEMENTOR_PLUGIN_BASE, [ $this, 'plugin_action_links' ] );
add_filter( 'plugin_row_meta', [ $this, 'plugin_row_meta' ], 10, 2 );
add_filter( 'admin_body_class', [ $this, 'body_status_classes' ] );
add_filter( 'admin_footer_text', [ $this, 'admin_footer_text' ] );
// Register Dashboard Widgets.
add_action( 'wp_dashboard_setup', [ $this, 'register_dashboard_widgets' ] );
// Admin Actions
add_action( 'admin_action_elementor_new_post', [ $this, 'admin_action_new_post' ] );
add_action( 'current_screen', [ $this, 'init_new_template' ] );
add_action( 'current_screen', [ $this, 'init_floating_elements' ] );
add_action( 'current_screen', [ $this, 'init_beta_tester' ] );
add_action( 'in_plugin_update_message-' . ELEMENTOR_PLUGIN_BASE, function( $plugin_data ) {
$this->version_update_warning( ELEMENTOR_VERSION, $plugin_data['new_version'] );
} );
add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_hints' ] );
}
/**
* @since 2.3.0
* @access protected
*/
protected function get_init_settings() {
$beta_tester_email = get_user_meta( get_current_user_id(), User::BETA_TESTER_META_KEY, true );
$elementor_beta = get_option( 'elementor_beta', 'no' );
$all_introductions = User::get_introduction_meta();
$beta_tester_signup_dismissed = array_key_exists( Beta_Testers::BETA_TESTER_SIGNUP, $all_introductions );
$settings = [
'home_url' => home_url(),
'settings_url' => Settings::get_url(),
'user' => [
'introduction' => User::get_introduction_meta(),
'restrictions' => Plugin::$instance->role_manager->get_user_restrictions_array(),
'is_administrator' => current_user_can( 'manage_options' ),
],
'beta_tester' => [
'beta_tester_signup' => Beta_Testers::BETA_TESTER_SIGNUP,
'has_email' => $beta_tester_email,
'option_enabled' => 'no' !== $elementor_beta,
'signup_dismissed' => $beta_tester_signup_dismissed,
],
'experiments' => $this->get_experiments(),
];
/**
* Localize settings.
*
* Filters the initial localize settings in the admin.
*
* WordPress has it's own way to pass localized data from PHP (backend) to
* JS (frontend). Elementor uses this method to pass localize data in the
* admin. This hook can be used to add more localized settings in addition
* to the initial Elementor settings.
*
* @since 2.3.0
*
* @param array $settings Initial localize settings.
*/
$settings = apply_filters( 'elementor/admin/localize_settings', $settings );
return $settings;
}
private function get_experiments() {
return ( new Collection( Plugin::$instance->experiments->get_features() ) )
->map( function ( $experiment_data ) {
$dependencies = $experiment_data['dependencies'] ?? [];
$dependencies = ( new Collection( $dependencies ) )
->map( function ( $dependency ) {
return $dependency->get_name();
} )->all();
return [
'name' => $experiment_data['name'],
'title' => $experiment_data['title'] ?? $experiment_data['name'],
'state' => $experiment_data['state'],
'default' => $experiment_data['default'],
'dependencies' => $dependencies,
'messages' => $experiment_data['messages'] ?? [],
];
} )->all();
}
private function maybe_enqueue_hints() {
if ( ! Hints::should_display_hint( 'image-optimization' ) ) {
return;
}
wp_register_script(
'media-hints',
$this->get_js_assets_url( 'media-hints' ),
[],
ELEMENTOR_VERSION,
true
);
$content = sprintf("%1\$s %3\$s!",
__( 'Optimize your images to enhance site performance by using Image Optimizer.', 'elementor' ),
Hints::get_plugin_action_url( 'image-optimization' ),
( Hints::is_plugin_installed( 'image-optimization' ) ? __( 'Activate', 'elementor' ) : __( 'Install', 'elementor' ) ) . ' ' . __( 'Image Optimizer', 'elementor' )
);
$dismissible = 'image_optimizer_hint';
wp_localize_script( 'media-hints', 'elementorAdminHints', [
'mediaHint' => [
'display' => true,
'type' => 'info',
'content' => $content,
'icon' => true,
'dismissible' => $dismissible,
'dismiss' => __( 'Dismiss this notice.', 'elementor' ),
'button_event' => $dismissible,
'button_data' => base64_encode(
json_encode( [
'action_url' => Hints::get_plugin_action_url( 'image-optimization' ),
] ),
),
],
] );
wp_enqueue_script( 'media-hints' );
}
public function register_ajax_hints( $ajax_manager ) {
$ajax_manager->register_ajax_action( 'elementor_image_optimization_campaign', [ $this, 'ajax_set_image_optimization_campaign' ] );
$ajax_manager->register_ajax_action( 'elementor_core_site_mailer_campaign', [ $this, 'ajax_site_mailer_campaign' ] );
}
public function ajax_set_image_optimization_campaign( $request ) {
if ( ! current_user_can( 'install_plugins' ) ) {
return;
}
if ( empty( $request['source'] ) ) {
return;
}
$campaign_data = [
'source' => sanitize_key( $request['source'] ),
'campaign' => 'io-plg',
'medium' => 'wp-dash',
];
set_transient( 'elementor_image_optimization_campaign', $campaign_data, 30 * DAY_IN_SECONDS );
}
public function ajax_site_mailer_campaign( $request ) {
if ( ! current_user_can( 'install_plugins' ) ) {
return;
}
if ( empty( $request['source'] ) ) {
return;
}
$campaign_data = [
'source' => sanitize_key( $request['source'] ),
'campaign' => 'sm-plg',
'medium' => 'wp-dash',
];
set_transient( 'elementor_site_mailer_campaign', $campaign_data, 30 * DAY_IN_SECONDS );
}
}