jetpack / jetpack_vendor / automattic / jetpack-sync / src / modules / class-attachments.php

class-attachments.php in Jetpack – WP Security, Backup, Speed, & Growth 16.3-a.7, at jetpack_vendor/automattic/jetpack-sync/src/modules/class-attachments.php

103 lines 2.8 KB

Raw Download Zip

1	<?php
2	/**
3	* Attachments sync module.
4	*
5	* @package automattic/jetpack-sync
6	*/
7
8	namespace Automattic\Jetpack\Sync\Modules;
9
10	if ( ! defined( 'ABSPATH' ) ) {
11	exit( 0 );
12	}
13
14	/**
15	* Class to handle sync for attachments.
16	*/
17	class Attachments extends Module {
18	/**
19	* Sync module name.
20	*
21	* @access public
22	*
23	* @return string
24	*/
25	public function name() {
26	return 'attachments';
27	}
28
29	/**
30	* Initialize attachment action listeners.
31	*
32	* @access public
33	*
34	* @param callable $callable Action handler callable.
35	*/
36	public function init_listeners( $callable ) {
37	add_action( 'add_attachment', array( $this, 'process_add' ) );
38	add_action( 'attachment_updated', array( $this, 'process_update' ), 10, 3 );
39	add_action( 'jetpack_sync_save_update_attachment', $callable, 10, 2 );
40	add_action( 'jetpack_sync_save_add_attachment', $callable, 10, 2 );
41	add_action( 'jetpack_sync_save_attach_attachment', $callable, 10, 2 );
42	}
43
44	/**
45	* Handle the creation of a new attachment.
46	*
47	* @access public
48	*
49	* @param int $attachment_id ID of the attachment.
50	*/
51	public function process_add( $attachment_id ) {
52	$attachment = get_post( $attachment_id );
53	/**
54	* Fires when the client needs to sync an new attachment
55	*
56	* @since 1.6.3
57	* @since-jetpack 4.2.0
58	*
59	* @param int Attachment ID.
60	* @param \WP_Post Attachment post object.
61	*/
62	do_action( 'jetpack_sync_save_add_attachment', $attachment_id, $attachment );
63	}
64
65	/**
66	* Handle updating an existing attachment.
67	*
68	* @access public
69	*
70	* @param int $attachment_id Attachment ID.
71	* @param \WP_Post $attachment_after Attachment post object before the update.
72	* @param \WP_Post $attachment_before Attachment post object after the update.
73	*/
74	public function process_update( $attachment_id, $attachment_after, $attachment_before ) {
75	// Check whether attachment was added to a post for the first time.
76	if ( 0 === $attachment_before->post_parent && 0 !== $attachment_after->post_parent ) {
77	/**
78	* Fires when an existing attachment is added to a post for the first time
79	*
80	* @since 1.6.3
81	* @since-jetpack 6.6.0
82	*
83	* @param int $attachment_id Attachment ID.
84	* @param \WP_Post $attachment_after Attachment post object after the update.
85	*/
86	do_action( 'jetpack_sync_save_attach_attachment', $attachment_id, $attachment_after );
87	} else {
88	/**
89	* Fires when the client needs to sync an updated attachment
90	*
91	* @since 1.6.3
92	* @since-jetpack 4.9.0
93	*
94	* @param int $attachment_id Attachment ID.
95	* @param \WP_Post $attachment_after Attachment post object after the update.
96	*
97	* Previously this action was synced using jetpack_sync_save_add_attachment action.
98	*/
99	do_action( 'jetpack_sync_save_update_attachment', $attachment_id, $attachment_after );
100	}
101	}
102	}
103