jetpack / modules / publicize.php

publicize.php in Jetpack – WP Security, Backup, Speed, & Growth 13.1.2, at modules/publicize.php

133 lines 4.2 KB

Raw Download Zip

1	<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2	/**
3	* Module Name: Jetpack Social
4	* Module Description: Jetpack Social makes it easy to share your site’s posts on several social media networks automatically when you publish a new post.
5	* Sort Order: 10
6	* Recommendation Order: 7
7	* First Introduced: 2.0
8	* Requires Connection: Yes
9	* Requires User Connection: Yes
10	* Auto Activate: No
11	* Module Tags: Social, Recommended
12	* Feature: Engagement
13	* Additional Search Queries: facebook, jetpack publicize, tumblr, linkedin, social, tweet, connections, sharing, social media, automated, automated sharing, auto publish, auto tweet and like, auto tweet, facebook auto post, facebook posting
14	*
15	* @package automattic/jetpack
16	*/
17
18	// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
19
20	/**
21	* Class Jetpack_Publicize
22	*/
23	class Jetpack_Publicize {
24	/**
25	* Current status about Jetpack modules.
26	*
27	* @var Modules
28	*/
29	public $modules;
30
31	/**
32	* If Publicize is executing within Jetpack.
33	*
34	* @var bool
35	*/
36	public $in_jetpack = true;
37
38	/**
39	* Jetpack_Publicize constructor.
40	*/
41	public function __construct() {
42	global $publicize_ui;
43
44	$this->modules = new Automattic\Jetpack\Modules();
45	$this->in_jetpack = ( class_exists( 'Jetpack' ) && method_exists( 'Jetpack', 'enable_module_configurable' ) ) ? true : false;
46
47	if ( $this->in_jetpack ) {
48	Jetpack::enable_module_configurable( __FILE__ );
49
50	// if sharedaddy isn't active, the sharing menu hasn't been added yet.
51	if ( $this->modules->is_active( 'publicize' ) && ! $this->modules->is_active( 'sharedaddy' ) ) {
52	add_action( 'admin_menu', array( &$publicize_ui, 'sharing_menu' ) );
53	}
54
55	/*
56	* The Publicize Options array does not currently have UI since it is being added
57	* for a specific purpose and not part of a broader Publicize sprint.
58	*
59	* In order to pass the settings up to WordPress.com, we are updating an option to Sync will pass it up.
60	* To make it relatively easy for use, we are creating a filter that checks if the option and filter match.
61	*
62	* This only runs when a post is saved to avoid it running too much.
63	*/
64	add_action(
65	'save_post',
66	function () {
67	$publicize_options = get_option( 'jetpack_publicize_options', array() );
68
69	/**
70	* Filters the options for Publicize.
71	*
72	* As of Jetpack 8.5, the array keys could be:
73	* attach_media bool If Publicize should send the image to the social media platform. Default false.
74	*
75	* @module publicize
76	*
77	* @since 8.5.0
78	*
79	* @param array $options Array of Publicize options.
80	*/
81	$filtered = (array) apply_filters( 'jetpack_publicize_options', $publicize_options );
82
83	if ( $publicize_options !== $filtered ) {
84	update_option( 'jetpack_publicize_options', $filtered, false );
85	}
86	}
87	);
88	} else {
89	global $publicize;
90	require_once WP_CONTENT_DIR . '/mu-plugins/keyring/keyring.php';
91	require_once WP_CONTENT_DIR . '/admin-plugins/publicize/publicize-wpcom.php';
92	$publicize = new Publicize();
93	$publicize_ui = new Automattic\Jetpack\Publicize\Publicize_UI();
94	}
95	}
96	}
97
98	// On Jetpack, we instantiate Jetpack_Publicize only if the Publicize module is active.
99	if ( ! ( defined( 'IS_WPCOM' ) && IS_WPCOM ) ) {
100	global $publicize;
101
102	// None of this should be the case, but we can get here with a broken user connection. If that's the case
103	// then we want to stop loading any more of the module code.
104	if (
105	! ( new Automattic\Jetpack\Modules() )->is_active( 'publicize' )
106	\|\| ! Jetpack::connection()->has_connected_user()
107	\|\| ! $publicize
108	) {
109	return;
110	}
111
112	new Jetpack_Publicize();
113
114	if ( ! function_exists( 'publicize_init' ) ) {
115	/**
116	* Helper for grabbing a Publicize object from the "front-end" (non-admin) of
117	* a site. Normally Publicize is only loaded in wp-admin, so there's a little
118	* set up that you might need to do if you want to use it on the front end.
119	* Just call this function and it returns a Publicize object.
120	*
121	* @return Publicize Object
122	*/
123	function publicize_init() {
124	global $publicize;
125
126	return $publicize;
127	}
128	}
129	} else {
130	// On wpcom, instantiate Jetpack_Publicize without any other checks.
131	new Jetpack_Publicize();
132	}
133