elementor / core / settings / page / manager.php

manager.php in Elementor Website Builder – more than just a page builder 3.13.1, at core/settings/page/manager.php

346 lines 8.1 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Core\Settings\Page;
3
4	use Elementor\Core\Base\Document;
5	use Elementor\Core\Files\CSS\Base;
6	use Elementor\Core\Files\CSS\Post;
7	use Elementor\Core\Files\CSS\Post_Preview;
8	use Elementor\Core\Settings\Base\CSS_Manager;
9	use Elementor\Core\Utils\Exceptions;
10	use Elementor\Core\Settings\Base\Model as BaseModel;
11	use Elementor\Plugin;
12	use Elementor\Utils;
13
14	if ( ! defined( 'ABSPATH' ) ) {
15	exit; // Exit if accessed directly.
16	}
17
18	/**
19	* Elementor page settings manager.
20	*
21	* Elementor page settings manager handler class is responsible for registering
22	* and managing Elementor page settings managers.
23	*
24	* @since 1.6.0
25	*/
26	class Manager extends CSS_Manager {
27
28	/**
29	* Meta key for the page settings.
30	*/
31	const META_KEY = '_elementor_page_settings';
32
33	/**
34	* Get manager name.
35	*
36	* Retrieve page settings manager name.
37	*
38	* @since 1.6.0
39	* @access public
40	*
41	* @return string Manager name.
42	*/
43	public function get_name() {
44	return 'page';
45	}
46
47	/**
48	* Get model for config.
49	*
50	* Retrieve the model for settings configuration.
51	*
52	* @since 1.6.0
53	* @access public
54	*
55	* @return BaseModel The model object.
56	*/
57	public function get_model_for_config() {
58	if ( ! is_singular() && ! Plugin::$instance->editor->is_edit_mode() ) {
59	return null;
60	}
61
62	if ( Plugin::$instance->editor->is_edit_mode() ) {
63	$post_id = Plugin::$instance->editor->get_post_id();
64	$document = Plugin::$instance->documents->get_doc_or_auto_save( $post_id );
65	} else {
66	$post_id = get_the_ID();
67	$document = Plugin::$instance->documents->get_doc_for_frontend( $post_id );
68	}
69
70	if ( ! $document ) {
71	return null;
72	}
73
74	$model = $this->get_model( $document->get_post()->ID );
75
76	if ( $document->is_autosave() ) {
77	$model->set_settings( 'post_status', $document->get_main_post()->post_status );
78	}
79
80	return $model;
81	}
82
83	/**
84	* Ajax before saving settings.
85	*
86	* Validate the data before saving it and updating the data in the database.
87	*
88	* @since 1.6.0
89	* @access public
90	*
91	* @param array $data Post data.
92	* @param int $id Post ID.
93	*
94	* @throws \Exception If invalid post returned using the `$id`.
95	* @throws \Exception If current user don't have permissions to edit the post.
96	*/
97	public function ajax_before_save_settings( array $data, $id ) {
98	$post = get_post( $id );
99
100	if ( empty( $post ) ) {
101	throw new \Exception( 'Invalid post.', Exceptions::NOT_FOUND );
102	}
103
104	if ( ! Utils::is_wp_cli() && ! current_user_can( 'edit_post', $id ) ) {
105	throw new \Exception( 'Access denied.', Exceptions::FORBIDDEN );
106	}
107
108	// Avoid save empty post title.
109	if ( ! empty( $data['post_title'] ) ) {
110	$post->post_title = $data['post_title'];
111	}
112
113	if ( isset( $data['post_excerpt'] ) && post_type_supports( $post->post_type, 'excerpt' ) ) {
114	$post->post_excerpt = $data['post_excerpt'];
115	}
116
117	if ( isset( $data['post_status'] ) ) {
118	$this->save_post_status( $id, $data['post_status'] );
119	unset( $post->post_status );
120	}
121
122	wp_update_post( $post );
123
124	// Check updated status
125	if ( Document::STATUS_PUBLISH === get_post_status( $id ) ) {
126	$autosave = wp_get_post_autosave( $post->ID );
127	if ( $autosave ) {
128	wp_delete_post_revision( $autosave->ID );
129	}
130	}
131
132	if ( isset( $data['post_featured_image'] ) && post_type_supports( $post->post_type, 'thumbnail' ) ) {
133	if ( empty( $data['post_featured_image']['id'] ) ) {
134	delete_post_thumbnail( $post->ID );
135	} else {
136	set_post_thumbnail( $post->ID, $data['post_featured_image']['id'] );
137	}
138	}
139
140	if ( Utils::is_cpt_custom_templates_supported() ) {
141	$template = get_metadata( 'post', $post->ID, '_wp_page_template', true );
142
143	if ( isset( $data['template'] ) ) {
144	$template = $data['template'];
145	}
146
147	if ( empty( $template ) ) {
148	$template = 'default';
149	}
150
151	// Use `update_metadata` in order to save also for revisions.
152	update_metadata( 'post', $post->ID, '_wp_page_template', $template );
153	}
154	}
155
156	/**
157	* @inheritDoc
158	*
159	* Override parent because the page setting moved to document.settings.
160	*/
161	protected function print_editor_template_content( $name ) {
162	?>
163	<#
164	const tabs = elementor.config.document.settings.tabs;
165
166	if ( Object.values( tabs ).length > 1 ) { #>
167	<div class="elementor-panel-navigation">
168	<# _.each( tabs, function( tabTitle, tabSlug ) {
169	$e.bc.ensureTab( 'panel/page-settings', tabSlug ); #>
170	<button class="elementor-component-tab elementor-panel-navigation-tab elementor-tab-control-{{ tabSlug }}" data-tab="{{ tabSlug }}">
171	<?php /* TODO: raplace `<a>` tag with `<span>` tag in Elementor 3.14.0 */ ?>
172	<a>{{{ tabTitle }}}</a>
173	</button>
174	<# } ); #>
175	</div>
176	<# } #>
177	<div id="elementor-panel-<?php echo esc_attr( $name ); ?>-settings-controls"></div>
178	<?php
179	}
180
181	/**
182	* Save settings to DB.
183	*
184	* Save page settings to the database, as post meta data.
185	*
186	* @since 1.6.0
187	* @access protected
188	*
189	* @param array $settings Settings.
190	* @param int $id Post ID.
191	*/
192	protected function save_settings_to_db( array $settings, $id ) {
193	// Use update/delete_metadata in order to handle also revisions.
194	if ( ! empty( $settings ) ) {
195	// Use `wp_slash` in order to avoid the unslashing during the `update_post_meta`.
196	update_metadata( 'post', $id, self::META_KEY, wp_slash( $settings ) );
197	} else {
198	delete_metadata( 'post', $id, self::META_KEY );
199	}
200	}
201
202	/**
203	* Get CSS file for update.
204	*
205	* Retrieve the CSS file before updating it.
206	*
207	* This method overrides the parent method to disallow updating CSS files for pages.
208	*
209	* @since 1.6.0
210	* @access protected
211	*
212	* @param int $id Post ID.
213	*
214	* @return false Disallow The updating CSS files for pages.
215	*/
216	protected function get_css_file_for_update( $id ) {
217	return false;
218	}
219
220	/**
221	* Get saved settings.
222	*
223	* Retrieve the saved settings from the post meta.
224	*
225	* @since 1.6.0
226	* @access protected
227	*
228	* @param int $id Post ID.
229	*
230	* @return array Saved settings.
231	*/
232	protected function get_saved_settings( $id ) {
233	$settings = get_post_meta( $id, self::META_KEY, true );
234
235	if ( ! $settings ) {
236	$settings = [];
237	}
238
239	if ( Utils::is_cpt_custom_templates_supported() ) {
240	$saved_template = get_post_meta( $id, '_wp_page_template', true );
241
242	if ( $saved_template ) {
243	$settings['template'] = $saved_template;
244	}
245	}
246
247	return $settings;
248	}
249
250	/**
251	* Get CSS file name.
252	*
253	* Retrieve CSS file name for the page settings manager.
254	*
255	* @since 1.6.0
256	* @access protected
257	*
258	* @return string CSS file name.
259	*/
260	protected function get_css_file_name() {
261	return 'post';
262	}
263
264	/**
265	* Get model for CSS file.
266	*
267	* Retrieve the model for the CSS file.
268	*
269	* @since 1.6.0
270	* @access protected
271	*
272	* @param Base $css_file The requested CSS file.
273	*
274	* @return BaseModel The model object.
275	*/
276	protected function get_model_for_css_file( Base $css_file ) {
277	if ( ! $css_file instanceof Post ) {
278	return null;
279	}
280
281	$post_id = $css_file->get_post_id();
282
283	if ( $css_file instanceof Post_Preview ) {
284	$autosave = Utils::get_post_autosave( $post_id );
285	if ( $autosave ) {
286	$post_id = $autosave->ID;
287	}
288	}
289
290	return $this->get_model( $post_id );
291	}
292
293	/**
294	* Get special settings names.
295	*
296	* Retrieve the names of the special settings that are not saved as regular
297	* settings. Those settings have a separate saving process.
298	*
299	* @since 1.6.0
300	* @access protected
301	*
302	* @return array Special settings names.
303	*/
304	protected function get_special_settings_names() {
305	return [
306	'id',
307	'post_title',
308	'post_status',
309	'template',
310	'post_excerpt',
311	'post_featured_image',
312	];
313	}
314
315	/**
316	* @since 2.0.0
317	* @access public
318	*
319	* @param $post_id
320	* @param $status
321	*/
322	public function save_post_status( $post_id, $status ) {
323	$parent_id = wp_is_post_revision( $post_id );
324
325	if ( $parent_id ) {
326	// Don't update revisions post-status
327	return;
328	}
329
330	$parent_id = $post_id;
331
332	$post = get_post( $parent_id );
333
334	$allowed_post_statuses = get_post_statuses();
335
336	if ( isset( $allowed_post_statuses[ $status ] ) ) {
337	$post_type_object = get_post_type_object( $post->post_type );
338	if ( 'publish' !== $status \|\| current_user_can( $post_type_object->cap->publish_posts ) ) {
339	$post->post_status = $status;
340	}
341	}
342
343	wp_update_post( $post );
344	}
345	}
346