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

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

322 lines 8.3 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	$post_id = $this->post->ID;
105
106	Migrations_Orchestrator::make()->migrate(
107	$data,
108	$post_id,
109	$meta_key,
110	function ( $migrated ) use ( $post_id, $meta_key ) {
111	update_post_meta( $post_id, $meta_key, $migrated );
112	clean_post_cache( $post_id );
113	}
114	);
115	}
116
117	public function to_array( bool $skip_migration = false ): array {
118	$data = $this->get_data( $skip_migration );
119
120	$class_id = $this->get_class_id();
121
122	return Global_Class_Data_Normalizer::normalize_style(
123	$class_id,
124	array_merge( $data, [ 'label' => $this->get_label() ] )
125	);
126	}
127
128	public function was_edited(): bool {
129	$last_edited = $this->get_last_edited_timestamp();
130	$creation = $this->get_creation_timestamp();
131
132	return $last_edited > $creation;
133	}
134
135	public function has_edit_timestamp(): bool {
136	return $this->get_last_edited_timestamp() > 0;
137	}
138
139	private function get_creation_timestamp(): int {
140	$dt = get_post_datetime( $this->post, 'date', 'gmt' );
141
142	if ( $dt ) {
143	return (int) $dt->format( 'U' );
144	}
145
146	return (int) strtotime( (string) $this->post->post_date );
147	}
148
149	private function get_last_edited_timestamp(): int {
150	$raw = get_post_meta( $this->post->ID, self::META_KEY_EDITED, true );
151
152	if ( self::is_timestamp( $raw ) ) {
153	return (int) $raw;
154	}
155
156	return 0;
157	}
158
159	private static function is_timestamp( $value ): bool {
160	if ( ! is_numeric( $value ) ) {
161	return false;
162	}
163
164	return (int) $value > 0;
165	}
166
167	protected function get_current_timestamp(): int {
168	return (int) time();
169	}
170
171	public function update_label( string $label ): bool {
172	$result = wp_update_post( [
173	'ID' => $this->post->ID,
174	'post_title' => $label,
175	] );
176
177	if ( ! is_wp_error( $result ) && ! $this->is_preview() ) {
178	update_post_meta( $this->post->ID, self::META_KEY_EDITED, $this->get_current_timestamp() );
179	}
180
181	return ! is_wp_error( $result );
182	}
183
184	private function get_context_data(): array {
185	$data = get_post_meta( $this->post->ID, $this->get_context_key( 'data' ), true );
186
187	return is_array( $data ) ? $data : [];
188	}
189
190	private function get_frontend_data(): array {
191	$data = get_post_meta( $this->post->ID, self::META_KEY_DATA, true );
192
193	return is_array( $data ) ? $data : [];
194	}
195
196	private function get_preview_data(): array {
197	$data = get_post_meta( $this->post->ID, self::META_KEY_DATA_PREVIEW, true );
198
199	return is_array( $data ) ? $data : [];
200	}
201
202	private function get_version(): string {
203	$version = get_post_meta( $this->post->ID, self::META_KEY_VERSION, true );
204
205	return is_string( $version ) ? $version : '';
206	}
207
208	public function update_data(
209	array $data,
210	string $version = ELEMENTOR_VERSION
211	): bool {
212	$meta_key = $this->get_context_key( 'data' );
213
214	$result = update_post_meta( $this->post->ID, $meta_key, $data );
215
216	if ( ! $this->is_preview() ) {
217	delete_post_meta( $this->post->ID, self::META_KEY_DATA_PREVIEW );
218	}
219
220	update_post_meta( $this->post->ID, self::META_KEY_VERSION, $version );
221
222	if ( ! $this->is_preview() ) {
223	update_post_meta( $this->post->ID, self::META_KEY_EDITED, $this->get_current_timestamp() );
224	}
225
226	return false !== $result;
227	}
228
229	public static function create(
230	string $class_id,
231	string $label,
232	array $data,
233	?Kit $kit = null,
234	string $version = ELEMENTOR_VERSION
235	): ?self {
236	$post_id = wp_insert_post( [
237	'post_type' => Global_Class_Post_Type::CPT,
238	'post_title' => $label,
239	'post_status' => 'publish',
240	] );
241
242	if ( is_wp_error( $post_id ) \|\| ! $post_id ) {
243	return null;
244	}
245
246	$normalized_data = Global_Class_Data_Normalizer::normalize_style_fields( $data );
247
248	update_post_meta( $post_id, self::META_KEY_ID, $class_id );
249	update_post_meta( $post_id, self::META_KEY_DATA, $normalized_data );
250	update_post_meta( $post_id, self::META_KEY_VERSION, $version );
251
252	$kit = $kit ?? Plugin::$instance->kits_manager->get_active_kit();
253
254	if ( $kit ) {
255	Global_Classes_Post_IDs::make( $kit )->set( $class_id, (int) $post_id );
256	}
257
258	$instance = self::from_post_id( $post_id );
259
260	if ( $instance ) {
261	update_post_meta( $post_id, self::META_KEY_EDITED, $instance->get_creation_timestamp() );
262	}
263
264	return $instance;
265	}
266
267	public function delete(): bool {
268	$result = wp_delete_post( $this->post->ID, true );
269
270	return false !== $result;
271	}
272
273	public function clone( Kit $target_kit ): ?self {
274	return self::clone_to_kit( $this->get_class_id(), $this, $target_kit );
275	}
276
277	public static function clone_to_other_kit( string $style_id, Kit $source_kit, Kit $target_kit ): ?self {
278	$source_post = self::find_by_class_id( $style_id, false, $source_kit );
279
280	if ( ! $source_post ) {
281	return null;
282	}
283
284	return self::clone_to_kit( $style_id, $source_post, $target_kit );
285	}
286
287	private static function clone_to_kit( string $style_id, self $source_post, Kit $target_kit ): ?self {
288	$new_post_id = wp_insert_post( [
289	'post_type' => Global_Class_Post_Type::CPT,
290	'post_title' => $source_post->get_label(),
291	'post_status' => 'publish',
292	] );
293
294	if ( is_wp_error( $new_post_id ) \|\| ! $new_post_id ) {
295	return null;
296	}
297
298	update_post_meta( $new_post_id, self::META_KEY_ID, $style_id );
299	update_post_meta( $new_post_id, self::META_KEY_VERSION, $source_post->get_version() );
300
301	$frontend_data = $source_post->get_frontend_data();
302	$preview_data = $source_post->get_preview_data();
303	$last_edited_timestamp = get_post_meta( $source_post->get_post_id(), self::META_KEY_EDITED, true );
304
305	if ( ! empty( $frontend_data ) ) {
306	update_post_meta( $new_post_id, self::META_KEY_DATA, $frontend_data );
307	}
308
309	if ( ! empty( $preview_data ) ) {
310	update_post_meta( $new_post_id, self::META_KEY_DATA_PREVIEW, $preview_data );
311	}
312
313	if ( $last_edited_timestamp ) {
314	update_post_meta( $new_post_id, self::META_KEY_EDITED, $last_edited_timestamp );
315	}
316
317	Global_Classes_Post_IDs::make( $target_kit )->set( $style_id, (int) $new_post_id );
318
319	return self::from_post_id( $new_post_id );
320	}
321	}
322