PluginProbe
Elementor Website Builder – more than just a page builder / 4.3.0
Elementor Website Builder – more than just a page builder v4.3.0
4.3.0 4.3.0-beta3 4.3.0-beta2 4.3.0-beta1 4.2.4 4.2.3 4.2.2 4.2.1 4.2.0 4.1.5 4.2.0-beta2 4.2.0-dev2 4.2.0-beta1 4.1.4 4.1.3 4.1.2 4.1.1 4.1.0 4.1.0-beta3 4.1.0-dev3 4.0.9 4.1.0-beta2 4.1.0-dev2 4.0.8 4.1.0-beta1 All 453 releases
elementor / core / admin / admin.php

admin.php in Elementor Website Builder – more than just a page builder 4.3.0, at core/admin/admin.php

1,221 lines 36.2 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 namespace Elementor\Core\Admin;
3
4 use Elementor\Api;
5 use Elementor\Beta_Testers;
6 use Elementor\App\Modules\Onboarding\Module as Onboarding_Module;
7 use Elementor\Core\Base\App;
8 use Elementor\Core\Upgrade\Manager as Upgrade_Manager;
9 use Elementor\Core\Utils\Assets_Config_Provider;
10 use Elementor\Core\Utils\Collection;
11 use Elementor\Modules\FloatingButtons\Module as Floating_Buttons_Module;
12 use Elementor\Plugin;
13 use Elementor\Settings;
14 use Elementor\User;
15 use Elementor\Utils;
16 use Elementor\Core\Utils\Hints;
17 use Elementor\Core\DocumentTypes\Page;
18
19 if ( ! defined( 'ABSPATH' ) ) {
20 exit; // Exit if accessed directly.
21 }
22
23 class Admin extends App {
24
25 private $menus = [];
26
27 /**
28 * Get module name.
29 *
30 * Retrieve the module name.
31 *
32 * @since 2.3.0
33 * @access public
34 *
35 * @return string Module name.
36 */
37 public function get_name() {
38 return 'admin';
39 }
40
41 /**
42 * Check if current page is an Elementor admin page.
43 *
44 * @param \WP_Screen|null $current_screen Optional. Screen object to check. Defaults to current screen.
45 *
46 * @return bool Whether current page is an Elementor admin page.
47 */
48 public static function is_elementor_admin_page( $current_screen = null ) {
49 if ( ! $current_screen ) {
50 $current_screen = get_current_screen();
51 }
52
53 if ( ! $current_screen ) {
54 return false;
55 }
56
57 $screen_id = $current_screen->id ?? '';
58 $post_type = $current_screen->post_type ?? '';
59
60 $is_elementor_screen = strpos( $screen_id, 'elementor' ) !== false
61 || strpos( $screen_id, Floating_Buttons_Module::CPT_FLOATING_BUTTONS ) !== false;
62
63 $is_elementor_post_type = strpos( $post_type, 'elementor' ) !== false
64 || strpos( $post_type, Floating_Buttons_Module::CPT_FLOATING_BUTTONS ) !== false;
65
66 return $is_elementor_screen || $is_elementor_post_type;
67 }
68
69 /**
70 * @since 2.2.0
71 * @access public
72 */
73 public function maybe_redirect_to_getting_started() {
74 if ( ! get_transient( 'elementor_activation_redirect' ) ) {
75 return;
76 }
77
78 if ( wp_doing_ajax() ) {
79 return;
80 }
81
82 delete_transient( 'elementor_activation_redirect' );
83
84 if ( is_network_admin() || isset( $_GET['activate-multi'] ) ) {
85 return;
86 }
87
88 $already_had_onboarding = get_option( Onboarding_Module::ONBOARDING_OPTION );
89
90 // Get the latest installation from Elementor's Install log in the DB.
91 $latest_install = key( Upgrade_Manager::get_installs_history() );
92
93 if ( ! empty( $latest_install ) ) {
94 $is_new_install = version_compare( $latest_install, '3.6.0-beta', '>=' );
95 } else {
96 // If `$latest_install` is not set, Elementor was never installed on this site.
97 $is_new_install = true;
98 }
99
100 if ( $already_had_onboarding || ! $is_new_install ) {
101 return;
102 }
103
104 wp_safe_redirect( admin_url( 'admin.php?page=elementor-app#onboarding' ) );
105
106 exit;
107 }
108
109 private function register_packages() {
110 $assets_config_provider = ( new Assets_Config_Provider() )
111 ->set_path_resolver( function ( $name ) {
112 return ELEMENTOR_ASSETS_PATH . "js/packages/{$name}/{$name}.asset.php";
113 } );
114
115 Collection::make( [ 'ui', 'icons', 'query' ] )
116 ->each( function( $package ) use ( $assets_config_provider ) {
117 $suffix = Utils::is_script_debug() ? '' : '.min';
118 $config = $assets_config_provider->load( $package )->get( $package );
119
120 if ( ! $config ) {
121 return;
122 }
123
124 wp_register_script(
125 $config['handle'],
126 ELEMENTOR_ASSETS_URL . "js/packages/{$package}/{$package}{$suffix}.js",
127 $config['deps'],
128 ELEMENTOR_VERSION,
129 true
130 );
131 } );
132 }
133
134 /**
135 * Enqueue admin scripts.
136 *
137 * Registers all the admin scripts and enqueues them.
138 *
139 * Fired by `admin_enqueue_scripts` action.
140 *
141 * @since 1.0.0
142 * @access public
143 */
144 public function enqueue_scripts() {
145 wp_register_script(
146 'elementor-admin-modules',
147 $this->get_js_assets_url( 'admin-modules' ),
148 [],
149 ELEMENTOR_VERSION,
150 true
151 );
152
153 $this->register_packages();
154
155 // Temporary solution for the admin.
156 wp_register_script(
157 'elementor-ai-admin',
158 $this->get_js_assets_url( 'ai-admin' ),
159 [
160 'elementor-common',
161 'elementor-v2-ui',
162 'elementor-v2-icons',
163 ],
164 ELEMENTOR_VERSION,
165 true
166 );
167
168 wp_register_script(
169 'elementor-admin',
170 $this->get_js_assets_url( 'admin' ),
171 [
172 'elementor-common',
173 'elementor-admin-modules',
174 ],
175 ELEMENTOR_VERSION,
176 true
177 );
178
179 wp_enqueue_script( 'elementor-admin' );
180
181 wp_set_script_translations( 'elementor-admin', 'elementor' );
182
183 $this->maybe_enqueue_hints();
184
185 $this->print_config();
186 }
187
188 /**
189 * Enqueue admin styles.
190 *
191 * Registers all the admin styles and enqueues them.
192 *
193 * Fired by `admin_enqueue_scripts` action.
194 *
195 * @since 1.0.0
196 * @access public
197 */
198 public function enqueue_styles() {
199 wp_register_style(
200 'elementor-admin',
201 $this->get_css_assets_url( 'admin' ),
202 [
203 'elementor-common',
204 ],
205 ELEMENTOR_VERSION
206 );
207
208 wp_enqueue_style( 'elementor-admin' );
209
210 // It's for upgrade notice.
211 // TODO: enqueue this just if needed.
212 add_thickbox();
213 }
214
215 /**
216 * Print switch mode button.
217 *
218 * Adds a switch button in post edit screen (which has cpt support). To allow
219 * the user to switch from the native WordPress editor to Elementor builder.
220 *
221 * Fired by `edit_form_after_title` action.
222 *
223 * @since 1.0.0
224 * @access public
225 *
226 * @param \WP_Post $post The current post object.
227 */
228 public function print_switch_mode_button( $post ) {
229 // Exit if Gutenberg are active.
230 if ( did_action( 'enqueue_block_editor_assets' ) ) {
231 return;
232 }
233
234 $document = Plugin::$instance->documents->get( $post->ID );
235
236 if ( ! $document || ! $document->is_editable_by_current_user() ) {
237 return;
238 }
239
240 wp_nonce_field( basename( __FILE__ ), '_elementor_edit_mode_nonce' );
241 ?>
242 <div id="elementor-switch-mode">
243 <input id="elementor-switch-mode-input" type="hidden" name="_elementor_post_mode" value="<?php echo esc_attr( $document->is_built_with_elementor() ); ?>" />
244 <button id="elementor-switch-mode-button" type="button" class="button button-primary button-hero">
245 <span class="elementor-switch-mode-on">
246 <i class="eicon-wordpress" aria-hidden="true"></i>
247 <?php echo esc_html__( 'Edit with WordPress', 'elementor' ); ?>
248 </span>
249 <span class="elementor-switch-mode-off">
250 <i class="eicon-elementor-square" aria-hidden="true"></i>
251 <?php echo esc_html__( 'Edit with Elementor', 'elementor' ); ?>
252 </span>
253 </button>
254 </div>
255 <div id="elementor-editor">
256 <a id="elementor-go-to-edit-page-link" href="<?php echo esc_url( $document->get_edit_url() ); ?>">
257 <div id="elementor-editor-button" class="button button-primary button-hero">
258 <i class="eicon-elementor-square" aria-hidden="true"></i>
259 <?php echo esc_html__( 'Edit with Elementor', 'elementor' ); ?>
260 </div>
261 <div class="elementor-loader-wrapper">
262 <div class="elementor-loader">
263 <div class="elementor-loader-boxes">
264 <div class="elementor-loader-box"></div>
265 <div class="elementor-loader-box"></div>
266 <div class="elementor-loader-box"></div>
267 <div class="elementor-loader-box"></div>
268 </div>
269 </div>
270 <div class="elementor-loading-title"><?php echo esc_html__( 'Loading', 'elementor' ); ?></div>
271 </div>
272 </a>
273 </div>
274 <?php
275 }
276
277 /**
278 * Save post.
279 *
280 * Flag the post mode when the post is saved.
281 *
282 * Fired by `save_post` action.
283 *
284 * @since 1.0.0
285 * @access public
286 *
287 * @param int $post_id Post ID.
288 */
289 public function save_post( $post_id ) {
290 if ( ! wp_verify_nonce( Utils::get_super_global_value( $_POST, '_elementor_edit_mode_nonce' ), basename( __FILE__ ) ) ) {
291 return;
292 }
293
294 if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
295 return;
296 }
297
298 Plugin::$instance->documents->get( $post_id )->set_is_built_with_elementor( ! empty( $_POST['_elementor_post_mode'] ) );
299 }
300
301 /**
302 * Add Elementor post state.
303 *
304 * Adds a new "Elementor" post state to the post table.
305 *
306 * Fired by `display_post_states` filter.
307 *
308 * @since 1.8.0
309 * @access public
310 *
311 * @param array $post_states An array of post display states.
312 * @param \WP_Post $post The current post object.
313 *
314 * @return array A filtered array of post display states.
315 */
316 public function add_elementor_post_state( $post_states, $post ) {
317 $document = Plugin::$instance->documents->get( $post->ID );
318
319 if ( $document && $document->is_built_with_elementor() && $document->is_editable_by_current_user() ) {
320 $post_states['elementor'] = esc_html__( 'Elementor', 'elementor' );
321 }
322
323 return $post_states;
324 }
325
326 /**
327 * Body status classes.
328 *
329 * Adds CSS classes to the admin body tag.
330 *
331 * Fired by `admin_body_class` filter.
332 *
333 * @since 1.0.0
334 * @access public
335 *
336 * @param string $classes Space-separated list of CSS classes.
337 *
338 * @return string Space-separated list of CSS classes.
339 */
340 public function body_status_classes( $classes ) {
341 global $pagenow;
342
343 if ( in_array( $pagenow, [ 'post.php', 'post-new.php' ], true ) && Utils::is_post_support() ) {
344 $post = get_post();
345
346 $document = Plugin::$instance->documents->get( $post->ID );
347
348 $mode_class = $document && $document->is_built_with_elementor() ? 'elementor-editor-active' : 'elementor-editor-inactive';
349
350 $classes .= ' ' . $mode_class;
351 }
352
353 return $classes;
354 }
355
356 /**
357 * Plugin action links.
358 *
359 * Adds action links to the plugin list table
360 *
361 * Fired by `plugin_action_links` filter.
362 *
363 * @since 1.0.0
364 * @access public
365 *
366 * @param array $links An array of plugin action links.
367 *
368 * @return array An array of plugin action links.
369 */
370 public function plugin_action_links( $links ) {
371 $settings_link = sprintf( '<a href="%1$s">%2$s</a>', admin_url( 'admin.php?page=' . Settings::PAGE_ID ), esc_html__( 'Settings', 'elementor' ) );
372
373 array_unshift( $links, $settings_link );
374
375 $go_pro_text = esc_html__( 'Get Elementor Pro', 'elementor' );
376 if ( Utils::is_sale_time() ) {
377 $go_pro_text = esc_html__( 'Sale! Upgrade Now', 'elementor' );
378 }
379
380 $links['go_pro'] = sprintf( '<a href="%1$s" target="_blank" class="elementor-plugins-gopro">%2$s</a>', 'https://go.elementor.com/go-pro-wp-plugins/', $go_pro_text );
381
382 return $links;
383 }
384
385 /**
386 * Plugin row meta.
387 *
388 * Adds row meta links to the plugin list table
389 *
390 * Fired by `plugin_row_meta` filter.
391 *
392 * @since 1.1.4
393 * @access public
394 *
395 * @param array $plugin_meta An array of the plugin's metadata, including
396 * the version, author, author URI, and plugin URI.
397 * @param string $plugin_file Path to the plugin file, relative to the plugins
398 * directory.
399 *
400 * @return array An array of plugin row meta links.
401 */
402 public function plugin_row_meta( $plugin_meta, $plugin_file ) {
403 if ( ELEMENTOR_PLUGIN_BASE === $plugin_file ) {
404 $row_meta = [
405 'docs' => '<a href="https://go.elementor.com/docs-admin-plugins/" aria-label="' . esc_attr__( 'View Elementor Documentation', 'elementor' ) . '" target="_blank">' . esc_html__( 'Docs & FAQs', 'elementor' ) . '</a>',
406 'ideo' => '<a href="https://go.elementor.com/yt-admin-plugins/" aria-label="' . esc_attr__( 'View Elementor Video Tutorials', 'elementor' ) . '" target="_blank">' . esc_html__( 'Video Tutorials', 'elementor' ) . '</a>',
407 ];
408
409 $plugin_meta = array_merge( $plugin_meta, $row_meta );
410 }
411
412 return $plugin_meta;
413 }
414
415 /**
416 * Admin footer text.
417 *
418 * Modifies the "Thank you" text displayed in the admin footer.
419 *
420 * Fired by `admin_footer_text` filter.
421 *
422 * @since 1.0.0
423 * @access public
424 *
425 * @param string $footer_text The content that will be printed.
426 *
427 * @return string The content that will be printed.
428 */
429 public function admin_footer_text( $footer_text ) {
430 $current_screen = get_current_screen();
431
432 if ( $current_screen && str_ends_with( $current_screen->id, 'elementor-mcp' ) ) {
433 return $footer_text;
434 }
435
436 $is_elementor_screen = ( $current_screen && false !== strpos( $current_screen->id, 'elementor' ) );
437
438 if ( $is_elementor_screen ) {
439 $footer_text = sprintf(
440 /* translators: 1: Elementor, 2: Link to plugin review */
441 __( 'Enjoyed %1$s? Please leave us a %2$s rating. We really appreciate your support!', 'elementor' ),
442 '<strong>' . esc_html__( 'Elementor', 'elementor' ) . '</strong>',
443 '<a href="https://go.elementor.com/admin-review/" target="_blank">&#9733;&#9733;&#9733;&#9733;&#9733;</a>'
444 );
445 }
446
447 return $footer_text;
448 }
449
450 /**
451 * Register dashboard widgets.
452 *
453 * Adds a new Elementor widgets to WordPress dashboard.
454 *
455 * Fired by `wp_dashboard_setup` action.
456 *
457 * @since 1.9.0
458 * @access public
459 */
460 public function register_dashboard_widgets() {
461 wp_add_dashboard_widget( 'e-dashboard-overview', esc_html__( 'Elementor Overview', 'elementor' ), [ $this, 'elementor_dashboard_overview_widget' ] );
462
463 // Move our widget to top.
464 global $wp_meta_boxes;
465
466 $dashboard = $wp_meta_boxes['dashboard']['normal']['core'];
467 $ours = [
468 'e-dashboard-overview' => $dashboard['e-dashboard-overview'],
469 ];
470
471 $wp_meta_boxes['dashboard']['normal']['core'] = array_merge( $ours, $dashboard ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
472 }
473
474 /**
475 * Displays the Elementor dashboard widget.
476 *
477 * Fired by `wp_add_dashboard_widget` function.
478 *
479 * @since 1.9.0
480 * @access public
481 */
482 public function elementor_dashboard_overview_widget() {
483 ?>
484 <div class="e-dashboard-overview e-dashboard-widget">
485 <?php
486 self::elementor_dashboard_overview_header();
487 self::elementor_dashboard_overview_recently_edited();
488 self::elementor_dashboard_overview_news_updates();
489 self::elementor_dashboard_overview_footer();
490 ?>
491 </div>
492 <?php
493 }
494
495 /**
496 * Displays the Elementor dashboard widget - header section.
497 * Fired by `elementor_dashboard_overview_widget` function.
498 *
499 * @param bool $show_versions
500 * @param bool $is_create_post_enabled
501 *
502 * @return void
503 * @since 3.12.0
504 */
505 public static function elementor_dashboard_overview_header( bool $show_versions = true, bool $is_create_post_enabled = true ) {
506 if ( User::is_current_user_can_edit_post_type( 'page' ) ) {
507 $create_new_label = esc_html__( 'Create New Page', 'elementor' );
508 $create_new_post_type = 'page';
509 } elseif ( User::is_current_user_can_edit_post_type( 'post' ) ) {
510 $create_new_label = esc_html__( 'Create New Post', 'elementor' );
511 $create_new_post_type = 'post';
512 }
513 ?>
514 <div class="e-overview__header">
515 <?php if ( $show_versions ) { ?>
516 <div class="e-overview__logo">
517 <div class="e-logo-wrapper"><i class="eicon-elementor-circle"></i></div>
518 </div>
519 <div class="e-overview__versions">
520 <span class="e-overview__version"><?php echo esc_html__( 'Elementor', 'elementor' ); ?> v<?php echo ELEMENTOR_VERSION; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></span>
521 <?php
522 /**
523 * Elementor dashboard widget after the version.
524 * Fires after Elementor version display in the dashboard widget.
525 *
526 * @since 1.9.0
527 */
528 do_action( 'elementor/admin/dashboard_overview_widget/after_version' );
529 ?>
530 </div>
531 <?php } ?>
532 <?php if ( ! empty( $create_new_post_type ) && $is_create_post_enabled ) { ?>
533 <div class="e-overview__create">
534 <a href="<?php echo esc_url( Plugin::$instance->documents->get_create_new_post_url( $create_new_post_type ) ); ?>" class="button"><span aria-hidden="true" class="dashicons dashicons-plus"></span> <?php echo esc_html( $create_new_label ); ?></a>
535 </div>
536 <?php } ?>
537 </div>
538 <?php
539 }
540
541 /**
542 * Displays the Elementor dashboard widget - recently edited section.
543 * Fired by `elementor_dashboard_overview_widget` function.
544 *
545 * @param array $args
546 * @param bool $show_heading
547 *
548 * @return void
549 * @since 3.12.0
550 */
551 public static function elementor_dashboard_overview_recently_edited( array $args = [], bool $show_heading = true ) {
552 $recently_edited_query = Utils::get_recently_edited_posts_query( $args );
553
554 if ( $recently_edited_query->have_posts() ) { ?>
555 <div class="e-overview__recently-edited">
556 <?php if ( $show_heading ) { ?>
557 <h3 class="e-heading e-divider_bottom"><?php echo esc_html__( 'Recently Edited', 'elementor' ); ?></h3>
558 <?php } ?>
559 <ul class="e-overview__posts">
560 <?php
561 while ( $recently_edited_query->have_posts() ) {
562 $recently_edited_query->the_post();
563 $document = Plugin::$instance->documents->get( get_the_ID() );
564
565 $date = date_i18n( _x( 'M jS', 'Dashboard Overview Widget Recently Date', 'elementor' ), get_the_modified_time( 'U' ) );
566 ?>
567 <li class="e-overview__post">
568 <a href="<?php echo esc_url( $document->get_edit_url() ); ?>" class="e-overview__post-link"><?php echo esc_html( get_the_title() ); ?>
569 <span class="dashicons dashicons-edit"></span></a>
570 <span><?php echo $date; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>, <?php the_modified_time(); ?></span>
571 </li>
572 <?php } ?>
573 </ul>
574 </div>
575 <?php }
576 }
577
578 /**
579 * Displays the Elementor dashboard widget - news and updates section.
580 * Fired by `elementor_dashboard_overview_widget` function.
581 *
582 * @param int $limit_feed
583 * @param bool $show_heading
584 *
585 * @return void
586 * @since 3.12.0
587 * @access public
588 */
589 public static function elementor_dashboard_overview_news_updates( int $limit_feed = 0, bool $show_heading = true ) {
590 $elementor_feed = Api::get_feed_data();
591 if ( $limit_feed > 0 ) {
592 $elementor_feed = array_slice( $elementor_feed, 0, $limit_feed );
593 }
594
595 if ( ! empty( $elementor_feed ) ) { ?>
596 <div class="e-overview__feed">
597 <?php if ( $show_heading ) { ?>
598 <h3 class="e-heading e-divider_bottom"><?php echo esc_html__( 'News & Updates', 'elementor' ); ?></h3>
599 <?php } ?>
600 <ul class="e-overview__posts">
601 <?php foreach ( $elementor_feed as $feed_item ) { ?>
602 <li class="e-overview__post">
603 <a href="<?php echo esc_url( $feed_item['url'] ); ?>" class="e-overview__post-link" target="_blank">
604 <?php if ( ! empty( $feed_item['badge'] ) ) { ?>
605 <span class="e-overview__badge"><?php echo esc_html( $feed_item['badge'] ); ?></span>
606 <?php } ?>
607 <?php echo esc_html( $feed_item['title'] ); ?>
608 </a>
609 <p class="e-overview__post-description"><?php echo esc_html( $feed_item['excerpt'] ); ?></p>
610 </li>
611 <?php } ?>
612 </ul>
613 </div>
614 <?php }
615 }
616
617 /**
618 * Displays the Elementor dashboard widget - footer section.
619 * Fired by `elementor_dashboard_overview_widget` function.
620 *
621 * @since 3.12.0
622 */
623 public static function elementor_dashboard_overview_footer() {
624 ?>
625 <div class="e-overview__footer e-divider_top">
626 <ul>
627 <?php foreach ( self::static_get_dashboard_overview_widget_footer_actions() as $action_id => $action ) { ?>
628 <li class="e-overview__<?php echo esc_attr( $action_id ); ?>">
629 <a href="<?php echo esc_url( $action['link'] ); ?>" target="_blank"><?php echo esc_html( $action['title'] ); ?>
630 <span class="screen-reader-text"><?php echo esc_html__( '(opens in a new window)', 'elementor' ); ?></span>
631 <span aria-hidden="true" class="dashicons dashicons-external"></span></a>
632 </li>
633 <?php } ?>
634 </ul>
635 </div>
636 <?php
637 }
638
639 /**
640 * Get elementor dashboard overview widget footer actions.
641 *
642 * Retrieves the footer action links displayed in elementor dashboard widget.
643 *
644 * @since 3.12.0
645 * @access public
646 */
647 public static function static_get_dashboard_overview_widget_footer_actions() {
648 $base_actions = [
649 'blog' => [
650 'title' => esc_html__( 'Blog', 'elementor' ),
651 'link' => 'https://go.elementor.com/overview-widget-blog/',
652 ],
653 'help' => [
654 'title' => esc_html__( 'Help', 'elementor' ),
655 'link' => 'https://go.elementor.com/overview-widget-docs/',
656 ],
657 ];
658
659 $additions_actions = [];
660 $additions_actions['ai'] = [
661 'title' => esc_html__( 'Build Smart with AI', 'elementor' ),
662 'link' => 'https://go.elementor.com/overview-widget-ai/',
663 ];
664 $additions_actions['go-pro'] = [
665 'title' => esc_html__( 'Upgrade', 'elementor' ),
666 'link' => 'https://go.elementor.com/go-pro-wp-overview-widget/',
667 ];
668
669 /**
670 * Dashboard widget footer actions.
671 *
672 * Filters the additions actions displayed in Elementor dashboard widget.
673 *
674 * Developers can add new action links to Elementor dashboard widget
675 * footer using this filter.
676 *
677 * @since 1.9.0
678 *
679 * @param array $additions_actions Elementor dashboard widget footer actions.
680 */
681 $additions_actions = apply_filters( 'elementor/admin/dashboard_overview_widget/footer_actions', $additions_actions );
682
683 $actions = $base_actions + $additions_actions;
684
685 return $actions;
686 }
687
688 /**
689 * Get elementor dashboard overview widget footer actions.
690 *
691 * Retrieves the footer action links displayed in elementor dashboard widget.
692 *
693 * @since 1.9.0
694 * @access private
695 */
696 private function get_dashboard_overview_widget_footer_actions() {
697 return self::static_get_dashboard_overview_widget_footer_actions();
698 }
699
700 /**
701 * Admin action new post.
702 *
703 * When a new post action is fired the title is set to 'Elementor' and the post ID.
704 *
705 * Fired by `admin_action_elementor_new_post` action.
706 *
707 * @since 1.9.0
708 * @access public
709 */
710 public function admin_action_new_post() {
711 check_admin_referer( 'elementor_action_new_post' );
712
713 $post_type = Utils::get_super_global_value( $_GET, 'post_type' ) ?? 'post';
714
715 if ( ! User::is_current_user_can_edit_post_type( $post_type ) ) {
716 return;
717 }
718
719 if ( empty( $_GET['template_type'] ) ) {
720 $type = 'post';
721 } else {
722 $type = sanitize_text_field( wp_unslash( $_GET['template_type'] ) );
723 }
724
725 $post_data = Utils::get_super_global_value( $_GET, 'post_data' ) ?? [];
726
727 $post_data = $this->filter_post_data( $post_data );
728
729 /**
730 * Create new post meta data.
731 *
732 * Filters the meta data of any new post created.
733 *
734 * @since 2.0.0
735 *
736 * @param array $meta Post meta data.
737 */
738 $meta = [];
739
740 if ( isset( $_GET['meta'] ) && is_array( $_GET['meta'] ) ) {
741 $meta = array_map( 'sanitize_text_field', wp_unslash( $_GET['meta'] ) );
742 }
743
744 $meta = apply_filters( 'elementor/admin/create_new_post/meta', $meta );
745
746 $post_data['post_type'] = $post_type;
747
748 $document = Plugin::$instance->documents->create( $type, $post_data, $meta );
749
750 if ( is_wp_error( $document ) ) {
751 wp_die( $document ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
752 }
753
754 wp_safe_redirect( $document->get_edit_url() );
755
756 die;
757 }
758
759 public function admin_action_site_settings_redirect() {
760 check_admin_referer( 'elementor_action_site_settings_redirect' );
761
762 if ( ! current_user_can( 'edit_theme_options' ) ) {
763 wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'elementor' ) );
764 }
765
766 $active_tab = filter_input( INPUT_GET, 'active-tab', FILTER_SANITIZE_ENCODED );
767
768 $site_settings_url_config = Page::get_site_settings_url_config( $active_tab );
769
770 if ( empty( $site_settings_url_config['url'] ) ) {
771 wp_die( esc_html__( 'Unable to create or access Site Settings page.', 'elementor' ) );
772 }
773
774 wp_safe_redirect( $site_settings_url_config['url'] );
775
776 die;
777 }
778
779 /**
780 * Admin action edit website.
781 *
782 * Redirects to the homepage edit URL if it exists and is built with Elementor,
783 * otherwise redirects to create a new page.
784 *
785 * Fired by `admin_action_elementor_edit_website` action.
786 *
787 * @since 3.x.x
788 * @access public
789 */
790 public function admin_action_edit_website_redirect() {
791 check_admin_referer( 'elementor_action_edit_website' );
792
793 if ( ! User::is_current_user_can_edit_post_type( 'page' ) ) {
794 wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', 'elementor' ) );
795 }
796
797 $homepage_id = $this->get_homepage_id();
798 $edit_url = $this->get_edit_website_url( $homepage_id );
799
800 wp_safe_redirect( $edit_url );
801
802 die;
803 }
804
805 private function get_homepage_id(): ?int {
806 if ( get_option( 'show_on_front' ) !== 'page' ) {
807 return null;
808 }
809
810 $homepage_id = get_option( 'page_on_front' );
811
812 return $homepage_id ? (int) $homepage_id : null;
813 }
814
815 private function get_edit_website_url( ?int $homepage_id ): string {
816 if ( ! $homepage_id ) {
817 return Plugin::$instance->documents->get_create_new_post_url( 'page' );
818 }
819
820 $document = Plugin::$instance->documents->get( $homepage_id );
821
822 if ( ! $document || ! $document->is_built_with_elementor() ) {
823 return Plugin::$instance->documents->get_create_new_post_url( 'page' );
824 }
825
826 return $document->get_edit_url();
827 }
828
829 private function get_allowed_fields_for_role() {
830 $allowed_fields = [
831 'post_title',
832 'post_content',
833 'post_excerpt',
834 'post_category',
835 'post_type',
836 'tags_input',
837 ];
838
839 if ( current_user_can( 'publish_posts' ) ) {
840 $allowed_fields[] = 'post_status';
841 }
842
843 if ( current_user_can( 'edit_others_posts' ) ) {
844 $allowed_fields[] = 'post_author';
845 }
846
847 return $allowed_fields;
848 }
849
850 private function filter_post_data( $post_data ) {
851 $allowed_fields = $this->get_allowed_fields_for_role();
852 return array_filter(
853 $post_data,
854 function( $key ) use ( $allowed_fields ) {
855 return in_array( $key, $allowed_fields, true );
856 },
857 ARRAY_FILTER_USE_KEY
858 );
859 }
860 /**
861 * @since 2.3.0
862 * @access public
863 */
864 public function add_new_template_template() {
865 Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/new-template.php' );
866 }
867
868 public function add_new_floating_elements_template() {
869 Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/new-floating-elements.php' );
870 }
871
872 public function enqueue_new_floating_elements_scripts() {
873 $suffix = Utils::is_script_debug() ? '' : '.min';
874
875 wp_enqueue_script(
876 'elementor-floating-elements-modal',
877 ELEMENTOR_ASSETS_URL . 'js/floating-elements-modal' . $suffix . '.js',
878 [],
879 ELEMENTOR_VERSION,
880 true
881 );
882
883 wp_set_script_translations( 'elementor-floating-elements-modal', 'elementor' );
884 }
885
886 /**
887 * @access public
888 */
889 public function enqueue_new_template_scripts() {
890 $suffix = Utils::is_script_debug() ? '' : '.min';
891
892 wp_enqueue_script(
893 'elementor-new-template',
894 ELEMENTOR_ASSETS_URL . 'js/new-template' . $suffix . '.js',
895 [],
896 ELEMENTOR_VERSION,
897 true
898 );
899
900 wp_set_script_translations( 'elementor-new-template', 'elementor' );
901 }
902
903 /**
904 * @since 2.6.0
905 * @access public
906 */
907 public function add_beta_tester_template() {
908 Plugin::$instance->common->add_template( ELEMENTOR_PATH . 'includes/admin-templates/beta-tester.php' );
909 }
910
911 /**
912 * @access public
913 */
914 public function enqueue_beta_tester_scripts() {
915 $suffix = Utils::is_script_debug() ? '' : '.min';
916
917 wp_enqueue_script(
918 'elementor-beta-tester',
919 ELEMENTOR_ASSETS_URL . 'js/beta-tester' . $suffix . '.js',
920 [],
921 ELEMENTOR_VERSION,
922 true
923 );
924
925 wp_set_script_translations( 'elementor-beta-tester', 'elementor' );
926 }
927
928 public function init_floating_elements() {
929 $screens = [
930 'elementor_library_page_e-floating-buttons' => true,
931 'edit-e-floating-buttons' => true,
932 ];
933
934 if ( ! isset( $screens[ get_current_screen()->id ] ) ) {
935 return;
936 }
937
938 add_action( 'admin_head', [ $this, 'add_new_floating_elements_template' ] );
939 add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_new_floating_elements_scripts' ] );
940 }
941
942 /**
943 * @access public
944 */
945 public function init_new_template() {
946 if ( 'edit-elementor_library' !== get_current_screen()->id ) {
947 return;
948 }
949
950 // Allow plugins to add their templates on admin_head.
951 add_action( 'admin_head', [ $this, 'add_new_template_template' ] );
952 add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_new_template_scripts' ] );
953 }
954
955 public function version_update_warning( $current_version, $new_version ) {
956 $current_version_minor_part = explode( '.', $current_version )[1];
957 $new_version_minor_part = explode( '.', $new_version )[1];
958
959 if ( $current_version_minor_part === $new_version_minor_part ) {
960 return;
961 }
962 ?>
963 <hr class="e-major-update-warning__separator" />
964 <div class="e-major-update-warning">
965 <div class="e-major-update-warning__icon">
966 <i class="eicon-info-circle"></i>
967 </div>
968 <div>
969 <div class="e-major-update-warning__title">
970 <?php echo esc_html__( 'Heads up, Please backup before upgrade!', 'elementor' ); ?>
971 </div>
972 <div class="e-major-update-warning__message">
973 <?php
974 printf(
975 /* translators: %1$s Link open tag, %2$s: Link close tag. */
976 esc_html__( 'The latest update includes some substantial changes across different areas of the plugin. We highly recommend you %1$sbackup your site before upgrading%2$s, and make sure you first update in a staging environment', 'elementor' ),
977 '<a href="https://go.elementor.com/wp-dash-update-backup/">',
978 '</a>'
979 );
980 ?>
981 </div>
982 </div>
983 </div>
984 <?php
985 }
986
987 /**
988 * @access public
989 */
990 public function init_beta_tester( $current_screen ) {
991 if ( ( 'toplevel_page_elementor' === $current_screen->base ) || 'elementor_page_elementor-tools' === $current_screen->id ) {
992 add_action( 'admin_head', [ $this, 'add_beta_tester_template' ] );
993 add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_beta_tester_scripts' ] );
994 }
995 }
996
997 /**
998 * Admin constructor.
999 *
1000 * Initializing Elementor in WordPress admin.
1001 *
1002 * @since 1.0.0
1003 * @access public
1004 */
1005 public function __construct() {
1006 Plugin::$instance->init_common();
1007
1008 $this->add_component( 'feedback', new Feedback() );
1009 $this->add_component( 'admin-notices', new Admin_Notices() );
1010
1011 add_action( 'admin_init', [ $this, 'maybe_redirect_to_getting_started' ] );
1012
1013 add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_scripts' ] );
1014 add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_styles' ] );
1015
1016 add_action( 'edit_form_after_title', [ $this, 'print_switch_mode_button' ] );
1017 add_action( 'save_post', [ $this, 'save_post' ] );
1018
1019 add_filter( 'display_post_states', [ $this, 'add_elementor_post_state' ], 10, 2 );
1020
1021 add_filter( 'plugin_action_links_' . ELEMENTOR_PLUGIN_BASE, [ $this, 'plugin_action_links' ] );
1022 add_filter( 'plugin_row_meta', [ $this, 'plugin_row_meta' ], 10, 2 );
1023
1024 add_filter( 'admin_body_class', [ $this, 'body_status_classes' ] );
1025 add_filter( 'admin_footer_text', [ $this, 'admin_footer_text' ] );
1026
1027 // Register Dashboard Widgets.
1028 add_action( 'wp_dashboard_setup', [ $this, 'register_dashboard_widgets' ] );
1029
1030 // Admin Actions
1031 add_action( 'admin_action_elementor_new_post', [ $this, 'admin_action_new_post' ] );
1032 add_action( 'admin_action_elementor_site_settings_redirect', [ $this, 'admin_action_site_settings_redirect' ] );
1033 add_action( 'admin_action_elementor_edit_website_redirect', [ $this, 'admin_action_edit_website_redirect' ] );
1034
1035 add_action( 'current_screen', [ $this, 'init_new_template' ] );
1036 add_action( 'current_screen', [ $this, 'init_floating_elements' ] );
1037 add_action( 'current_screen', [ $this, 'init_beta_tester' ] );
1038
1039 add_action( 'in_plugin_update_message-' . ELEMENTOR_PLUGIN_BASE, function( $plugin_data ) {
1040 $this->version_update_warning( ELEMENTOR_VERSION, $plugin_data['new_version'] );
1041 } );
1042
1043 add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_hints' ] );
1044 }
1045
1046 /**
1047 * @since 2.3.0
1048 * @access protected
1049 */
1050 protected function get_init_settings() {
1051 $beta_tester_email = get_user_meta( get_current_user_id(), User::BETA_TESTER_META_KEY, true );
1052 $elementor_beta = get_option( 'elementor_beta', 'no' );
1053 $all_introductions = User::get_introduction_meta();
1054 $beta_tester_signup_dismissed = array_key_exists( Beta_Testers::BETA_TESTER_SIGNUP, $all_introductions );
1055
1056 $settings = [
1057 'home_url' => home_url(),
1058 'settings_url' => Settings::get_url(),
1059 'user' => [
1060 'introduction' => User::get_introduction_meta(),
1061 'restrictions' => Plugin::$instance->role_manager->get_user_restrictions_array(),
1062 'is_administrator' => current_user_can( 'manage_options' ),
1063 ],
1064 'beta_tester' => [
1065 'beta_tester_signup' => Beta_Testers::BETA_TESTER_SIGNUP,
1066 'has_email' => $beta_tester_email,
1067 'option_enabled' => 'no' !== $elementor_beta,
1068 'signup_dismissed' => $beta_tester_signup_dismissed,
1069 ],
1070 'experiments' => $this->get_experiments(),
1071 ];
1072
1073 /**
1074 * Localize settings.
1075 *
1076 * Filters the initial localize settings in the admin.
1077 *
1078 * WordPress has it's own way to pass localized data from PHP (backend) to
1079 * JS (frontend). Elementor uses this method to pass localize data in the
1080 * admin. This hook can be used to add more localized settings in addition
1081 * to the initial Elementor settings.
1082 *
1083 * @since 2.3.0
1084 *
1085 * @param array $settings Initial localize settings.
1086 */
1087 $settings = apply_filters( 'elementor/admin/localize_settings', $settings );
1088
1089 return $settings;
1090 }
1091
1092 private function get_experiments() {
1093 return ( new Collection( Plugin::$instance->experiments->get_features() ) )
1094 ->map( function ( $experiment_data ) {
1095 $dependencies = $experiment_data['dependencies'] ?? [];
1096
1097 $dependencies = ( new Collection( $dependencies ) )
1098 ->map( function ( $dependency ) {
1099 return $dependency->get_name();
1100 } )->all();
1101
1102 return [
1103 'name' => $experiment_data['name'],
1104 'title' => $experiment_data['title'] ?? $experiment_data['name'],
1105 'state' => $experiment_data['state'],
1106 'default' => $experiment_data['default'],
1107 'dependencies' => $dependencies,
1108 'messages' => $experiment_data['messages'] ?? [],
1109 ];
1110 } )->all();
1111 }
1112
1113 private function maybe_enqueue_hints() {
1114 $plugin_slug = 'image-optimization';
1115
1116 if ( ! Hints::should_display_hint( $plugin_slug ) ) {
1117 return;
1118 }
1119
1120 wp_register_script(
1121 'media-hints',
1122 $this->get_js_assets_url( 'media-hints' ),
1123 [],
1124 ELEMENTOR_VERSION,
1125 true
1126 );
1127
1128 $one_subscription = Hints::is_plugin_connected_to_one_subscription();
1129 $is_installed = Hints::is_plugin_installed( $plugin_slug );
1130 $is_active = Hints::is_plugin_active( $plugin_slug );
1131
1132 if ( $is_active ) {
1133 return;
1134 }
1135
1136 if ( $one_subscription ) {
1137 if ( ! $is_installed ) {
1138 $description = esc_html__( 'Automatically optimize images to improve site speed and performance. Included with your ONE subscription.', 'elementor' );
1139 $button_text = esc_html__( 'Install now', 'elementor' );
1140 $button_url = Hints::get_plugin_install_url( $plugin_slug );
1141 } elseif ( ! $is_active ) {
1142 $description = esc_html__( 'Image Optimization is installed and included in your ONE subscription. Activate it to optimize images and improve site performance.', 'elementor' );
1143 $button_text = esc_html__( 'Activate now', 'elementor' );
1144 $button_url = Hints::get_plugin_activate_url( $plugin_slug );
1145 }
1146 } else {
1147 $description = esc_html__( 'Optimize your images to enhance site performance by using Image Optimization.', 'elementor' );
1148 if ( ! $is_installed ) {
1149 $button_text = esc_html__( 'Install now', 'elementor' );
1150 $button_url = Hints::get_plugin_install_url( $plugin_slug );
1151 } elseif ( ! $is_active ) {
1152 $button_text = esc_html__( 'Activate now', 'elementor' );
1153 $button_url = Hints::get_plugin_activate_url( $plugin_slug );
1154 }
1155 }
1156
1157 $dismissible = 'image_optimizer_hint';
1158
1159 $title = esc_html__( 'Speed up your website with Image Optimization', 'elementor' );
1160 $content = sprintf(
1161 "<strong>%1\$s</strong><br>%2\$s <a class='e-btn-1' href='%3\$s' target='_blank'>%4\$s</a>!",
1162 $title,
1163 $description,
1164 $button_url,
1165 $button_text
1166 );
1167
1168 wp_localize_script( 'media-hints', 'elementorAdminHints', [
1169 'mediaHint' => [
1170 'display' => true,
1171 'type' => 'info',
1172 'content' => $content,
1173 'icon' => true,
1174 'dismissible' => $dismissible,
1175 'dismiss' => esc_attr__( 'Dismiss this notice.', 'elementor' ),
1176 'button_event' => $dismissible,
1177 'button_data' => base64_encode(
1178 wp_json_encode( [
1179 'action_url' => $button_url,
1180 ] ),
1181 ),
1182 ],
1183 ] );
1184
1185 wp_enqueue_script( 'media-hints' );
1186 }
1187
1188 public function register_ajax_hints( $ajax_manager ) {
1189 $ajax_manager->register_ajax_action( 'elementor_image_optimization_campaign', [ $this, 'ajax_set_image_optimization_campaign' ] );
1190 $ajax_manager->register_ajax_action( 'elementor_core_ally_campaign', [ $this, 'ajax_ally_campaign' ] );
1191 }
1192
1193 public function ajax_ally_campaign( $request ) {
1194 if ( ! current_user_can( 'install_plugins' ) ) {
1195 return;
1196 }
1197
1198 $campaign_data = [
1199 'campaign' => sanitize_key( $request['campaign'] ?? '' ),
1200 'source' => sanitize_key( $request['source'] ?? '' ),
1201 'medium' => sanitize_key( $request['medium'] ?? '' ),
1202 ];
1203
1204 set_transient( 'elementor_ea11y_campaign', $campaign_data, 30 * DAY_IN_SECONDS );
1205 }
1206
1207 public function ajax_set_image_optimization_campaign( $request ) {
1208 if ( ! current_user_can( 'install_plugins' ) ) {
1209 return;
1210 }
1211
1212 $campaign_data = [
1213 'campaign' => sanitize_key( $request['campaign'] ?? '' ),
1214 'source' => sanitize_key( $request['source'] ?? '' ),
1215 'medium' => sanitize_key( $request['medium'] ?? '' ),
1216 ];
1217
1218 set_transient( 'elementor_image_optimization_campaign', $campaign_data, 30 * DAY_IN_SECONDS );
1219 }
1220 }
1221