elementor / modules / global-classes / global-class-post.php

global-class-post.php in Elementor Website Builder – more than just a page builder 4.2.0-dev2, at modules/global-classes/global-class-post.php

318 lines 8.1 KB

Raw Download Zip

1	<?php
2
3	namespace Elementor\Modules\GlobalClasses;
4
5	use Elementor\Modules\AtomicWidgets\PropTypeMigrations\Migrations_Orchestrator;
6	use Elementor\Modules\GlobalClasses\Concerns\Has_Preview_Context;
7	use Elementor\Plugin;
8	use Elementor\Core\Kits\Documents\Kit;
9	use Elementor\Modules\GlobalClasses\Utils\Global_Class_Data_Normalizer;
10	use WP_Post;
11
12	if ( ! defined( 'ABSPATH' ) ) {
13	exit; // Exit if accessed directly.
14	}
15
16	class Global_Class_Post {
17	use Has_Preview_Context;
18
19	const META_KEY_VERSION = '_elementor_version';
20	const META_KEY_ID = '_elementor_global_class_id';
21	const META_KEY_DATA = '_elementor_global_class_data';
22	const META_KEY_DATA_PREVIEW = '_elementor_global_class_data_preview';
23	const META_KEY_EDITED = '_elementor_global_class_edited';
24
25	protected array $context_keys = [
26	'data' => [
27	'frontend' => self::META_KEY_DATA,
28	'preview' => self::META_KEY_DATA_PREVIEW,
29	],
30	];
31
32	private WP_Post $post;
33
34	private function __construct( WP_Post $post ) {
35	$this->post = $post;
36	}
37
38	public static function from_post( WP_Post $post, bool $is_preview = false ): self {
39	return ( new static( $post ) )->set_preview( $is_preview );
40	}
41
42	public static function from_post_id( int $post_id, bool $is_preview = false ): ?self {
43	$post = get_post( $post_id );
44
45	if ( ! $post \|\| Global_Class_Post_Type::CPT !== $post->post_type ) {
46	return null;
47	}
48
49	return ( new static( $post ) )->set_preview( $is_preview );
50	}
51
52	public static function find_by_class_id( string $class_id, bool $is_preview = false, ?Kit $kit = null ): ?self {
53	$kit = $kit ?? Plugin::$instance->kits_manager->get_active_kit();
54
55	if ( ! $kit ) {
56	return null;
57	}
58
59	$post_id = Global_Classes_Post_IDs::make( $kit )->get_post_id( $class_id );
60
61	if ( ! $post_id ) {
62	return null;
63	}
64
65	return self::from_post_id( $post_id, $is_preview );
66	}
67
68	public function get_post_id(): int {
69	return $this->post->ID;
70	}
71
72	public function get_class_id(): string {
73	$class_id = get_post_meta( $this->post->ID, self::META_KEY_ID, true );
74
75	if ( ! $class_id ) {
76	return '';
77	}
78
79	return $class_id;
80	}
81
82	public function get_label(): string {
83	return $this->post->post_title;
84	}
85
86	public function get_data( bool $skip_migration = false ): array {
87	$data = $this->get_context_data();
88	$meta_key = $this->get_context_key( 'data' );
89
90	// Empty preview (draft) - use frontend (published) data
91	if ( empty( $data ) && $this->is_preview() ) {
92	$data = $this->get_frontend_data();
93	$meta_key = self::META_KEY_DATA;
94	}
95
96	if ( ! empty( $data ) && ( ! $skip_migration ) ) {
97	$this->migrate_data( $data, $meta_key );
98	}
99
100	return $data;
101	}
102
103	private function migrate_data( array &$data, string $meta_key ): void {
104	if ( ! Migrations_Orchestrator::is_active() ) {
105	return;
106	}
107
108	$post_id = $this->post->ID;
109
110	Migrations_Orchestrator::make()->migrate(
111	$data,
112	$post_id,
113	$meta_key,
114	function ( $migrated ) use ( $post_id, $meta_key ) {
115	update_post_meta( $post_id, $meta_key, $migrated );
116	clean_post_cache( $post_id );
117	}
118	);
119	}
120
121	public function to_array( bool $skip_migration = false ): array {
122	$data = $this->get_data( $skip_migration );
123
124	$class_id = $this->get_class_id();
125
126	return Global_Class_Data_Normalizer::normalize_style(
127	$class_id,
128	array_merge( $data, [ 'label' => $this->get_label() ] )
129	);
130	}
131
132	public function was_edited(): bool {
133	$last_edited = $this->get_last_edited_timestamp();
134	$creation = $this->get_creation_timestamp();
135
136	return $last_edited > $creation;
137	}
138
139	public function has_edit_timestamp(): bool {
140	return $this->get_last_edited_timestamp() > 0;
141	}
142
143	private function get_creation_timestamp(): int {
144	$dt = get_post_datetime( $this->post, 'date', 'gmt' );
145
146	if ( $dt ) {
147	return (int) $dt->format( 'U' );
148	}
149
150	return (int) strtotime( (string) $this->post->post_date );
151	}
152
153	private function get_last_edited_timestamp(): int {
154	$raw = get_post_meta( $this->post->ID, self::META_KEY_EDITED, true );
155
156	if ( self::is_timestamp( $raw ) ) {
157	return (int) $raw;
158	}
159
160	return 0;
161	}
162
163	private static function is_timestamp( $value ): bool {
164	if ( ! is_numeric( $value ) ) {
165	return false;
166	}
167
168	return (int) $value > 0;
169	}
170
171	protected function get_current_timestamp(): int {
172	return (int) time();
173	}
174
175	public function update_label( string $label ): bool {
176	$result = wp_update_post( [
177	'ID' => $this->post->ID,
178	'post_title' => $label,
179	] );
180
181	if ( ! is_wp_error( $result ) && ! $this->is_preview() ) {
182	update_post_meta( $this->post->ID, self::META_KEY_EDITED, $this->get_current_timestamp() );
183	}
184
185	return ! is_wp_error( $result );
186	}
187
188	private function get_context_data(): array {
189	$data = get_post_meta( $this->post->ID, $this->get_context_key( 'data' ), true );
190
191	return is_array( $data ) ? $data : [];
192	}
193
194	private function get_frontend_data(): array {
195	$data = get_post_meta( $this->post->ID, self::META_KEY_DATA, true );
196
197	return is_array( $data ) ? $data : [];
198	}
199
200	private function get_preview_data(): array {
201	$data = get_post_meta( $this->post->ID, self::META_KEY_DATA_PREVIEW, true );
202
203	return is_array( $data ) ? $data : [];
204	}
205
206	private function get_version(): string {
207	$version = get_post_meta( $this->post->ID, self::META_KEY_VERSION, true );
208
209	return is_string( $version ) ? $version : '';
210	}
211
212	public function update_data(
213	array $data,
214	string $version = ELEMENTOR_VERSION
215	): bool {
216	$meta_key = $this->get_context_key( 'data' );
217
218	$result = update_post_meta( $this->post->ID, $meta_key, $data );
219
220	if ( ! $this->is_preview() ) {
221	delete_post_meta( $this->post->ID, self::META_KEY_DATA_PREVIEW );
222	}
223
224	update_post_meta( $this->post->ID, self::META_KEY_VERSION, $version );
225
226	if ( ! $this->is_preview() ) {
227	update_post_meta( $this->post->ID, self::META_KEY_EDITED, $this->get_current_timestamp() );
228	}
229
230	return false !== $result;
231	}
232
233	public static function create(
234	string $class_id,
235	string $label,
236	array $data,
237	?Kit $kit = null,
238	string $version = ELEMENTOR_VERSION
239	): ?self {
240	$post_id = wp_insert_post( [
241	'post_type' => Global_Class_Post_Type::CPT,
242	'post_title' => $label,
243	'post_status' => 'publish',
244	] );
245
246	if ( is_wp_error( $post_id ) \|\| ! $post_id ) {
247	return null;
248	}
249
250	$normalized_data = Global_Class_Data_Normalizer::normalize_style_fields( $data );
251
252	update_post_meta( $post_id, self::META_KEY_ID, $class_id );
253	update_post_meta( $post_id, self::META_KEY_DATA, $normalized_data );
254	update_post_meta( $post_id, self::META_KEY_VERSION, $version );
255
256	$kit = $kit ?? Plugin::$instance->kits_manager->get_active_kit();
257
258	if ( $kit ) {
259	Global_Classes_Post_IDs::make( $kit )->set( $class_id, (int) $post_id );
260	}
261
262	$instance = self::from_post_id( $post_id );
263
264	if ( $instance ) {
265	update_post_meta( $post_id, self::META_KEY_EDITED, $instance->get_creation_timestamp() );
266	}
267
268	return $instance;
269	}
270
271	public function delete(): bool {
272	$result = wp_delete_post( $this->post->ID, true );
273
274	return false !== $result;
275	}
276
277	public static function clone_to_other_kit( string $style_id, Kit $source_kit, Kit $target_kit ): ?Global_Class_Post {
278	$source_post = self::find_by_class_id( $style_id, false, $source_kit );
279
280	if ( ! $source_post ) {
281	return null;
282	}
283
284	$new_post_id = wp_insert_post( [
285	'post_type' => Global_Class_Post_Type::CPT,
286	'post_title' => $source_post->get_label(),
287	'post_status' => 'publish',
288	] );
289
290	if ( is_wp_error( $new_post_id ) \|\| ! $new_post_id ) {
291	return null;
292	}
293
294	update_post_meta( $new_post_id, self::META_KEY_ID, $style_id );
295	update_post_meta( $new_post_id, self::META_KEY_VERSION, $source_post->get_version() );
296
297	$frontend_data = $source_post->get_frontend_data();
298	$preview_data = $source_post->get_preview_data();
299	$last_edited_timestamp = get_post_meta( $source_post->get_post_id(), self::META_KEY_EDITED, true );
300
301	if ( ! empty( $frontend_data ) ) {
302	update_post_meta( $new_post_id, self::META_KEY_DATA, $frontend_data );
303	}
304
305	if ( ! empty( $preview_data ) ) {
306	update_post_meta( $new_post_id, self::META_KEY_DATA_PREVIEW, $preview_data );
307	}
308
309	if ( $last_edited_timestamp ) {
310	update_post_meta( $new_post_id, self::META_KEY_EDITED, $last_edited_timestamp );
311	}
312
313	Global_Classes_Post_IDs::make( $target_kit )->set( $style_id, (int) $new_post_id );
314
315	return self::from_post_id( $new_post_id );
316	}
317	}
318