jetpack / jetpack_vendor / automattic / jetpack-publicize / src / class-publicize-base.php

class-publicize-base.php in Jetpack – WP Security, Backup, Speed, & Growth 16.3-beta, at jetpack_vendor/automattic/jetpack-publicize/src/class-publicize-base.php

2,198 lines 69.4 KB

Raw Download Zip

1	<?php
2	/**
3	* Publicize_Base class.
4	*
5	* @package automattic/jetpack-publicize
6	*/
7
8	// phpcs:disable WordPress.NamingConventions.ValidVariableName
9
10	namespace Automattic\Jetpack\Publicize;
11
12	use Automattic\Jetpack\Connection\Client;
13	use Automattic\Jetpack\Current_Plan;
14	use Automattic\Jetpack\Paths;
15	use Automattic\Jetpack\Redirect;
16	use Automattic\Jetpack\Status;
17	use WP_Error;
18	use WP_Post;
19
20	/**
21	* Base class for Publicize.
22	*/
23	abstract class Publicize_Base {
24
25	/**
26	* Services that are currently connected to the given user
27	* through Publicize.
28	*
29	* @var array
30	*/
31	public $connected_services = array();
32
33	/**
34	* Services that are supported by publicize. They don't
35	* necessarily need to be connected to the current user.
36	*
37	* @var array
38	*/
39	public $services;
40
41	/**
42	* Post meta key for admin page.
43	*
44	* @var string
45	*/
46	public $ADMIN_PAGE = 'wpas';
47
48	/**
49	* Post meta key for post message.
50	*
51	* @var string
52	*/
53	public $POST_MESS = '_wpas_mess';
54
55	/**
56	* Post meta key for the flagging when the post share feature is disabled.
57	*
58	* @var string
59	*/
60	const POST_PUBLICIZE_FEATURE_ENABLED = '_wpas_feature_enabled';
61
62	/**
63	* Post meta key for Jetpack Social options.
64	*
65	* @var string
66	*/
67	const POST_JETPACK_SOCIAL_OPTIONS = '_wpas_options';
68
69	/**
70	* Post meta key for per-connection customization overrides.
71	*
72	* @var string
73	*/
74	const POST_CONNECTION_OVERRIDES = '_wpas_connection_overrides';
75
76	/**
77	* Post meta key for enabling per-network customization.
78	*
79	* @var string
80	*/
81	const POST_CUSTOMIZE_PER_NETWORK = '_wpas_customize_per_network';
82
83	/**
84	* Attachment meta key for the social image focal point.
85	*
86	* Stored on the image (attachment), not the post, so a focal point set once is
87	* shared by every post that uses the image.
88	*
89	* @var string
90	*/
91	const ATTACHMENT_IMAGE_FOCAL_POINT = '_jetpack_social_image_focal_point';
92
93	// Skip meta keys. We used to rely on _wpas_skip_ appended with the token_id to skip posts. But to support
94	// multiple connections for the same token, we are going to use the _wpas_skip_publicize_ which
95	// will be appended with the connection_id.
96	/**
97	* Token ID appended to indicate that a connection should NOT be publicized to.
98	*
99	* @var string
100	*/
101	public $POST_SKIP = '_wpas_skip_';
102
103	/**
104	* Connection ID appended to indicate that a connection should NOT be publicized to.
105	*
106	* @var string
107	*/
108	public $POST_SKIP_PUBLICIZE = '_wpas_skip_publicize_';
109
110	// Done meta keys.
111	/**
112	* Token ID appended to indicate a connection has already been publicized to.
113	*
114	* @var string
115	*/
116	public $POST_DONE = '_wpas_done_';
117
118	/**
119	* Prefix for user authorization (used in publicize-wpcom.php)
120	*
121	* @var string
122	*/
123	public $USER_AUTH = 'wpas_authorize';
124
125	/**
126	* Prefix for user opt.
127	*
128	* @var string
129	*/
130	public $USER_OPT = 'wpas_';
131
132	/**
133	* Ready for Publicize to do its thing.
134	*
135	* @var string
136	*/
137	public $PENDING = '_publicize_pending';
138
139	/**
140	* Array of external IDs where we've Publicized.
141	*
142	* @var string
143	*/
144	public $POST_SERVICE_DONE = '_publicize_done_external';
145
146	/**
147	* Option key for dismissing Jetpack Social notices.
148	*
149	* @var string
150	*/
151	const OPTION_JETPACK_SOCIAL_DISMISSED_NOTICES = 'jetpack_social_dismissed_notices';
152
153	/**
154	* The maximum size of an image that can be used as an Open Graph image.
155	*
156	* @var string
157	*/
158	const OG_IMAGE_MAX_FILESIZE = 2000000; // 2MB.
159
160	/**
161	* Default pieces of the message used in constructing the
162	* content pushed out to other social networks.
163	*/
164
165	/**
166	* Default prefix.
167	*
168	* @var string
169	*/
170	public $default_prefix = '';
171
172	/**
173	* Default message.
174	*
175	* @var string
176	*/
177	public $default_message = '%title%';
178
179	/**
180	* Default suffix.
181	*
182	* @var string
183	*/
184	public $default_suffix = ' ';
185
186	/**
187	* What WP capability is require to create/delete global connections?
188	* All users with this cap can un-globalize all other global connections, and globalize any of their own
189	* Globalized connections cannot be unselected by users without this capability when publishing
190	*
191	* @var string
192	*/
193	public $GLOBAL_CAP = 'publish_posts';
194
195	/**
196	* Sets up the basics of Publicize.
197	*/
198	public function __construct() {
199	$this->default_message = self::build_sprintf(
200	array(
201	/**
202	* Filter the default Publicize message.
203	*
204	* @since 0.1.0
205	* @since-jetpack 2.0.0
206	*
207	* @param string $this->default_message Publicize's default message. Default is the post title.
208	*/
209	apply_filters( 'wpas_default_message', $this->default_message ),
210	'title',
211	'url',
212	)
213	);
214
215	$this->default_prefix = self::build_sprintf(
216	array(
217	/**
218	* Filter the message prepended to the Publicize custom message.
219	*
220	* @since 0.1.0
221	* @since-jetpack 2.0.0
222	*
223	* @param string $this->default_prefix String prepended to the Publicize custom message.
224	*/
225	apply_filters( 'wpas_default_prefix', $this->default_prefix ),
226	'url',
227	)
228	);
229
230	$this->default_suffix = self::build_sprintf(
231	array(
232	/**
233	* Filter the message appended to the Publicize custom message.
234	*
235	* @since 0.1.0
236	* @since-jetpack 2.0.0
237	*
238	* @param string $this->default_suffix String appended to the Publicize custom message.
239	*/
240	apply_filters( 'wpas_default_suffix', $this->default_suffix ),
241	'url',
242	)
243	);
244
245	/**
246	* Filter the capability to change global Publicize connection options.
247	*
248	* All users with this cap can un-globalize all other global connections, and globalize any of their own
249	* Globalized connections cannot be unselected by users without this capability when publishing.
250	*
251	* @since 0.1.0
252	* @since-jetpack 2.2.1
253	*
254	* @param string $this->GLOBAL_CAP default capability in control of global Publicize connection options. Default to edit_others_posts.
255	*/
256	$this->GLOBAL_CAP = apply_filters( 'jetpack_publicize_global_connections_cap', $this->GLOBAL_CAP );
257
258	// stage 1 and 2 of 3-stage Publicize. Flag for Publicize on creation, save meta,
259	// then check meta and publicize based on that. stage 3 implemented on wpcom.
260	add_action( 'transition_post_status', array( $this, 'flag_post_for_publicize' ), 10, 3 );
261	add_action( 'save_post', array( $this, 'save_meta' ), 20, 2 );
262
263	// Default checkbox state for each Connection.
264	add_filter( 'publicize_checkbox_default', array( $this, 'publicize_checkbox_default' ), 10, 2 );
265
266	// Add images generated by Social Image Generator to the Open Graph tags on singular posts.
267	add_filter( 'jetpack_open_graph_tags', array( $this, 'add_jetpack_social_og_images' ), 12, 1 ); // $priority = 12, to run after the Twitter_Cards class adds its tags.
268
269	// Alter the "Post Publish" admin notice to mention the Connections we Publicized to.
270	add_filter( 'post_updated_messages', array( $this, 'update_published_message' ), 20, 1 );
271
272	// Custom priority to ensure post type support is added prior to thumbnail support being added to the theme.
273	add_action( 'init', array( $this, 'add_post_type_support' ), 8 );
274	add_action( 'init', array( $this, 'register_post_meta' ), 20 );
275	// Last, so a veto from another filter is respected before any row changes.
276	add_filter( 'update_post_metadata', array( $this, 'collapse_duplicate_post_meta' ), PHP_INT_MAX, 5 );
277
278	// The custom priority for this action ensures that any existing code that
279	// removes post-thumbnails support during 'init' continues to work.
280	add_action( 'init', __NAMESPACE__ . '\add_theme_post_thumbnails_support', 8 );
281	}
282
283	/**
284	* Services: Facebook, Twitter, etc.
285	*/
286
287	/**
288	* Get services for the given blog and user.
289	*
290	* Can return all available services or just the ones with an active connection.
291	*
292	* @param string $filter Type of filter.
293	* 'all' (default) - Get all services available for connecting.
294	* 'connected' - Get all services currently connected.
295	* @param false\|int $_blog_id The blog ID. Use false (default) for the current blog.
296	* @param false\|int $_user_id The user ID. Use false (default) for the current user.
297	* @return array
298	*/
299	abstract public function get_services( $filter = 'all', $_blog_id = false, $_user_id = false );
300
301	/**
302	* Whether the site has the feature flag enabled.
303	*
304	* @deprecated 0.69.1 Use Current_Plan::supports() directly instead.
305	*
306	* @todo Remove this method After March 2026.
307	*
308	* @param string $flag_name The feature flag to check. Will be prefixed with 'jetpack_social_has_' for the option.
309	* @param string $feature_name The feature name to check for for the Current_Plan check, without the social- prefix.
310	* @return bool
311	*/
312	public function has_feature_flag( $flag_name, $feature_name ): bool {
313	return Publicize_Script_Data::has_feature_flag( $feature_name );
314	}
315
316	/**
317	* Does the given user have a connection to the service on the given blog?
318	*
319	* @param string $service_name 'facebook', 'twitter', etc.
320	* @param false\|int $_blog_id The blog ID. Use false (default) for the current blog.
321	* @param false\|int $_user_id The user ID. Use false (default) for the current user.
322	* @return bool
323	*/
324	public function is_enabled( $service_name, $_blog_id = false, $_user_id = false ) {
325	if ( ! $_blog_id ) {
326	$_blog_id = $this->blog_id();
327	}
328
329	if ( ! $_user_id ) {
330	$_user_id = $this->user_id();
331	}
332
333	$connections = $this->get_connections( $service_name, $_blog_id, $_user_id );
334	return is_array( $connections ) && count( $connections ) > 0;
335	}
336
337	/**
338	* Generates a connection URL.
339	*
340	* This is the URL, which, when visited by the user, starts the authentication
341	* process required to forge a connection.
342	*
343	* @param string $service_name 'facebook', 'twitter', etc.
344	* @return string
345	*/
346	abstract public function connect_url( $service_name );
347
348	/**
349	* Generates a Connection refresh URL.
350	*
351	* This is the URL, which, when visited by the user, re-authenticates their
352	* connection to the service.
353	*
354	* @param string $service_name 'facebook', 'twitter', etc.
355	* @return string
356	*/
357	abstract public function refresh_url( $service_name );
358
359	/**
360	* Generates a disconnection URL.
361	*
362	* This is the URL, which, when visited by the user, breaks their connection
363	* with the service.
364	*
365	* @param string $service_name 'facebook', 'twitter', etc.
366	* @param string $connection_id Connection ID.
367	* @return string
368	*/
369	abstract public function disconnect_url( $service_name, $connection_id );
370
371	/**
372	* Returns a display name for the Service
373	*
374	* @param string $service_name 'facebook', 'twitter', etc.
375	* @return string
376	*/
377	public static function get_service_label( $service_name ) {
378	switch ( $service_name ) {
379	case 'linkedin':
380	return 'LinkedIn';
381	case 'google_drive': // google-drive used to be called google_drive.
382	case 'google-drive':
383	return 'Google Drive';
384	case 'instagram-business':
385	return 'Instagram';
386	case 'twitter':
387	case 'facebook':
388	case 'tumblr':
389	default:
390	return ucfirst( $service_name );
391	}
392	}
393
394	/**
395	* Connections: For each Service, there can be multiple connections
396	* for a given user. For example, one user could be connected to Twitter
397	* as both @jetpack and as @wordpressdotcom
398	*
399	* For historical reasons, Connections are represented as an object
400	* on WordPress.com and as an array in Jetpack.
401	*/
402
403	/**
404	* Get the active Connections of a Service
405	*
406	* @param string $service_name 'facebook', 'twitter', etc.
407	* @param false\|int $_blog_id The blog ID. Use false (default) for the current blog.
408	* @param false\|int $_user_id The user ID. Use false (default) for the current user.
409	* @return false\|object[]\|array[] false if no connections exist
410	*/
411	abstract public function get_connections( $service_name, $_blog_id = false, $_user_id = false );
412
413	/**
414	* Get a single Connection of a Service
415	*
416	* @param string $service_name 'facebook', 'twitter', etc.
417	* @param string $connection_id Connection ID.
418	* @param false\|int $_blog_id The blog ID. Use false (default) for the current blog.
419	* @param false\|int $_user_id The user ID. Use false (default) for the current user.
420	* @return false\|object[]\|array[] false if no connections exist
421	*/
422	abstract public function get_connection( $service_name, $connection_id, $_blog_id = false, $_user_id = false );
423
424	/**
425	* Get the Connection ID.
426	*
427	* Note that this is different than the Connection's uniqueid.
428	*
429	* Via a quirk of history, ID is globally unique and unique_id
430	* is only unique per site.
431	*
432	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
433	* @return string
434	*/
435	abstract public function get_connection_id( $connection );
436
437	/**
438	* Get the Connection unique_id
439	*
440	* Note that this is different than the Connections ID.
441	*
442	* Via a quirk of history, ID is globally unique and unique_id
443	* is only unique per site.
444	*
445	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
446	* @return string
447	*/
448	abstract public function get_connection_unique_id( $connection );
449
450	/**
451	* Get the Connection's Meta data
452	*
453	* @param object\|array $connection Connection.
454	* @return array Connection Meta
455	*/
456	abstract public function get_connection_meta( $connection );
457
458	/**
459	* Disconnect a Connection
460	*
461	* @param string $service_name 'facebook', 'twitter', etc.
462	* @param string $connection_id Connection ID.
463	* @param false\|int $_blog_id The blog ID. Use false (default) for the current blog.
464	* @param false\|int $_user_id The user ID. Use false (default) for the current user.
465	* @param bool $force_delete Whether to skip permissions checks.
466	* @return false\|void False on failure. Void on success.
467	*/
468	abstract public function disconnect( $service_name, $connection_id, $_blog_id = false, $_user_id = false, $force_delete = false );
469
470	/**
471	* Globalizes a Connection
472	*
473	* @param string $connection_id Connection ID.
474	* @return bool Falsey on failure. Truthy on success.
475	*/
476	abstract public function globalize_connection( $connection_id );
477
478	/**
479	* Unglobalizes a Connection
480	*
481	* @param string $connection_id Connection ID.
482	* @return bool Falsey on failure. Truthy on success.
483	*/
484	abstract public function unglobalize_connection( $connection_id );
485
486	/**
487	* Returns an external URL to the Connection's profile
488	*
489	* @param string $service_name 'facebook', 'twitter', etc.
490	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
491	* @return false\|string False on failure. URL on success.
492	*/
493	public function get_profile_link( $service_name, $connection ) {
494	$cmeta = $this->get_connection_meta( $connection );
495
496	if ( isset( $cmeta['connection_data']['meta']['link'] ) ) {
497	if ( 'facebook' === $service_name && str_starts_with( wp_parse_url( $cmeta['connection_data']['meta']['link'], PHP_URL_PATH ), '/app_scoped_user_id/' ) ) {
498	// App-scoped Facebook user IDs are not usable profile links.
499	return false;
500	}
501
502	return $cmeta['connection_data']['meta']['link'];
503	}
504
505	if ( 'facebook' === $service_name && isset( $cmeta['connection_data']['meta']['facebook_page'] ) ) {
506	return 'https://facebook.com/' . $cmeta['connection_data']['meta']['facebook_page'];
507	}
508
509	if ( 'instagram-business' === $service_name && isset( $cmeta['connection_data']['meta']['username'] ) ) {
510	return 'https://instagram.com/' . $cmeta['connection_data']['meta']['username'];
511	}
512
513	if ( 'linkedin' === $service_name ) {
514
515	$entity_type = $cmeta['connection_data']['meta']['entity_type'] ?? 'person';
516
517	if ( 'organization' === $entity_type && ! empty( $cmeta['connection_data']['meta']['external_name'] ) ) {
518	return 'https://www.linkedin.com/company/' . $cmeta['connection_data']['meta']['external_name'];
519	}
520
521	if ( 'person' === $entity_type && ! empty( $cmeta['external_name'] ) ) {
522	return 'https://www.linkedin.com/in/' . $cmeta['external_name'];
523	}
524	}
525
526	if ( 'threads' === $service_name && isset( $cmeta['external_name'] ) ) {
527	return 'https://www.threads.net/@' . $cmeta['external_name'];
528	}
529
530	if ( 'mastodon' === $service_name && isset( $cmeta['external_name'] ) ) {
531	return 'https://mastodon.social/@' . $cmeta['external_name'];
532	}
533
534	if ( 'nextdoor' === $service_name && isset( $cmeta['external_id'] ) ) {
535	return 'https://nextdoor.com/profile/' . $cmeta['external_id'];
536	}
537
538	if ( 'tumblr' === $service_name && isset( $cmeta['connection_data']['meta']['tumblr_base_hostname'] ) ) {
539	return 'https://' . $cmeta['connection_data']['meta']['tumblr_base_hostname'];
540	}
541
542	if ( 'twitter' === $service_name ) {
543	return 'https://twitter.com/' . substr( $cmeta['external_display'], 1 ); // Has a leading '@'.
544	}
545
546	if ( 'bluesky' === $service_name ) {
547	return 'https://bsky.app/profile/' . $cmeta['external_id'];
548	}
549
550	return false; // no fallback. we just won't link it.
551	}
552
553	/**
554	* Returns a display name for the Connection
555	*
556	* @param string $service_name 'facebook', 'twitter', etc.
557	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
558	* @return string
559	*/
560	public function get_display_name( $service_name, $connection ) {
561	$cmeta = $this->get_connection_meta( $connection );
562
563	if ( 'mastodon' === $service_name && isset( $cmeta['external_display'] ) ) {
564	return $cmeta['external_display'];
565	}
566
567	if ( isset( $cmeta['connection_data']['meta']['display_name'] ) ) {
568	return $cmeta['connection_data']['meta']['display_name'];
569	}
570
571	if ( 'tumblr' === $service_name && isset( $cmeta['connection_data']['meta']['tumblr_base_hostname'] ) ) {
572	return $cmeta['connection_data']['meta']['tumblr_base_hostname'];
573	}
574
575	if ( 'twitter' === $service_name ) {
576	return $cmeta['external_display'];
577	}
578
579	$connection_display = $cmeta['external_display'];
580
581	if ( empty( $connection_display ) ) {
582	$connection_display = $cmeta['external_name'];
583	}
584
585	return $connection_display;
586	}
587
588	/**
589	* Returns the account name for the Connection. For services like Instagram, we need both the username and the account's name.
590	*
591	* @param string $service_name 'facebook', 'linkedin', etc.
592	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
593	* @return string
594	*/
595	public function get_username( $service_name, $connection ) {
596	$handle = $this->get_external_handle( $service_name, $connection );
597
598	return $handle ?? $this->get_display_name( $service_name, $connection );
599	}
600
601	/**
602	* Returns the external handle for the Connection.
603	*
604	* @param string $service_name 'facebook', 'linkedin', etc.
605	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
606	* @return string\|null
607	*/
608	public function get_external_handle( $service_name, $connection ) {
609	$cmeta = $this->get_connection_meta( $connection );
610
611	switch ( $service_name ) {
612	case 'mastodon':
613	return $cmeta['external_display'] ?? null;
614
615	case 'bluesky':
616	case 'threads':
617	return $cmeta['external_name'] ?? null;
618
619	case 'instagram-business':
620	return $cmeta['connection_data']['meta']['username'] ?? null;
621
622	default:
623	return null;
624	}
625	}
626
627	/**
628	* Returns a profile picture for the Connection
629	*
630	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
631	* @return string
632	*/
633	public function get_profile_picture( $connection ) {
634	$cmeta = $this->get_connection_meta( $connection );
635
636	if ( isset( $cmeta['profile_picture'] ) ) {
637	return $cmeta['profile_picture'];
638	}
639
640	return '';
641	}
642
643	/**
644	* Whether the user needs to select additional options after connecting
645	*
646	* @param string $service_name 'facebook', 'twitter', etc.
647	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
648	* @return bool
649	*/
650	public function show_options_popup( $service_name, $connection ) {
651	$cmeta = $this->get_connection_meta( $connection );
652
653	// Always show if no selection has been made for Facebook.
654	if ( 'facebook' === $service_name && empty( $cmeta['connection_data']['meta']['facebook_profile'] ) && empty( $cmeta['connection_data']['meta']['facebook_page'] ) ) {
655	return true;
656	}
657
658	// Always show if no selection has been made for Tumblr.
659	if ( 'tumblr' === $service_name && empty( $cmeta['connection_data']['meta']['tumblr_base_hostname'] ) ) {
660	return true;
661	}
662
663	// if we have the specific connection info..
664	$id = ! empty( $_GET['id'] ) ? sanitize_text_field( wp_unslash( $_GET['id'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
665
666	if ( $id ) {
667	if ( $cmeta['connection_data']['id'] === $id ) {
668	return true;
669	}
670	} else {
671	// Otherwise, just show if this is the completed step / first load.
672	// phpcs:disable WordPress.Security.NonceVerification.Recommended
673	$is_completed = ! empty( $_GET['action'] ) && 'completed' === $_GET['action'];
674	$service = ! empty( $_GET['service'] ) ? sanitize_text_field( wp_unslash( $_GET['service'] ) ) : false;
675	// phpcs:enable WordPress.Security.NonceVerification.Recommended
676
677	if ( $is_completed && $service_name === $service && ! in_array( $service, array( 'facebook', 'tumblr' ), true ) ) {
678	return true;
679	}
680	}
681
682	return false;
683	}
684
685	/**
686	* Check if a connection is global
687	*
688	* @param array $connection Connection data.
689	* @return bool Whether the connection is global.
690	*/
691	public function is_global_connection( $connection ) {
692	return empty( $connection['connection_data']['user_id'] );
693	}
694
695	/**
696	* Whether the Connection is "valid" wrt Facebook's requirements.
697	*
698	* Must be connected to a Page (not a Profile).
699	* (Also returns true if we're in the middle of the connection process)
700	*
701	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
702	* @return bool
703	*/
704	public function is_valid_facebook_connection( $connection ) {
705	if ( $this->is_connecting_connection( $connection ) ) {
706	return true;
707	}
708	$connection_meta = $this->get_connection_meta( $connection );
709	$connection_data = $connection_meta['connection_data'];
710	return isset( $connection_data['meta']['facebook_page'] );
711	}
712
713	/**
714	* LinkedIn needs to be reauthenticated to use v2 of their API.
715	* If it's using LinkedIn old API, it's an 'invalid' connection
716	*
717	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
718	* @return bool
719	*/
720	public function is_invalid_linkedin_connection( $connection ) {
721	// LinkedIn API v1 included the profile link in the connection data.
722	$connection_meta = $this->get_connection_meta( $connection );
723	return isset( $connection_meta['connection_data']['meta']['profile_url'] );
724	}
725
726	/**
727	* Whether the Connection currently being connected
728	*
729	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
730	* @return bool
731	*/
732	public function is_connecting_connection( $connection ) {
733	$connection_meta = $this->get_connection_meta( $connection );
734	$connection_data = $connection_meta['connection_data'];
735	return isset( $connection_data['meta']['options_responses'] );
736	}
737
738	/**
739	* Parse the error code returned by the XML-RPC API call.
740	*
741	* @param string $code Error code in numerical format.
742	*
743	* @return string Error code.
744	*/
745	public function parse_connection_error_code( $code ) {
746	if ( 1 === $code ) {
747	return 'unsupported';
748	}
749
750	return 'broken';
751	}
752
753	/**
754	* Run connection tests on all Connections
755	*
756	* @return array {
757	* Array of connection test results.
758	*
759	* @type string 'connectionID' Connection identifier string that is unique for each connection
760	* @type string 'serviceName' Slug of the connection's service (facebook, twitter, ...)
761	* @type bool 'connectionTestPassed' Whether the connection test was successful
762	* @type string 'connectionTestMessage' Test success or error message
763	* @type bool 'userCanRefresh' Whether the user can re-authenticate their connection to the service
764	* @type string 'refreshText' Message instructing user to re-authenticate their connection to the service
765	* @type string 'refreshURL' URL, which, when visited by the user, re-authenticates their connection to the service.
766	* @type string 'unique_id' ID string representing connection
767	* }
768	*/
769	public function get_publicize_conns_test_results() {
770	$test_results = array();
771
772	foreach ( (array) $this->get_services( 'connected' ) as $service_name => $connections ) {
773	foreach ( $connections as $connection ) {
774
775	$id = $this->get_connection_id( $connection );
776
777	$connection_test_error_code = '';
778	$connection_test_passed = true;
779	$connection_test_message = __( 'This connection is working correctly.', 'jetpack-publicize-pkg' );
780	$user_can_refresh = false;
781	$refresh_text = '';
782	$refresh_url = '';
783
784	$connection_test_result = true;
785	if ( method_exists( $this, 'test_connection' ) ) {
786	$connection_test_result = $this->test_connection( $service_name, $connection );
787	}
788
789	if ( is_wp_error( $connection_test_result ) ) {
790	$connection_test_passed = false;
791	$connection_test_message = $connection_test_result->get_error_message();
792	$error_data = $connection_test_result->get_error_data();
793	$error_code = $connection_test_result->get_error_code();
794
795	if ( ! empty( $error_data ) ) {
796	$user_can_refresh = $error_data['user_can_refresh'];
797	$refresh_text = $error_data['refresh_text'];
798	$refresh_url = $error_data['refresh_url'];
799	}
800	$connection_test_error_code = $connection_test_passed ? '' : $this->parse_connection_error_code( $error_code );
801	}
802	// Mark Facebook profiles as deprecated.
803	if ( 'facebook' === $service_name ) {
804	if ( ! $this->is_valid_facebook_connection( $connection ) ) {
805	$connection_test_passed = false;
806	$user_can_refresh = false;
807	$connection_test_message = __( 'Please select a Facebook Page to publish updates.', 'jetpack-publicize-pkg' );
808	}
809	}
810
811	// LinkedIn needs reauthentication to be compatible with v2 of their API.
812	if ( 'linkedin' === $service_name && $this->is_invalid_linkedin_connection( $connection ) ) {
813	$connection_test_passed = 'must_reauth';
814	$user_can_refresh = false;
815	$connection_test_message = esc_html__( 'Your LinkedIn connection needs to be reauthenticated to continue working – head to Sharing to take care of it.', 'jetpack-publicize-pkg' );
816	}
817
818	$unique_id = null;
819
820	if ( ! empty( $connection->unique_id ) ) {
821	$unique_id = $connection->unique_id;
822	} elseif ( ! empty( $connection['connection_data']['token_id'] ) ) {
823	$unique_id = $connection['connection_data']['token_id'];
824	}
825
826	$test_results[] = array(
827	'connectionID' => $id,
828	'serviceName' => $service_name,
829	'connectionTestPassed' => $connection_test_passed,
830	'connectionTestErrorCode' => $connection_test_error_code,
831	'connectionTestMessage' => esc_attr( $connection_test_message ),
832	'userCanRefresh' => $user_can_refresh,
833	'refreshText' => esc_attr( $refresh_text ),
834	'refreshURL' => $refresh_url,
835	'unique_id' => $unique_id,
836	);
837	}
838	}
839
840	return $test_results;
841	}
842
843	/**
844	* Run the connection test for the Connection
845	*
846	* @param string $service_name $service_name 'facebook', 'twitter', etc.
847	* @param object\|array $connection The Connection object (WordPress.com) or array (Jetpack).
848	* @return WP_Error\|true WP_Error on failure. True on success
849	*/
850	abstract public function test_connection( $service_name, $connection );
851
852	/**
853	* Retrieves current list of connections and applies filters.
854	*
855	* Retrieves current available connections and checks if the connections
856	* have already been used to share current post. Finally, the checkbox
857	* form UI fields are calculated. This function exposes connection form
858	* data directly as array so it can be retrieved for static HTML generation
859	* or JSON consumption.
860	*
861	* @since 0.1.0
862	* @since-jetpack 6.7.0
863	*
864	* @param integer $selected_post_id Optional. Post ID to query connection status for.
865	*
866	* @return array {
867	* Array of UI setup data for connection list form.
868	*
869	* @type string 'unique_id' ID string representing connection
870	* @type string 'service_name' Slug of the connection's service (facebook, twitter, ...)
871	* @type string 'service_label' Service Label (Facebook, Twitter, ...)
872	* @type string 'display_name' Connection's human-readable Username: "@jetpack"
873	* @type string 'profile_picture' Connection profile picture.
874	* @type bool 'enabled' Default value for the connection (e.g., for a checkbox).
875	* @type bool 'done' Has this connection already been publicized to?
876	* @type bool 'toggleable' Is the user allowed to change the value for the connection?
877	* @type bool 'global' Is this connection a global one?
878	* @type string 'external_id' External ID for the connection.
879	* }
880	*/
881	public function get_filtered_connection_data( $selected_post_id = null ) {
882	$connection_list = array();
883
884	$post = get_post( $selected_post_id ); // Defaults to current post if $post_id is null.
885	// Handle case where there is no current post.
886	if ( ! empty( $post ) ) {
887	$post_id = $post->ID;
888	} else {
889	$post_id = null;
890	}
891
892	// We don't allow Publicizing to the same external id twice, to prevent spam.
893	$service_id_done = (array) get_post_meta( $post_id, $this->POST_SERVICE_DONE, true );
894
895	$connections = Connections::get_all_for_user();
896
897	if ( ! empty( $connections ) ) {
898
899	foreach ( $connections as $connection ) {
900	$service_name = $connection['service_name'];
901	$unique_id = $connection['id'];
902	$connection_id = $connection['connection_id'];
903	// Was this connection (OR, old-format service) already Publicized to?
904	$done = ! empty( $post ) && (
905	// Flags based on token_id.
906	1 === (int) get_post_meta( $post->ID, $this->POST_DONE . $unique_id, true )
907	\|\|
908	// Old flags.
909	1 === (int) get_post_meta( $post->ID, $this->POST_DONE . $service_name, true )
910	);
911
912	/**
913	* Filter whether a post should be publicized to a given service.
914	*
915	* @since 0.1.0
916	* @since-jetpack 2.0.0
917	*
918	* @param bool true Should the post be publicized to a given service? Default to true.
919	* @param int $post_id Post ID.
920	* @param string $service_name Service name.
921	* @param array $connection The connection data.
922	*/
923	/* phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores */
924	if ( ! apply_filters( 'wpas_submit_post?', true, $post_id, $service_name, $connection ) ) {
925	continue;
926	}
927
928	// Should we be skipping this one?
929	$skip = (
930	(
931	! empty( $post )
932	&&
933	in_array( $post->post_status, array( 'publish', 'draft', 'future' ), true )
934	&&
935	(
936	// Flags based on token_id.
937	get_post_meta( $post->ID, $this->POST_SKIP . $unique_id, true )
938	\|\|
939	// Flags based on the connection_id.
940	get_post_meta( $post->ID, $this->POST_SKIP_PUBLICIZE . $connection_id, true )
941	\|\|
942	// Old flags.
943	get_post_meta( $post->ID, $this->POST_SKIP . $service_name, false )
944	)
945	)
946	\|\|
947	(
948	isset( $connection['external_id'] ) && ! empty( $service_id_done[ $service_name ][ $connection['external_id'] ] )
949	)
950	);
951
952	// Determine the state of the checkbox (on/off) and allow filtering.
953	$enabled = $done \|\| ! $skip;
954	/**
955	* Filter the checkbox state of each Publicize connection appearing in the post editor.
956	*
957	* @since 0.1.0
958	* @since-jetpack 2.0.1
959	*
960	* @param bool $enabled Should the Publicize checkbox be enabled for a given service.
961	* @param int $post_id Post ID.
962	* @param string $service_name Service name.
963	* @param array $connection Array of connection details.
964	*/
965	$enabled = apply_filters( 'publicize_checkbox_default', $enabled, $post_id, $service_name, $connection );
966
967	/**
968	* If this is a shared connection and this user doesn't have enough permissions to modify.
969	*/
970	if ( ! $done && Connections::is_shared( $connection ) && ! current_user_can( $this->GLOBAL_CAP ) ) {
971	/**
972	* Filters the checkboxes for global connections with non-prilvedged users.
973	*
974	* @since 0.1.0
975	* @since-jetpack 3.7.0
976	*
977	* @param bool $enabled Indicates if this connection should be enabled. Default true.
978	* @param int $post_id ID of the current post
979	* @param string $service_name Name of the connection (Facebook, Twitter, etc)
980	* @param array $connection Array of data about the connection.
981	*/
982	$enabled = apply_filters( 'publicize_checkbox_global_default', $enabled, $post_id, $service_name, $connection );
983	}
984
985	// Force the checkbox to be checked if the post was DONE, regardless of what the filter does.
986	if ( $done ) {
987	$enabled = true;
988	}
989
990	$connection_list[] = array_merge(
991	$connection,
992	array(
993	'enabled' => $enabled,
994	'done' => $done,
995	)
996	);
997	}
998	}
999
1000	return $connection_list;
1001	}
1002
1003	/**
1004	* Checks if post has already been shared by Publicize in the past.
1005	*
1006	* @since 0.1.0
1007	* @since-jetpack 6.7.0
1008	*
1009	* @param integer $post_id Optional. Post ID to query connection status for: will use current post if missing.
1010	*
1011	* @return bool True if post has already been shared by Publicize, false otherwise.
1012	*/
1013	abstract public function post_is_done_sharing( $post_id = null );
1014
1015	/**
1016	* Retrieve the available Publicize services and their connect URLs.
1017	*
1018	* @since 0.1.0
1019	* @since-jetpack 6.7.0
1020	* @deprecated 0.88.0 Services and their connect URLs come from the `publicize/services` REST endpoint.
1021	*
1022	* @return array Always empty.
1023	*/
1024	public function get_available_service_data() {
1025	_deprecated_function( __METHOD__, 'publicize-0.88.0' );
1026
1027	return array();
1028	}
1029
1030	/**
1031	* Site Data
1032	*/
1033
1034	/**
1035	* Get user ID.
1036	*
1037	* @return int The current user's ID, or 0 if no user is logged in.
1038	*/
1039	public function user_id() {
1040	return get_current_user_id();
1041	}
1042
1043	/**
1044	* Get site ID.
1045	*
1046	* @return int Site ID.
1047	*/
1048	public function blog_id() {
1049	return get_current_blog_id();
1050	}
1051
1052	/**
1053	* Posts
1054	*/
1055
1056	/**
1057	* Checks old and new status to see if the post should be flagged as
1058	* ready to Publicize.
1059	*
1060	* Attached to the `transition_post_status` filter.
1061	*
1062	* @param string $new_status New status.
1063	* @param string $old_status Old status.
1064	* @param WP_Post $post Post object.
1065	* @return void
1066	*/
1067	abstract public function flag_post_for_publicize( $new_status, $old_status, $post );
1068
1069	/**
1070	* Ensures the Post internal post-type supports `publicize`
1071	*
1072	* This feature support flag is used by the REST API.
1073	*/
1074	public function add_post_type_support() {
1075	add_post_type_support( 'post', 'publicize' );
1076	}
1077
1078	/**
1079	* Can the current user access Publicize Data.
1080	*
1081	* @param int $post_id 0 for general access. Post_ID for specific access.
1082	* @return bool
1083	*/
1084	public function current_user_can_access_publicize_data( $post_id = 0 ) {
1085	/**
1086	* Filter what user capability is required to use the publicize form on the edit post page. Useful if publish post capability has been removed from role.
1087	*
1088	* @since 0.1.0
1089	* @since-jetpack 4.1.0
1090	*
1091	* @param string $capability User capability needed to use publicize
1092	*/
1093	$capability = apply_filters( 'jetpack_publicize_capability', 'publish_posts' );
1094
1095	if ( 'publish_posts' === $capability && $post_id ) {
1096	return current_user_can( 'publish_post', $post_id );
1097	}
1098
1099	return current_user_can( $capability );
1100	}
1101
1102	/**
1103	* Auth callback for the protected ->POST_MESS post_meta
1104	*
1105	* @param int $object_id Post ID.
1106	* @return bool
1107	*/
1108	public function message_meta_auth_callback( $object_id ) {
1109	return $this->current_user_can_access_publicize_data( $object_id );
1110	}
1111
1112	/**
1113	* Registers the post_meta for use in the REST API.
1114	*
1115	* Registers for each post type that with `publicize` feature support.
1116	*/
1117	public function register_post_meta() {
1118	/*
1119	* Default the share-message meta to the saved global template
1120	*/
1121	$message_default = $this->has_paid_features()
1122	? ( new Jetpack_Social_Settings\Settings() )->get_message_template()
1123	: '';
1124
1125	$message_args = array(
1126	'type' => 'string',
1127	'description' => __( 'The message to use instead of the title when sharing to Jetpack Social services', 'jetpack-publicize-pkg' ),
1128	'single' => true,
1129	'default' => $message_default,
1130	'show_in_rest' => array(
1131	'name' => 'jetpack_publicize_message',
1132	),
1133	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1134	);
1135
1136	$publicize_feature_enable_args = array(
1137	'type' => 'boolean',
1138	'description' => __( 'Whether or not the Share Post feature is enabled.', 'jetpack-publicize-pkg' ),
1139	'single' => true,
1140	'default' => true,
1141	'show_in_rest' => array(
1142	'name' => 'jetpack_publicize_feature_enabled',
1143	),
1144	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1145	);
1146
1147	$already_shared_flag_args = array(
1148	'type' => 'boolean',
1149	'description' => __( 'Whether or not the post has already been shared.', 'jetpack-publicize-pkg' ),
1150	'single' => true,
1151	'default' => false,
1152	'show_in_rest' => array(
1153	'name' => 'jetpack_social_post_already_shared',
1154	),
1155	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1156	);
1157
1158	$jetpack_social_options_args = array(
1159	'type' => 'object',
1160	'description' => __( 'Post options related to Jetpack Social.', 'jetpack-publicize-pkg' ),
1161	'single' => true,
1162	'default' => array(
1163	'image_generator_settings' => array(
1164	'template' => ( new Jetpack_Social_Settings\Settings() )->sig_get_default_template(),
1165	'default_image_id' => ( new Jetpack_Social_Settings\Settings() )->sig_get_default_image_id(),
1166	'font' => ( new Jetpack_Social_Settings\Settings() )->sig_get_default_font(),
1167	'enabled' => false,
1168	),
1169	'version' => 2,
1170	),
1171	'show_in_rest' => array(
1172	'name' => 'jetpack_social_options',
1173	'schema' => array(
1174	'type' => 'object',
1175	'properties' => array(
1176	'version' => array(
1177	'type' => 'number',
1178	),
1179	'attached_media' => array(
1180	'type' => 'array',
1181	'items' => array(
1182	'type' => 'object',
1183	'properties' => array(
1184	'id' => array(
1185	'type' => 'number',
1186	),
1187	'url' => array(
1188	'type' => 'string',
1189	),
1190	'type' => array(
1191	'type' => 'string',
1192	),
1193	),
1194	),
1195	),
1196	'image_generator_settings' => array(
1197	'type' => 'object',
1198	'properties' => array(
1199	'enabled' => array(
1200	'type' => 'boolean',
1201	),
1202	'custom_text' => array(
1203	'type' => 'string',
1204	),
1205	'image_type' => array(
1206	'type' => 'string',
1207	),
1208	'image_id' => array(
1209	'type' => 'number',
1210	),
1211	'template' => array(
1212	'type' => 'string',
1213	),
1214	'font' => array(
1215	'type' => 'string',
1216	),
1217	'token' => array(
1218	'type' => 'string',
1219	),
1220	'default_image_id' => array(
1221	'type' => 'number',
1222	),
1223	),
1224	),
1225	'media_source' => array(
1226	'type' => 'string',
1227	'enum' => array( 'featured-image', 'sig', 'media-library', 'upload-video', 'none' ),
1228	),
1229	),
1230	),
1231	),
1232	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1233	);
1234
1235	$image_focal_point_args = array(
1236	'type' => 'object',
1237	'description' => __( 'The focal point of the image, used to crop social share variants.', 'jetpack-publicize-pkg' ),
1238	'single' => true,
1239	'default' => array(
1240	'x' => 0.5,
1241	'y' => 0.5,
1242	),
1243	'show_in_rest' => array(
1244	'schema' => array(
1245	'type' => 'object',
1246	'required' => array( 'x', 'y' ),
1247	'properties' => array(
1248	'x' => array(
1249	'type' => 'number',
1250	'minimum' => 0,
1251	'maximum' => 1,
1252	),
1253	'y' => array(
1254	'type' => 'number',
1255	'minimum' => 0,
1256	'maximum' => 1,
1257	),
1258	),
1259	'additionalProperties' => false,
1260	),
1261	),
1262	'auth_callback' => array( $this, 'image_focal_point_auth_callback' ),
1263	);
1264
1265	$connection_overrides_args = array(
1266	'type' => 'object',
1267	'description' => __( 'Per-connection customizations for message and media.', 'jetpack-publicize-pkg' ),
1268	'single' => true,
1269	'default' => array(),
1270	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1271	);
1272
1273	$customize_per_network_default = (
1274	$this->has_paid_features()
1275	&& $this->any_connection_has_custom_template()
1276	);
1277
1278	$customize_per_network_args = array(
1279	'type' => 'boolean',
1280	'description' => __( 'Whether to enable per-network customization.', 'jetpack-publicize-pkg' ),
1281	'single' => true,
1282	'default' => $customize_per_network_default,
1283	'show_in_rest' => $this->has_paid_features(),
1284	'auth_callback' => array( $this, 'message_meta_auth_callback' ),
1285	);
1286
1287	foreach ( get_post_types() as $post_type ) {
1288	if ( ! $this->post_type_is_publicizeable( $post_type ) ) {
1289	continue;
1290	}
1291
1292	$message_args['object_subtype'] = $post_type;
1293	$publicize_feature_enable_args['object_subtype'] = $post_type;
1294	$already_shared_flag_args['object_subtype'] = $post_type;
1295	$jetpack_social_options_args['object_subtype'] = $post_type;
1296	$connection_overrides_args['object_subtype'] = $post_type;
1297	$customize_per_network_args['object_subtype'] = $post_type;
1298
1299	register_meta( 'post', $this->POST_MESS, $message_args );
1300	register_meta( 'post', self::POST_PUBLICIZE_FEATURE_ENABLED, $publicize_feature_enable_args );
1301	register_meta( 'post', $this->POST_DONE . 'all', $already_shared_flag_args );
1302	register_meta( 'post', self::POST_JETPACK_SOCIAL_OPTIONS, $jetpack_social_options_args );
1303	register_meta( 'post', self::POST_CONNECTION_OVERRIDES, $connection_overrides_args );
1304	register_meta( 'post', self::POST_CUSTOMIZE_PER_NETWORK, $customize_per_network_args );
1305	}
1306
1307	// The focal point lives on the image (attachment), not the post, so it is shared
1308	// by every post that uses the image. Registered once, not per publicizeable type.
1309	register_post_meta( 'attachment', self::ATTACHMENT_IMAGE_FOCAL_POINT, $image_focal_point_args );
1310	}
1311
1312	/**
1313	* Collapse duplicate rows of a single-value Publicize post meta key into one on update.
1314	*
1315	* With several rows core skips its "unchanged" check, so an UPDATE that matches no changed row fails.
1316	*
1317	* @param null\|bool $check Whether to short-circuit the update.
1318	* @param int $object_id Post ID.
1319	* @param string $meta_key Meta key.
1320	* @param mixed $meta_value Unslashed meta value.
1321	* @param mixed $prev_value Previous value to match, if any.
1322	* @return null\|bool Null to let core update the meta, otherwise whether the update succeeded.
1323	*/
1324	public function collapse_duplicate_post_meta( $check, $object_id, $meta_key, $meta_value, $prev_value ) {
1325	// Cheap bail first: this runs on every post meta update site-wide.
1326	if ( null !== $check \|\| ! empty( $prev_value ) \|\| 0 !== strncmp( $meta_key, '_wpas_', 6 ) ) {
1327	return $check;
1328	}
1329
1330	$single_keys = array(
1331	$this->POST_MESS,
1332	self::POST_PUBLICIZE_FEATURE_ENABLED,
1333	$this->POST_DONE . 'all',
1334	self::POST_JETPACK_SOCIAL_OPTIONS,
1335	self::POST_CONNECTION_OVERRIDES,
1336	self::POST_CUSTOMIZE_PER_NETWORK,
1337	);
1338	if ( ! in_array( $meta_key, $single_keys, true ) ) {
1339	return $check;
1340	}
1341
1342	$stored = get_metadata_raw( 'post', $object_id, $meta_key, false );
1343	if ( ! is_array( $stored ) \|\| count( $stored ) < 2 ) {
1344	return $check;
1345	}
1346
1347	global $wpdb;
1348	// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- Row IDs aren't exposed by the meta API.
1349	$rows = $wpdb->get_results( $wpdb->prepare( "SELECT meta_id, meta_value FROM {$wpdb->postmeta} WHERE post_id = %d AND meta_key = %s ORDER BY meta_id ASC", $object_id, $meta_key ) );
1350	if ( ! is_array( $rows ) \|\| count( $rows ) < 2 ) {
1351	return $check;
1352	}
1353
1354	// Bail before deleting, so a failed write leaves every row intact.
1355	$keep = array_shift( $rows );
1356	// Cast like `$wpdb` does, e.g. `true` is stored as "1".
1357	$wanted = (string) maybe_serialize( $meta_value );
1358	if ( $wanted !== $keep->meta_value && ! update_metadata_by_mid( 'post', (int) $keep->meta_id, $meta_value ) ) {
1359	// A 0-row UPDATE (e.g. a concurrent collapse) looks like a failure, so confirm the row.
1360	$current = get_metadata_by_mid( 'post', (int) $keep->meta_id );
1361	if ( ! $current \|\| $wanted !== (string) maybe_serialize( $current->meta_value ) ) {
1362	return false;
1363	}
1364	}
1365
1366	// The kept row holds the value, so a redundant row that is already gone is not a failure.
1367	foreach ( $rows as $row ) {
1368	delete_metadata_by_mid( 'post', (int) $row->meta_id );
1369	}
1370
1371	// The 0-row and already-deleted paths skip core's cache flush.
1372	wp_cache_delete( $object_id, 'post_meta' );
1373
1374	// Unlike core, report an unchanged value as success, which is what lets the REST save complete.
1375	return true;
1376	}
1377
1378	/**
1379	* Auth callback for the image focal point attachment meta.
1380	*
1381	* Writing the focal point edits the image, so it requires edit rights on the attachment.
1382	*
1383	* @param bool $allowed Whether the user can edit the meta. Unused; recomputed here.
1384	* @param string $meta_key The meta key. Unused.
1385	* @param int $object_id The attachment ID.
1386	* @return bool
1387	*/
1388	public function image_focal_point_auth_callback( $allowed, $meta_key, $object_id ) {
1389	return current_user_can( 'edit_post', $object_id );
1390	}
1391
1392	/**
1393	* Whether any connection available to the current user has a custom message template.
1394	*
1395	* @return bool
1396	*/
1397	protected function any_connection_has_custom_template() {
1398	foreach ( Connections::get_all_for_user() as $connection ) {
1399	if ( '' !== trim( (string) ( $connection['template'] ?? '' ) ) ) {
1400	return true;
1401	}
1402	}
1403
1404	return false;
1405	}
1406
1407	/**
1408	* Helper function to allow us to not publicize posts in certain contexts.
1409	*
1410	* @param WP_Post $post Post object.
1411	*/
1412	public function should_submit_post_pre_checks( $post ) {
1413	$submit_post = true;
1414
1415	if ( defined( 'WP_IMPORTING' ) && WP_IMPORTING ) {
1416	$submit_post = false;
1417	}
1418
1419	if (
1420	defined( 'DOING_AUTOSAVE' )
1421	&&
1422	DOING_AUTOSAVE
1423	) {
1424	$submit_post = false;
1425	}
1426
1427	// To stop quick edits from getting publicized.
1428	if ( did_action( 'wp_ajax_inline-save' ) ) {
1429	$submit_post = false;
1430	}
1431
1432	// phpcs:disable WordPress.Security.NonceVerification.Recommended
1433	if ( ! empty( $_GET['bulk_edit'] ) ) {
1434	$submit_post = false;
1435	}
1436	// phpcs:enable WordPress.Security.NonceVerification.Recommended
1437
1438	// - API/XML-RPC Test Posts
1439	if (
1440	(
1441	( defined( 'XMLRPC_REQUEST' ) && XMLRPC_REQUEST )
1442	\|\|
1443	( defined( 'APP_REQUEST' ) && constant( 'APP_REQUEST' ) )
1444	)
1445	&&
1446	str_starts_with( $post->post_title, 'Temporary Post Used For Theme Detection' )
1447	) {
1448	$submit_post = false;
1449	}
1450
1451	// Only work with certain statuses (avoids inherits, auto drafts etc).
1452	if ( ! in_array( $post->post_status, array( 'publish', 'draft', 'future' ), true ) ) {
1453	$submit_post = false;
1454	}
1455
1456	// Don't publish password protected posts.
1457	if ( '' !== $post->post_password ) {
1458	$submit_post = false;
1459	}
1460
1461	return $submit_post;
1462	}
1463
1464	/**
1465	* Fires when a post is saved, checks conditions and saves state in postmeta so that it
1466	* can be picked up later by @see ::publicize_post() on WordPress.com codebase.
1467	*
1468	* Attached to the `save_post` action.
1469	*
1470	* @param int $post_id Post ID.
1471	* @param WP_Post $post Post object.
1472	*/
1473	public function save_meta( $post_id, $post ) {
1474	$cron_user = null;
1475	$submit_post = true;
1476
1477	if ( ! $this->post_type_is_publicizeable( $post->post_type ) ) {
1478	return;
1479	}
1480
1481	$submit_post = $this->should_submit_post_pre_checks( $post );
1482
1483	// phpcs:ignore WordPress.Security.NonceVerification.Missing, WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- We're only checking if a value is set
1484	$admin_page = $_POST[ $this->ADMIN_PAGE ] ?? null;
1485
1486	// Did this request happen via wp-admin?
1487	$from_web = isset( $_SERVER['REQUEST_METHOD'] )
1488	&&
1489	'post' === strtolower( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) )
1490	&&
1491	! empty( $admin_page );
1492
1493	// phpcs:ignore WordPress.Security.NonceVerification.Missing
1494	$title = isset( $_POST['wpas_title'] ) ? sanitize_textarea_field( wp_unslash( $_POST['wpas_title'] ) ) : null;
1495
1496	if ( ( $from_web \|\| defined( 'POST_BY_EMAIL' ) ) && ! empty( $title ) ) {
1497	update_post_meta( $post_id, $this->POST_MESS, trim( stripslashes( $title ) ) );
1498	}
1499
1500	// Change current user to provide context for get_services() if we're running during cron.
1501	if ( defined( 'DOING_CRON' ) && DOING_CRON ) {
1502	$cron_user = (int) $GLOBALS['user_ID'];
1503	wp_set_current_user( $post->post_author );
1504	}
1505
1506	/**
1507	* In this phase, we mark connections that we want to SKIP. When Publicize is actually triggered,
1508	* it will Publicize to everything except those marked for skipping.
1509	*/
1510	foreach ( (array) $this->get_services( 'connected' ) as $service_name => $connections ) {
1511	foreach ( $connections as $connection ) {
1512	$connection_data = '';
1513	if ( is_object( $connection ) && method_exists( $connection, 'get_meta' ) ) {
1514	$connection_data = $connection->get_meta( 'connection_data' );
1515	} elseif ( ! empty( $connection['connection_data'] ) ) {
1516	$connection_data = $connection['connection_data'];
1517	}
1518
1519	/** This action is documented in modules/publicize/ui.php */
1520	/* phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores */
1521	if ( false === apply_filters( 'wpas_submit_post?', $submit_post, $post_id, $service_name, $connection_data ) ) {
1522	delete_post_meta( $post_id, $this->PENDING );
1523	continue;
1524	}
1525
1526	// This was a wp-admin request, so we need to check the state of checkboxes.
1527	if ( $from_web ) {
1528	$connection_id = $this->get_connection_id( $connection );
1529	// Delete stray service-based post meta.
1530	delete_post_meta( $post_id, $this->POST_SKIP . $service_name );
1531
1532	// We unchecked this stream from the admin page, or it's set to readonly, or it's a new addition.
1533	if ( empty( $admin_page['submit'][ $connection_id ] ) ) {
1534	// Also make sure that the service-specific input isn't there.
1535	// If the user connected to a new service 'in-page' then a hidden field with the service
1536	// name is added, so we just assume they wanted to Publicize to that service.
1537	if ( empty( $admin_page['submit'][ $service_name ] ) ) {
1538	// Nothing seems to be checked, so we're going to mark this one to be skipped.
1539	update_post_meta( $post_id, $this->POST_SKIP_PUBLICIZE . $connection_id, 1 );
1540	continue;
1541	} else {
1542	// Clean up any stray post meta.
1543	delete_post_meta( $post_id, $this->POST_SKIP_PUBLICIZE . $connection_id );
1544	}
1545	} else {
1546	// The checkbox for this connection is explicitly checked -- make sure we DON'T skip it.
1547	delete_post_meta( $post_id, $this->POST_SKIP_PUBLICIZE . $connection_id );
1548	}
1549	}
1550
1551	/**
1552	* Fires right before the post is processed for Publicize.
1553	* Users may hook in here and do anything else they need to after meta is written,
1554	* and before the post is processed for Publicize.
1555	*
1556	* @since 0.1.0
1557	* @since-jetpack 2.1.2
1558	*
1559	* @param bool $submit_post Should the post be publicized.
1560	* @param int $post->ID Post ID.
1561	* @param string $service_name Service name.
1562	* @param array $connection Array of connection details.
1563	*/
1564	do_action( 'publicize_save_meta', $submit_post, $post_id, $service_name, $connection );
1565	}
1566	}
1567
1568	if ( defined( 'DOING_CRON' ) && DOING_CRON ) {
1569	wp_set_current_user( $cron_user );
1570	}
1571
1572	// Next up will be ::publicize_post().
1573	}
1574
1575	/**
1576	* Alters the "Post Published" message to include information about where the post
1577	* was Publicized to.
1578	*
1579	* Attached to the `post_updated_messages` filter
1580	*
1581	* @param string[] $messages Array of messages.
1582	* @return string[]
1583	*/
1584	public function update_published_message( $messages ) {
1585	global $post_type, $post_type_object, $post;
1586	if ( ! $this->post_type_is_publicizeable( $post_type ) ) {
1587	return $messages;
1588	}
1589
1590	// Bail early if the post is private.
1591	if ( 'publish' !== $post->post_status ) {
1592	return $messages;
1593	}
1594
1595	$view_post_link_html = '';
1596	$viewable = is_post_type_viewable( $post_type_object );
1597	if ( $viewable ) {
1598	/* phpcs:ignore WordPress.WP.I18n.MissingArgDomain, WordPress.Utils.I18nTextDomainFixer.MissingArgDomain */
1599	$view_text = esc_html__( 'View post' ); // Intentionally omitted domain.
1600
1601	if ( 'jetpack-portfolio' === $post_type ) {
1602	$view_text = esc_html__( 'View project', 'jetpack-publicize-pkg' );
1603	}
1604
1605	$view_post_link_html = sprintf(
1606	' <a href="%1$s">%2$s</a>',
1607	esc_url( get_permalink( $post ) ),
1608	$view_text
1609	);
1610	}
1611
1612	$services = $this->get_publicizing_services( $post->ID );
1613	if ( empty( $services ) ) {
1614	return $messages;
1615	}
1616
1617	$labels = array();
1618	foreach ( $services as $service_name => $display_names ) {
1619	$labels[] = sprintf(
1620	/* translators: Service name is %1$s, and account name is %2$s. */
1621	esc_html__( '%1$s (%2$s)', 'jetpack-publicize-pkg' ),
1622	esc_html( $service_name ),
1623	esc_html( is_array( $display_names ) ? implode( ', ', $display_names ) : $display_names )
1624	);
1625	}
1626
1627	$messages['post'][6] = sprintf(
1628	/* translators: %1$s is a comma-separated list of services and accounts. Ex. Facebook (@jetpack) */
1629	esc_html__( 'Post published and sharing on %1$s.', 'jetpack-publicize-pkg' ),
1630	implode( ', ', $labels )
1631	) . $view_post_link_html;
1632
1633	if ( 'post' === $post_type && class_exists( 'Jetpack_Subscriptions' ) ) {
1634	$subscription = \Jetpack_Subscriptions::init();
1635	if ( $subscription->should_email_post_to_subscribers( $post ) ) {
1636	$messages['post'][6] = sprintf(
1637	/* translators: %1$s is a comma-separated list of services and accounts. Ex. Facebook (@jetpack) */
1638	esc_html__( 'Post published, sending emails to subscribers and sharing post on %1$s.', 'jetpack-publicize-pkg' ),
1639	implode( ', ', $labels )
1640	) . $view_post_link_html;
1641	}
1642	}
1643
1644	$messages['jetpack-portfolio'][6] = sprintf(
1645	/* translators: %1$s is a comma-separated list of services and accounts. Ex. Facebook (@jetpack) */
1646	esc_html__( 'Project published and sharing project on %1$s.', 'jetpack-publicize-pkg' ),
1647	implode( ', ', $labels )
1648	) . $view_post_link_html;
1649
1650	return $messages;
1651	}
1652
1653	/**
1654	* Get the Connections the Post was just Publicized to.
1655	*
1656	* Only reliable just after the Post was published.
1657	*
1658	* @param int $post_id Post ID.
1659	* @return string[] Array of Service display name => Connection display name
1660	*/
1661	public function get_publicizing_services( $post_id ) {
1662	$services = array();
1663
1664	foreach ( (array) $this->get_services( 'connected' ) as $service_name => $connections ) {
1665	// services have multiple connections.
1666	foreach ( $connections as $connection ) {
1667	$connection_id = $this->get_connection_id( $connection );
1668	// Did we skip this connection?
1669	if ( get_post_meta( $post_id, $this->POST_SKIP_PUBLICIZE . $connection_id, true ) ) {
1670	continue;
1671	}
1672	$services[ static::get_service_label( $service_name ) ][] = $this->get_display_name( $service_name, $connection );
1673	}
1674	}
1675
1676	return $services;
1677	}
1678
1679	/**
1680	* Is the post Publicize-able?
1681	*
1682	* Only valid prior to Publicizing a Post.
1683	*
1684	* @param WP_Post $post Post to check.
1685	* @return bool
1686	*/
1687	public function post_is_publicizeable( $post ) {
1688	if ( ! $this->post_type_is_publicizeable( $post->post_type ) ) {
1689	return false;
1690	}
1691
1692	// This is more a precaution. To only publicize posts that are published. (Mostly relevant for Jetpack sites).
1693	if ( 'publish' !== $post->post_status ) {
1694	return false;
1695	}
1696
1697	// If it's not flagged as ready, then abort. @see ::flag_post_for_publicize().
1698	if ( ! get_post_meta( $post->ID, $this->PENDING, true ) ) {
1699	return false;
1700	}
1701
1702	return true;
1703	}
1704
1705	/**
1706	* Is a given post type Publicize-able?
1707	*
1708	* Not every CPT lends itself to Publicize-ation. Allow CPTs to register by adding their CPT via
1709	* the publicize_post_types array filter.
1710	*
1711	* @param string $post_type The post type to check.
1712	* @return bool True if the post type can be Publicized.
1713	*/
1714	public function post_type_is_publicizeable( $post_type ) {
1715	if ( 'post' === $post_type ) {
1716	return true;
1717	}
1718
1719	return post_type_supports( $post_type, 'publicize' );
1720	}
1721
1722	/**
1723	* Already-published posts should not be Publicized by default. This filter sets checked to
1724	* false if a post has already been published.
1725	*
1726	* Attached to the `publicize_checkbox_default` filter
1727	*
1728	* @param bool $checked True if checkbox is checked, false otherwise.
1729	* @param int $post_id Post ID to set checkbox for.
1730	* @return bool
1731	*/
1732	public function publicize_checkbox_default( $checked, $post_id ) {
1733	if ( 'publish' === get_post_status( $post_id ) ) {
1734	return false;
1735	}
1736
1737	return $checked;
1738	}
1739
1740	/**
1741	* Get the attached image for a post.
1742	*
1743	* @param int $post_id ID of the post to get attached media for.
1744	* @return array {
1745	* Array of image data, or empty array if no image is available.
1746	*
1747	* @type string $url Image source URL.
1748	* @type int $width Image width in pixels.
1749	* @type int $height Image height in pixels.
1750	* }
1751	*/
1752	public function get_attached_media_image( $post_id ) {
1753	$options = get_post_meta( $post_id, self::POST_JETPACK_SOCIAL_OPTIONS, true );
1754
1755	if ( ! is_array( $options ) \|\| empty( $options['attached_media'] ) \|\| empty( $options['attached_media'][0]['id'] ) ) {
1756	return array();
1757	}
1758
1759	$media_id = $options['attached_media'][0]['id'];
1760
1761	if ( ! wp_attachment_is_image( $media_id ) ) {
1762	return array();
1763	}
1764
1765	$image = wp_get_attachment_image_src( $media_id, array( 1200, 1200 ) );
1766
1767	if ( ! $image ) {
1768	return array();
1769	}
1770
1771	return array(
1772	'url' => $image[0],
1773	'width' => $image[1],
1774	'height' => $image[2],
1775	);
1776	}
1777
1778	/**
1779	* Get the OpenGraph image for a post.
1780	*
1781	* @param int $post_id ID of the post to get OpenGraph image for.
1782	* @return array {
1783	* Array of image data, or empty array if no image is available.
1784	*
1785	* @type string $url Image source URL.
1786	* @type int $width Image width in pixels.
1787	* @type int $height Image height in pixels.
1788	* }
1789	*/
1790	public function get_social_opengraph_image( $post_id ) {
1791	$generated_image_url = Social_Image_Generator\get_image_url( $post_id );
1792
1793	if ( ! empty( $generated_image_url ) ) {
1794	return array(
1795	'url' => $generated_image_url,
1796	'width' => 1200,
1797	'height' => 630,
1798	);
1799	}
1800
1801	$attached_media = $this->get_attached_media_image( $post_id );
1802
1803	if ( $attached_media ) {
1804	return $attached_media;
1805	}
1806
1807	$featured_image_id = get_post_thumbnail_id( $post_id );
1808
1809	if ( $featured_image_id && Current_Plan::supports( 'social-image-focal-point' ) ) {
1810	$featured_image = Focal_Point::get_cropped_image( $featured_image_id );
1811
1812	if ( $featured_image ) {
1813	return $featured_image;
1814	}
1815	}
1816
1817	return array();
1818	}
1819
1820	/**
1821	* Returns the image size in bytes of a remote image.
1822	*
1823	* @deprecated 0.66.3
1824	*
1825	* @param string $image_url Image URL.
1826	* @return integer\|null $bytes Image size in bytes, or null if request failed.
1827	*/
1828	public function get_remote_filesize( $image_url ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1829	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1830
1831	return null;
1832	}
1833
1834	/**
1835	* Returns the resized Photon URL for a given image.
1836	*
1837	* @deprecated 0.66.3
1838	*
1839	* @param string $image_url Image URL.
1840	* @param int $width Image width.
1841	* @param int $height Image height.
1842	* @return string
1843	*/
1844	public function get_resized_image_url( $image_url, $width, $height ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1845	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1846
1847	return $image_url;
1848	}
1849
1850	/**
1851	* This function runs the image through Site Accelerator to compress it, and also scales it down if needed.
1852	*
1853	* @deprecated 0.66.3
1854	*
1855	* @param string $url Image URL.
1856	* @param int $width Image width.
1857	* @param int $height Image height.
1858	* @return array The compressed image data.
1859	*/
1860	public function compress_and_scale_og_image( $url, $width, $height ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1861	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1862
1863	return array();
1864	}
1865
1866	/**
1867	* Reduce the filesize of an image by reducing the dimensions. Uses Photon.
1868	* Returns null if the image cannot be reduced enough.
1869	*
1870	* @deprecated 0.66.3
1871	*
1872	* @param string $url Image URL.
1873	* @param int $width Image width.
1874	* @param int $height Image height.
1875	* @param int $filesize Image filesize.
1876	* @param int $tries Number of times to try reducing the image size. Default is 5.
1877	* @return array\|null
1878	*/
1879	public function reduce_file_size( $url, $width, $height, $filesize, $tries = 5 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1880	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1881
1882	return null;
1883	}
1884
1885	/**
1886	* Hooks into jetpack_open_graph_tags to add the Jetpack Social images to the OpenGraph tags,
1887	* or to make the Jetpack open graph images pass restrictions.
1888	*
1889	* @deprecated 0.66.3 use add_jetpack_social_og_images instead.
1890	*
1891	* @param array $tags Current tags.
1892	*
1893	* @return array The modified tags.
1894	*/
1895	public function jetpack_social_open_graph_filter( $tags ) {
1896	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1897	return $tags;
1898	}
1899
1900	/**
1901	* Add the Jetpack Social images (attached media, SIG image) to the OpenGraph tags.
1902	*
1903	* @deprecated 0.66.3 use add_jetpack_social_og_images instead.
1904	*
1905	* @param array $tags Current tags.
1906	* @param array $opengraph_image The Jetpack Social image data.
1907	*
1908	* @return array The modified tags.
1909	*/
1910	public function add_jetpack_social_og_image( $tags, $opengraph_image ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1911	_deprecated_function( __METHOD__, '0.66.3', 'add_jetpack_social_og_images' );
1912
1913	return $tags;
1914	}
1915
1916	/**
1917	* Add the Jetpack Social images (attached media, SIG image) to the OpenGraph tags.
1918	*
1919	* @param array $tags Current tags.
1920	*/
1921	public function add_jetpack_social_og_images( $tags ) {
1922	if ( ! is_singular() ) {
1923	return $tags;
1924	}
1925
1926	$post_id = get_the_ID();
1927	if ( ! $post_id ) {
1928	return $tags;
1929	}
1930
1931	if ( ! post_type_supports( get_post_type( $post_id ), 'publicize' ) ) {
1932	return $tags;
1933	}
1934
1935	$opengraph_image = $this->get_social_opengraph_image( $post_id );
1936	if ( empty( $opengraph_image ) ) {
1937	return $tags;
1938	}
1939
1940	// If this code is running in Jetpack, we need to add Twitter cards.
1941	// Some active plugins disable Jetpack's Twitter Cards, so we need
1942	// to check if the class was instantiated before adding the cards.
1943	$needs_twitter_cards = class_exists( \Automattic\Jetpack\Post_Media\Twitter_Cards::class );
1944
1945	return array_merge(
1946	$tags,
1947	array(
1948	'og:image' => $opengraph_image['url'],
1949	'og:image:width' => $opengraph_image['width'],
1950	'og:image:height' => $opengraph_image['height'],
1951	),
1952	$needs_twitter_cards ? array(
1953	'twitter:image' => $opengraph_image['url'],
1954	'twitter:card' => 'summary_large_image',
1955	) : array()
1956	);
1957	}
1958
1959	/**
1960	* Util
1961	*/
1962
1963	/**
1964	* Converts a Publicize message template string into a sprintf format string
1965	*
1966	* @param string[] $args Array of arguments.
1967	* 0 - The Publicize message template: 'Check out my post: %title% @ %url'
1968	* ... - The template tags 'title', 'url', etc.
1969	* @return string
1970	*/
1971	protected static function build_sprintf( $args ) {
1972	$string = null;
1973	$search = array();
1974	$replace = array();
1975	foreach ( $args as $k => $arg ) {
1976	if ( 0 === $k ) {
1977	$string = $arg;
1978	continue;
1979	}
1980	$search[] = "%$arg%";
1981	$replace[] = "%$k\$s";
1982	}
1983	return str_replace( $search, $replace, $string );
1984	}
1985
1986	/**
1987	* Get the URL to the connections management page.
1988	*
1989	* @return string
1990	*/
1991	public function publicize_connections_url() {
1992	$has_social_admin_page = defined( 'JETPACK_SOCIAL_PLUGIN_DIR' );
1993
1994	$page = $has_social_admin_page ? 'jetpack-social' : 'jetpack#/sharing';
1995
1996	return ( new Paths() )->admin_url( array( 'page' => $page ) );
1997	}
1998
1999	/**
2000	* Get the Jetpack Social info from the API.
2001	*
2002	* @param int $blog_id The WPCOM blog_id for the current blog.
2003	* @return array
2004	*/
2005	public function get_api_data( $blog_id ) {
2006	static $api_data_response = null;
2007	$key = 'jetpack_social_api_data';
2008
2009	if ( isset( $api_data_response ) ) {
2010	return ! is_wp_error( $api_data_response ) ? $api_data_response : array();
2011	}
2012
2013	$response = Client::wpcom_json_api_request_as_blog(
2014	sprintf( 'sites/%d/jetpack-social', absint( $blog_id ) ),
2015	'2',
2016	array(
2017	'headers' => array( 'content-type' => 'application/json' ),
2018	'method' => 'GET',
2019	),
2020	null,
2021	'wpcom'
2022	);
2023	$api_data_response = Publicize_Utils::make_proper_response( $response );
2024
2025	if ( ! is_wp_error( $api_data_response ) ) {
2026	set_transient( $key, $api_data_response, DAY_IN_SECONDS );
2027	return $api_data_response;
2028	}
2029
2030	$cached_response = get_transient( $key );
2031	if ( ! empty( $cached_response ) ) {
2032	return $cached_response;
2033	}
2034
2035	return array();
2036	}
2037
2038	/**
2039	* Check if enhanced publishing is enabled.
2040	*
2041	* @deprecated $$next-version use Automattic\Jetpack\Publicize\Publicize_Base\has_enhanced_publishing_feature instead.
2042	* @param int $blog_id The blog ID for the current blog.
2043	* @return bool
2044	*/
2045	public function is_enhanced_publishing_enabled( $blog_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
2046	return $this->has_enhanced_publishing_feature();
2047	}
2048
2049	/**
2050	* Check if the enhanced publishing feature is enabled.
2051	*
2052	* @return bool
2053	*/
2054	public function has_enhanced_publishing_feature() {
2055	return Current_Plan::supports( 'social-enhanced-publishing' );
2056	}
2057
2058	/**
2059	* Check if the social image generator is enabled.
2060	*
2061	* @deprecated 0.24.2 use Automattic\Jetpack\Publicize\Publicize_Base\has_social_image_generator_feature instead.
2062	* @param int $blog_id The blog ID for the current blog.
2063	* @return bool
2064	*/
2065	public function is_social_image_generator_enabled( $blog_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
2066	return $this->has_social_image_generator_feature();
2067	}
2068
2069	/**
2070	* Check if the social image generator is enabled.
2071	*
2072	* @return bool
2073	*/
2074	public function has_social_image_generator_feature() {
2075	return Current_Plan::supports( 'social-image-generator' );
2076	}
2077
2078	/**
2079	* Check if the auto-conversion feature is one of the active features.
2080	*
2081	* TODO: Remove this after certain releases of Jetpack v15.
2082	*
2083	* @param string $type Whether image or video.
2084	*
2085	* @return bool
2086	*/
2087	public function has_social_auto_conversion_feature( $type ) {
2088	return Current_Plan::supports( "social-$type-auto-convert" );
2089	}
2090
2091	/**
2092	* Check if a connection is enabled.
2093	*
2094	* @param string $connection The connection name like 'instagram', 'mastodon', 'nextdoor' etc.
2095	*
2096	* @return bool
2097	*/
2098	public function has_connection_feature( $connection ) {
2099	return Current_Plan::supports( "social-$connection-connection" );
2100	}
2101
2102	/**
2103	* Check if the new connections management is enabled is enabled.
2104	*
2105	* @return bool
2106	*/
2107	public function has_connections_management_feature() {
2108	return Current_Plan::supports( 'social-connections-management' );
2109	}
2110
2111	/**
2112	* Get a list of additional connections that are supported by the current plan.
2113	*
2114	* @return array
2115	*/
2116	public function get_supported_additional_connections() {
2117	$additional_connections = array();
2118
2119	if ( $this->has_connection_feature( 'threads' ) ) {
2120	$additional_connections[] = 'threads';
2121	}
2122
2123	return $additional_connections;
2124	}
2125
2126	/**
2127	* Check if we have a paid Jetpack Social plan.
2128	*
2129	* @param bool $refresh_from_wpcom Whether to force refresh the plan check.
2130	*
2131	* @return bool True if we have a paid plan, false otherwise.
2132	*/
2133	public function has_paid_plan( $refresh_from_wpcom = false ) {
2134	static $has_paid_plan = null;
2135	if ( null === $has_paid_plan ) {
2136	$has_paid_plan = Current_Plan::supports( 'social-shares-1000', $refresh_from_wpcom );
2137	}
2138	return $has_paid_plan;
2139	}
2140
2141	/**
2142	* Check if we have paid features enabled.
2143	*
2144	* @return bool True if we have paid features, false otherwise.
2145	*/
2146	public function has_paid_features() {
2147	return $this->has_enhanced_publishing_feature();
2148	}
2149
2150	/**
2151	* Get an array with all dismissed notices.
2152	*
2153	* @return array
2154	*/
2155	public function get_dismissed_notices() {
2156	$dismissed_notices = get_option( self::OPTION_JETPACK_SOCIAL_DISMISSED_NOTICES );
2157
2158	if ( ! is_array( $dismissed_notices ) ) {
2159	return array();
2160	}
2161
2162	return $dismissed_notices;
2163	}
2164
2165	/**
2166	* Whether the current user can manage a connection.
2167	*
2168	* @param array $connection_data The connection data.
2169	*
2170	* @return bool
2171	*/
2172	public static function can_manage_connection( $connection_data ) {
2173	return current_user_can( 'edit_others_posts' ) \|\| get_current_user_id() === (int) $connection_data['user_id'];
2174	}
2175	}
2176
2177	// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move these functions to some other file.
2178
2179	/**
2180	* Get Calypso URL for Publicize connections.
2181	*
2182	* @return string
2183	*/
2184	function publicize_calypso_url() {
2185	_deprecated_function( __METHOD__, '0.2.0', 'Publicize::publicize_connections_url' );
2186	return Redirect::get_url( 'calypso-marketing-connections', array( 'site' => ( new Status() )->get_site_suffix() ) );
2187	}
2188
2189	/**
2190	* Adds support for the post-thumbnails feature, regardless of underlying theme support.
2191	*
2192	* This ensures the featured image UI appears in the editor, allowing the user to
2193	* explicitly set an image for their social media post.
2194	*/
2195	function add_theme_post_thumbnails_support() {
2196	add_theme_support( 'post-thumbnails', get_post_types_by_support( 'publicize' ) );
2197	}
2198