PluginProbe ʕ •ᴥ•ʔ
Elementor Website Builder – more than just a page builder / 4.1.0-beta3
Elementor Website Builder – more than just a page builder v4.1.0-beta3
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 4.1.0-dev1 4.0.7 4.0.6 4.0.5 4.0.4 4.0.3 3.22.0-dev1 4.0.0-beta3 3.22.0-dev2 4.0.0-beta4 3.22.0-dev3 4.0.0-beta5 3.22.0-dev4 4.0.0-dev1 3.22.0-dev5 4.0.0-dev2 3.22.0-dev6 4.0.0-dev3 3.22.1 4.0.0-dev4 3.22.2 4.0.0-dev5 3.22.3 4.0.1 3.23.0 4.0.2 3.23.0-beta1 3.23.0-beta2 3.23.0-beta3 3.23.0-beta4 3.23.0-beta5 3.23.0-beta6 3.23.0-dev1 3.23.0-dev2 3.23.0-dev3 3.23.0-dev4 3.23.0-dev5 3.23.0-dev6 3.23.1 3.23.2 3.23.3 3.23.4 3.24.0 3.24.0-beta1 3.24.0-beta2 3.24.0-beta3 3.24.0-dev1 3.24.0-dev2 3.24.0-dev3 3.24.1 3.24.2 3.24.3 3.24.4 3.24.5 3.24.6 3.24.7 3.24.8 3.25.0 3.25.0-beta1 3.25.0-beta2 3.25.0-beta3 3.25.0-dev1 3.25.0-dev2 3.25.0-dev3 3.25.1 3.25.10 3.25.11 3.25.2 3.25.3 3.25.4 3.25.5 3.25.6 3.25.7 3.25.8 3.25.9 3.26.0 3.26.0-beta1 3.26.0-beta2 3.26.0-beta3 3.26.0-beta4 3.26.0-beta5 3.26.0-dev1 3.26.0-dev2 3.26.0-dev3 3.26.0-dev4 3.26.0-dev5 3.26.1 3.26.2 3.26.3 3.26.4 3.26.5 3.27.0 3.27.0-beta1 3.27.0-beta2 3.27.0-dev1 3.27.0-dev2 3.27.1 3.27.2 3.27.3 3.27.4 3.27.5 3.27.6 3.27.7 3.28.0 3.28.0-beta1 3.28.0-beta2 3.28.0-beta3 3.28.0-dev1 3.28.0-dev2 3.28.0-dev3 3.28.1 3.28.2 3.28.3 3.28.4 3.29.0 3.29.0-beta1 trunk 3.29.0-beta2 3.0.0 3.29.0-beta3 3.0.1 3.29.0-beta4 3.0.10 3.29.0-dev1 3.0.11 3.29.0-dev2 3.0.12 3.29.0-dev3 3.0.13 3.29.0-dev4 3.0.14 3.29.1 3.0.15 3.29.2 3.0.16 3.3.0 3.0.2 3.3.1 3.0.3 3.30.0 3.0.4 3.30.0-beta1 3.0.5 3.30.0-beta2 3.0.6 3.30.0-beta3 3.0.7 3.30.0-dev1 3.0.8 3.30.0-dev2 3.0.8.1 3.30.0-dev3 3.0.9 3.30.1 3.1.0 3.30.2 3.1.0-beta1 3.30.3 3.1.0-beta2 3.30.4 3.1.0-beta3 3.31.0 3.1.0-beta4 3.31.0-beta1 3.1.0-dev1 3.31.0-beta2 3.1.0-dev2 3.31.0-dev1 3.1.0-dev3 3.31.0-dev2 3.1.1 3.31.1 3.1.2 3.31.2 3.1.3 3.31.3 3.1.4 3.31.4 3.10.0 3.31.5 3.10.0-dev1 3.32.0 3.10.1 3.32.0-beta1 3.10.2 3.32.0-beta2 3.11.0 3.32.0-beta3 3.11.0-beta1 3.32.0-dev1 3.11.0-beta2 3.32.0-dev2 3.11.0-beta3 3.32.0-dev3 3.11.0-dev1 3.32.1 3.11.0-dev2 3.32.2 3.11.0-dev3 3.32.3 3.11.1 3.32.4 3.11.2 3.32.5 3.11.3 3.33.0 3.11.4 3.33.0-beta1 3.11.5 3.33.0-beta2 3.12.0 3.33.0-beta3 3.12.1 3.33.0-beta4 3.12.2 3.33.0-dev1 3.13.0 3.33.0-dev2 3.13.0-beta1 3.33.0-dev3 3.13.0-beta2 3.33.0-dev4 3.13.0-beta3 3.33.1 3.13.0-dev3 3.33.2 3.13.0-dev4 3.33.3 3.13.1 3.33.4 3.13.2 3.33.5 3.13.3 3.33.6 3.13.4 3.34.0 3.14.0 3.34.0-beta1 3.14.0-beta1 3.34.0-beta2 3.14.0-beta2 3.34.0-beta3 3.14.0-beta3 3.34.0-dev1 3.14.0-beta4 3.34.0-dev2 3.14.0-beta5 3.34.1 3.14.1 3.34.2 3.15.0 3.34.3 3.15.1 3.34.4 3.15.2 3.35.0 3.15.3 3.35.0-beta1 3.16.0 3.35.0-beta2 3.16.0-beta3 3.35.0-beta3 3.16.0-beta4 3.35.0-beta4 3.16.0-dev1 3.35.0-dev1 3.16.0-dev2 3.35.0-dev2 3.16.1 3.35.0-dev3 3.16.2 3.35.0-dev4 3.16.3 3.35.1 3.16.4 3.35.2 3.16.5 3.35.3 3.16.6 3.35.4 3.17.0 3.35.5 3.17.0-dev2 3.35.6 3.17.0-dev3 3.35.7 3.17.0-dev4 3.35.8 3.17.1 3.35.9 3.17.2 3.4.0 3.17.3 3.4.0-dev7 3.18.0 3.4.0-dev8 3.18.0-beta1 3.4.0-dev9 3.18.0-beta2 3.4.1 3.18.0-beta3 3.4.2 3.18.0-beta4 3.4.3 3.18.0-dev1 3.4.4 3.18.1 3.4.5 3.18.2 3.4.6 3.18.3 3.4.7 3.19.0 3.4.8 3.19.0-beta1 3.5.0 3.19.0-beta2 3.5.0-beta1 3.19.0-beta3 3.5.0-beta2 3.19.0-beta4 3.5.0-beta3 3.19.0-beta5 3.5.0-beta4 3.19.0-beta6 3.5.0-beta5 3.19.0-dev1 3.5.0-beta7 3.19.0-dev2 3.5.0-beta8 3.19.0-dev3 3.5.0-dev8 3.19.0-dev4 3.5.0-dev9 3.19.0-dev5 3.5.1 3.19.0-dev6 3.5.2 3.19.1 3.5.3 3.19.2 3.5.4 3.19.3 3.5.5 3.19.4 3.5.6 3.2.0 3.6.0 3.2.1 3.6.0-beta1 3.2.2 3.6.0-beta2 3.2.3 3.6.0-beta3 3.2.4 3.6.0-beta4 3.2.5 3.6.0-beta5 3.20.0 3.6.0-dev1 3.20.0-beta1 3.6.0-dev10 3.20.0-beta2 3.6.1 3.20.0-beta3 3.6.2 3.20.0-beta4 3.6.3 3.20.0-dev1 3.6.4 3.20.0-dev2 3.6.5 3.20.0-dev3 3.6.6 3.20.0-dev4 3.6.7 3.20.1 3.6.8 3.20.2 3.7.0 3.20.3 3.7.0-beta1 3.20.4 3.7.0-beta2 3.21.0 3.7.0-beta3 3.21.0-beta1 3.7.0-beta4 3.21.0-beta2 3.7.0-dev1 3.21.0-beta3 3.7.1 3.21.0-dev1 3.7.2 3.21.0-dev2 3.7.3 3.21.0-dev3 3.7.4 3.21.1 3.7.5 3.21.2 3.7.6 3.21.3 3.7.7 3.21.4 3.7.8 3.21.5 3.8.0 3.21.6 3.8.0-beta1 3.21.7 3.8.0-beta2 3.21.8 3.8.0-beta3 3.22.0 3.8.1 3.22.0-beta1 3.9.0 3.22.0-beta2 3.9.1 3.22.0-beta3 3.9.2 3.22.0-beta4 4.0.0 3.22.0-beta5 4.0.0-beta1 3.22.0-beta6 4.0.0-beta2
elementor / includes / db.php
elementor / includes Last commit date
admin-templates 1 year ago base 2 weeks ago controls 4 months ago editor-templates 2 weeks ago elements 2 weeks ago interfaces 1 year ago libraries 1 year ago managers 2 weeks ago settings 2 months ago template-library 2 weeks ago widgets 2 weeks ago api.php 2 weeks ago autoloader.php 7 months ago beta-testers.php 3 years ago compatibility.php 1 year ago conditions.php 3 years ago db.php 4 months ago editor-assets-api.php 2 months ago embed.php 1 year ago fonts.php 1 year ago frontend.php 1 month ago heartbeat.php 3 years ago maintenance-mode.php 7 months ago maintenance.php 1 year ago plugin.php 1 month ago preview.php 2 weeks ago rollback.php 4 months ago shapes.php 9 months ago stylesheet.php 8 months ago tracker.php 6 months ago user-data.php 7 months ago user.php 5 months ago utils.php 2 weeks ago
db.php
616 lines
1 <?php
2 namespace Elementor;
3
4 use Elementor\Core\Base\Document;
5 use Elementor\Core\DynamicTags\Manager;
6 use Elementor\TemplateLibrary\Source_Local;
7
8 if ( ! defined( 'ABSPATH' ) ) {
9 exit; // Exit if accessed directly.
10 }
11
12 /**
13 * Elementor database.
14 *
15 * Elementor database handler class is responsible for communicating with the
16 * DB, save and retrieve Elementor data and meta data.
17 *
18 * @since 1.0.0
19 */
20 class DB {
21
22 /**
23 * Current DB version of the editor.
24 */
25 const DB_VERSION = '0.4';
26
27 /**
28 * Post publish status.
29 *
30 * @deprecated 3.1.0 Use `Document::STATUS_PUBLISH` const instead.
31 */
32 const STATUS_PUBLISH = Document::STATUS_PUBLISH;
33
34 /**
35 * Post draft status.
36 *
37 * @deprecated 3.1.0 Use `Document::STATUS_DRAFT` const instead.
38 */
39 const STATUS_DRAFT = Document::STATUS_DRAFT;
40
41 /**
42 * Post private status.
43 *
44 * @deprecated 3.1.0 Use `Document::STATUS_PRIVATE` const instead.
45 */
46 const STATUS_PRIVATE = Document::STATUS_PRIVATE;
47
48 /**
49 * Post autosave status.
50 *
51 * @deprecated 3.1.0 Use `Document::STATUS_AUTOSAVE` const instead.
52 */
53 const STATUS_AUTOSAVE = Document::STATUS_AUTOSAVE;
54
55 /**
56 * Post pending status.
57 *
58 * @deprecated 3.1.0 Use `Document::STATUS_PENDING` const instead.
59 */
60 const STATUS_PENDING = Document::STATUS_PENDING;
61
62 /**
63 * Switched post data.
64 *
65 * Holds the switched post data.
66 *
67 * @since 1.5.0
68 * @access protected
69 *
70 * @var array Switched post data. Default is an empty array.
71 */
72 protected $switched_post_data = [];
73
74 /**
75 * Switched data.
76 *
77 * Holds the switched data.
78 *
79 * @since 2.0.0
80 * @access protected
81 *
82 * @var array Switched data. Default is an empty array.
83 */
84 protected $switched_data = [];
85
86 /**
87 * Get builder.
88 *
89 * Retrieve editor data from the database.
90 *
91 * @since 1.0.0
92 * @deprecated 3.1.0 Use `Plugin::$instance->documents->get( $post_id )->get_elements_raw_data( null, true )` OR `Plugin::$instance->documents->get_doc_or_auto_save( $post_id )->get_elements_raw_data( null, true )` instead.
93 * @access public
94 *
95 * @param int $post_id Post ID.
96 * @param string $status Optional. Post status. Default is `publish`.
97 *
98 * @return array Editor data.
99 */
100 public function get_builder( $post_id, $status = Document::STATUS_PUBLISH ) {
101 Plugin::$instance->modules_manager
102 ->get_modules( 'dev-tools' )
103 ->deprecation
104 ->deprecated_function(
105 __METHOD__,
106 '3.1.0',
107 '`Plugin::$instance->documents->get( $post_id )->get_elements_raw_data( null, true )` OR `Plugin::$instance->documents->get_doc_or_auto_save( $post_id )->get_elements_raw_data( null, true )`'
108 );
109
110 if ( Document::STATUS_DRAFT === $status ) {
111 $document = Plugin::$instance->documents->get_doc_or_auto_save( $post_id );
112 } else {
113 $document = Plugin::$instance->documents->get( $post_id );
114 }
115
116 if ( $document ) {
117 $editor_data = $document->get_elements_raw_data( null, true );
118 } else {
119 $editor_data = [];
120 }
121
122 return $editor_data;
123 }
124
125 /**
126 * Get JSON meta.
127 *
128 * Retrieve post meta data, and return the JSON decoded data.
129 *
130 * @since 1.0.0
131 * @access protected
132 *
133 * @param int $post_id Post ID.
134 * @param string $key The meta key to retrieve.
135 *
136 * @return array Decoded JSON data from post meta.
137 */
138 protected function _get_json_meta( $post_id, $key ) {
139 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0' );
140
141 $meta = get_post_meta( $post_id, $key, true );
142
143 if ( is_string( $meta ) && ! empty( $meta ) ) {
144 $meta = json_decode( $meta, true );
145 }
146
147 if ( empty( $meta ) ) {
148 $meta = [];
149 }
150
151 return $meta;
152 }
153
154 /**
155 * Is using Elementor.
156 *
157 * Set whether the page is using Elementor or not.
158 *
159 * @since 1.5.0
160 * @deprecated 3.1.0 Use `Plugin::$instance->documents->get( $post_id )->set_is_build_with_elementor( $is_elementor )` instead.
161 * @access public
162 *
163 * @param int $post_id Post ID.
164 * @param bool $is_elementor Optional. Whether the page is elementor page.
165 * Default is true.
166 */
167 public function set_is_elementor_page( $post_id, $is_elementor = true ) {
168 Plugin::$instance->modules_manager
169 ->get_modules( 'dev-tools' )
170 ->deprecation
171 ->deprecated_function(
172 __METHOD__,
173 '3.1.0',
174 'Plugin::$instance->documents->get( $post_id )->set_is_build_with_elementor( $is_elementor )'
175 );
176
177 $document = Plugin::$instance->documents->get( $post_id );
178
179 if ( ! $document ) {
180 return;
181 }
182
183 $document->set_is_built_with_elementor( $is_elementor );
184 }
185
186 /**
187 * Render element plain content.
188 *
189 * When saving data in the editor, this method renders recursively the plain
190 * content containing only the content and the HTML. No CSS data.
191 *
192 * @since 2.0.0
193 * @access private
194 *
195 * @param array $element_data Element data.
196 */
197 private function render_element_plain_content( $element_data ) {
198 if ( 'widget' === $element_data['elType'] ) {
199 /** @var Widget_Base $widget */
200 $widget = Plugin::$instance->elements_manager->create_element_instance( $element_data );
201
202 if ( $widget ) {
203 $widget->render_plain_content();
204 }
205 }
206
207 if ( ! empty( $element_data['elements'] ) ) {
208 foreach ( $element_data['elements'] as $element ) {
209 $this->render_element_plain_content( $element );
210 }
211 }
212 }
213
214 /**
215 * Save plain text.
216 *
217 * Retrieves the raw content, removes all kind of unwanted HTML tags and saves
218 * the content as the `post_content` field in the database.
219 *
220 * @since 1.9.0
221 * @access public
222 *
223 * @param int $post_id Post ID.
224 */
225 public function save_plain_text( $post_id ) {
226 // Switch $dynamic_tags to parsing mode = remove.
227 $dynamic_tags = Plugin::$instance->dynamic_tags;
228 $parsing_mode = $dynamic_tags->get_parsing_mode();
229 $dynamic_tags->set_parsing_mode( Manager::MODE_REMOVE );
230
231 $plain_text = $this->get_plain_text( $post_id );
232
233 wp_update_post(
234 [
235 'ID' => $post_id,
236 'post_content' => $plain_text,
237 ]
238 );
239
240 // Restore parsing mode.
241 $dynamic_tags->set_parsing_mode( $parsing_mode );
242 }
243
244 /**
245 * Iterate data.
246 *
247 * Accept any type of Elementor data and a callback function. The callback
248 * function runs recursively for each element and his child elements.
249 *
250 * @since 1.0.0
251 * @access public
252 *
253 * @param array $data_container Any type of elementor data.
254 * @param callable $callback A function to iterate data by.
255 * @param array $args Array of args pointers for passing parameters in & out of the callback.
256 *
257 * @return mixed Iterated data.
258 */
259 public function iterate_data( $data_container, $callback, $args = [] ) {
260 if ( isset( $data_container['elType'] ) ) {
261 if ( ! empty( $data_container['elements'] ) ) {
262 $data_container['elements'] = $this->iterate_data( $data_container['elements'], $callback, $args );
263 }
264
265 return call_user_func( $callback, $data_container, $args );
266 }
267
268 foreach ( $data_container as $element_key => $element_value ) {
269 $element_data = $this->iterate_data( $data_container[ $element_key ], $callback, $args );
270
271 if ( null === $element_data ) {
272 continue;
273 }
274
275 $data_container[ $element_key ] = $element_data;
276 }
277
278 return $data_container;
279 }
280
281 public static function iterate_elementor_documents( $callback, $batch_size = 100, $additional_post_types = [] ) {
282 $processed_posts = 0;
283
284 while ( true ) {
285 $args = wp_parse_args( [
286 'post_type' => array_merge( [ Source_Local::CPT, 'post', 'page' ], $additional_post_types ),
287 'post_status' => [ 'publish' ],
288 'posts_per_page' => $batch_size,
289 'meta_key' => Document::BUILT_WITH_ELEMENTOR_META_KEY,
290 'meta_value' => 'builder',
291 'offset' => $processed_posts,
292 'fields' => 'ids',
293 ] );
294
295 $query = new \WP_Query( $args );
296
297 if ( empty( $query->posts ) ) {
298 break;
299 }
300
301 foreach ( $query->posts as $post_id ) {
302 $document = Plugin::$instance->documents->get( $post_id );
303 $elements_data = $document->get_json_meta( Document::ELEMENTOR_DATA_META_KEY );
304
305 $callback( $document, $elements_data );
306
307 ++$processed_posts;
308 }
309 }
310 }
311
312 /**
313 * Safely copy Elementor meta.
314 *
315 * Make sure the original page was built with Elementor and the post is not
316 * auto-save. Only then copy elementor meta from one post to another using
317 * `copy_elementor_meta()`.
318 *
319 * @since 1.9.2
320 * @access public
321 *
322 * @param int $from_post_id Original post ID.
323 * @param int $to_post_id Target post ID.
324 */
325 public function safe_copy_elementor_meta( $from_post_id, $to_post_id ) {
326 // It's from WP-Admin & not from Elementor.
327 if ( ! did_action( 'elementor/db/before_save' ) ) {
328 $from_document = Plugin::$instance->documents->get( $from_post_id );
329
330 if ( ! $from_document || ! $from_document->is_built_with_elementor() ) {
331 return;
332 }
333
334 // It's an exited Elementor auto-save.
335 if ( get_post_meta( $to_post_id, '_elementor_data', true ) ) {
336 return;
337 }
338 }
339
340 $this->copy_elementor_meta( $from_post_id, $to_post_id );
341 }
342
343 /**
344 * Copy Elementor meta.
345 *
346 * Duplicate the data from one post to another.
347 *
348 * Consider using `safe_copy_elementor_meta()` method instead.
349 *
350 * @since 1.1.0
351 * @access public
352 *
353 * @param int $from_post_id Original post ID.
354 * @param int $to_post_id Target post ID.
355 * @param ?array $specific_meta_keys Optional. Specific meta keys to copy. Default is null, which copies all elementor meta keys.
356 */
357 public function copy_elementor_meta( $from_post_id, $to_post_id, $specific_meta_keys = null ) {
358 $from_post_meta = get_post_meta( $from_post_id );
359 $core_meta = [
360 '_wp_page_template',
361 '_thumbnail_id',
362 ];
363
364 foreach ( $from_post_meta as $meta_key => $values ) {
365 if ( $specific_meta_keys && ! in_array( $meta_key, $specific_meta_keys, true ) ) {
366 continue;
367 }
368
369 // Copy only meta with the `_elementor` prefix.
370 if ( 0 === strpos( $meta_key, '_elementor' ) || in_array( $meta_key, $core_meta, true ) ) {
371 $value = $values[0];
372
373 // The elementor JSON needs slashes before saving.
374 if ( '_elementor_data' === $meta_key ) {
375 $value = wp_slash( $value );
376 } else {
377 $value = maybe_unserialize( $value );
378 }
379
380 // Don't use `update_post_meta` that can't handle `revision` post type.
381 update_metadata( 'post', $to_post_id, $meta_key, $value );
382 }
383 }
384 }
385
386 /**
387 * Is built with Elementor.
388 *
389 * Check whether the post was built with Elementor.
390 *
391 * @since 1.0.10
392 * @deprecated 3.2.0 Use `Plugin::$instance->documents->get( $post_id )->is_built_with_elementor()` instead.
393 * @access public
394 *
395 * @param int $post_id Post ID.
396 *
397 * @return bool Whether the post was built with Elementor.
398 */
399 public function is_built_with_elementor( $post_id ) {
400 Plugin::$instance->modules_manager
401 ->get_modules( 'dev-tools' )
402 ->deprecation
403 ->deprecated_function(
404 __METHOD__,
405 '3.2.0',
406 'Plugin::$instance->documents->get( $post_id )->is_built_with_elementor()'
407 );
408
409 $document = Plugin::$instance->documents->get( $post_id );
410
411 if ( ! $document ) {
412 return false;
413 }
414
415 return $document->is_built_with_elementor();
416 }
417
418 /**
419 * Switch to post.
420 *
421 * Change the global WordPress post to the requested post.
422 *
423 * @since 1.5.0
424 * @access public
425 *
426 * @param int $post_id Post ID to switch to.
427 */
428 public function switch_to_post( $post_id ) {
429 $post_id = absint( $post_id );
430 // If is already switched, or is the same post, return.
431 if ( get_the_ID() === $post_id ) {
432 $this->switched_post_data[] = false;
433 return;
434 }
435
436 $this->switched_post_data[] = [
437 'switched_id' => $post_id,
438 'original_id' => get_the_ID(), // Note, it can be false if the global isn't set.
439 ];
440
441 $GLOBALS['post'] = get_post( $post_id ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
442
443 setup_postdata( $GLOBALS['post'] );
444 }
445
446 /**
447 * Restore current post.
448 *
449 * Rollback to the previous global post, rolling back from `DB::switch_to_post()`.
450 *
451 * @since 1.5.0
452 * @access public
453 */
454 public function restore_current_post() {
455 $data = array_pop( $this->switched_post_data );
456
457 // If not switched, return.
458 if ( ! $data ) {
459 return;
460 }
461
462 // It was switched from an empty global post, restore this state and unset the global post.
463 if ( false === $data['original_id'] ) {
464 unset( $GLOBALS['post'] );
465 return;
466 }
467
468 $GLOBALS['post'] = get_post( $data['original_id'] ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
469
470 setup_postdata( $GLOBALS['post'] );
471 }
472
473
474 /**
475 * Switch to query.
476 *
477 * Change the WordPress query to a new query with the requested
478 * query variables.
479 *
480 * @since 2.0.0
481 * @access public
482 *
483 * @param array $query_vars New query variables.
484 * @param bool $force_global_post
485 */
486 public function switch_to_query( $query_vars, $force_global_post = false ) {
487 global $wp_query;
488 $current_query_vars = $wp_query->query;
489
490 // If is already switched, or is the same query, return.
491 if ( $current_query_vars === $query_vars ) {
492 $this->switched_data[] = false;
493 return;
494 }
495
496 $new_query = new \WP_Query( $query_vars );
497
498 $switched_data = [
499 'switched' => $new_query,
500 'original' => $wp_query,
501 ];
502
503 if ( ! empty( $GLOBALS['post'] ) ) {
504 $switched_data['post'] = $GLOBALS['post'];
505 }
506
507 $this->switched_data[] = $switched_data;
508
509 $wp_query = $new_query; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
510
511 // Ensure the global post is set only if needed.
512 unset( $GLOBALS['post'] );
513
514 if ( isset( $new_query->posts[0] ) ) {
515 if ( $force_global_post || $new_query->is_singular() ) {
516 $GLOBALS['post'] = $new_query->posts[0]; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
517 setup_postdata( $GLOBALS['post'] );
518 }
519 }
520
521 if ( $new_query->is_author() ) {
522 $GLOBALS['authordata'] = get_userdata( $new_query->get( 'author' ) ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
523 }
524 }
525
526 /**
527 * Restore current query.
528 *
529 * Rollback to the previous query, rolling back from `DB::switch_to_query()`.
530 *
531 * @since 2.0.0
532 * @access public
533 */
534 public function restore_current_query() {
535 $data = array_pop( $this->switched_data );
536
537 // If not switched, return.
538 if ( ! $data ) {
539 return;
540 }
541
542 global $wp_query;
543
544 $wp_query = $data['original']; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
545
546 // Ensure the global post/authordata is set only if needed.
547 unset( $GLOBALS['post'] );
548 unset( $GLOBALS['authordata'] );
549
550 if ( ! empty( $data['post'] ) ) {
551 $GLOBALS['post'] = $data['post']; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
552 setup_postdata( $GLOBALS['post'] );
553 }
554
555 if ( $wp_query->is_author() ) {
556 $GLOBALS['authordata'] = get_userdata( $wp_query->get( 'author' ) ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
557 }
558 }
559
560 /**
561 * Get plain text.
562 *
563 * Retrieve the post plain text.
564 *
565 * @since 1.9.0
566 * @access public
567 *
568 * @param int $post_id Post ID.
569 *
570 * @return string Post plain text.
571 */
572 public function get_plain_text( $post_id ) {
573 $document = Plugin::$instance->documents->get( $post_id );
574 $data = $document ? $document->get_elements_data() : [];
575
576 return $this->get_plain_text_from_data( $data );
577 }
578
579 /**
580 * Get plain text from data.
581 *
582 * Retrieve the post plain text from any given Elementor data.
583 *
584 * @since 1.9.2
585 * @access public
586 *
587 * @param array $data Post ID.
588 *
589 * @return string Post plain text.
590 */
591 public function get_plain_text_from_data( $data ) {
592 ob_start();
593 if ( $data ) {
594 foreach ( $data as $element_data ) {
595 $this->render_element_plain_content( $element_data );
596 }
597 }
598
599 $plain_text = ob_get_clean();
600
601 // Remove unnecessary tags.
602 $plain_text = preg_replace( '/<\/?div[^>]*\>/i', '', $plain_text );
603 $plain_text = preg_replace( '/<\/?span[^>]*\>/i', '', $plain_text );
604 $plain_text = preg_replace( '#<script(.*?)>(.*?)</script>#is', '', $plain_text );
605 $plain_text = preg_replace( '/<i [^>]*><\\/i[^>]*>/', '', $plain_text );
606 $plain_text = preg_replace( '/ class=".*?"/', '', $plain_text );
607
608 // Remove empty lines.
609 $plain_text = preg_replace( '/(^[\r\n]*|[\r\n]+)[\s\t]*[\r\n]+/', "\n", $plain_text );
610
611 $plain_text = trim( $plain_text );
612
613 return $plain_text;
614 }
615 }
616