jetpack / jetpack_vendor / automattic / jetpack-sharing-likes / src / settings / class-environment.php

class-environment.php in Jetpack – WP Security, Backup, Speed, & Growth 16.3-a.5, at jetpack_vendor/automattic/jetpack-sharing-likes/src/settings/class-environment.php

246 lines 8.0 KB

Raw Download Zip

1	<?php
2	/**
3	* Reads the site state that Settings > Sharing branches on.
4	*
5	* @package automattic/jetpack-sharing-likes
6	*/
7
8	declare( strict_types = 1 );
9
10	namespace Automattic\Jetpack\Sharing_Likes\Settings;
11
12	use Automattic\Jetpack\Connection\Manager as Connection_Manager;
13	use Automattic\Jetpack\Modules;
14	use Automattic\Jetpack\Status;
15	use Automattic\Jetpack\Status\Host;
16
17	/**
18	* The facts Settings > Sharing branches on, read in one place so the sections
19	* and the state resolver stay free of environment lookups.
20	*/
21	final class Environment {
22
23	/**
24	* Memoised Site Editor URL, since resolving the template hits the theme's files.
25	*
26	* @var string\|null
27	*/
28	private static $single_template_editor_url = null;
29
30	/**
31	* Whether the active theme is a block theme.
32	*/
33	public static function is_block_theme(): bool {
34	return wp_is_block_theme();
35	}
36
37	/**
38	* Whether this is a WordPress.com Simple site.
39	*/
40	public static function is_simple_site(): bool {
41	return ( new Host() )->is_wpcom_simple();
42	}
43
44	/**
45	* Whether sharing buttons can still produce output.
46	*/
47	public static function sharing_module_running(): bool {
48	return self::legacy_sharing_supported() && self::module_active( 'sharedaddy' );
49	}
50
51	/**
52	* Whether every sharing service has been removed, so sharedaddy renders nothing.
53	*
54	* An absent option is not that: `Sharing_Service::get_blog_services()` falls
55	* back to its default services when the option was never saved.
56	*/
57	public static function legacy_sharing_switched_off(): bool {
58	$services = get_option( 'sharing-services' );
59
60	if ( ! is_array( $services ) ) {
61	return false;
62	}
63
64	return empty( $services['visible'] ) && empty( $services['hidden'] );
65	}
66
67	/**
68	* Whether this site can have legacy sharing buttons at all.
69	*
70	* The module needs no connection, but `Jetpack::load_modules()` includes
71	* nothing on a site that is neither connected nor in offline mode, and
72	* `Modules::activate()` refuses there too: an active module renders no
73	* buttons, and offering to turn it on would do nothing. Simple loads
74	* sharedaddy from `post-flair.php` without either.
75	*/
76	public static function legacy_sharing_supported(): bool {
77	return self::is_simple_site() \|\| self::is_connected() \|\| ( new Status() )->is_offline_mode();
78	}
79
80	/**
81	* Whether Settings > Sharing has anything to offer this site.
82	*
83	* Neither the legacy features nor their blocks load on a site that is neither
84	* connected nor in offline mode. Checking sharing alone is enough: any site
85	* that can have Like buttons (connected, or Simple) passes that check too.
86	*/
87	public static function settings_screen_supported(): bool {
88	return self::legacy_sharing_supported();
89	}
90
91	/**
92	* Whether this site can have Like buttons at all.
93	*
94	* The Likes module declares `Requires Connection: Yes`, so without a
95	* WordPress.com connection it cannot be activated and its buttons cannot
96	* render: the widget is keyed on the blog ID a connection provides.
97	*/
98	public static function likes_supported(): bool {
99	return self::is_simple_site() \|\| self::is_connected();
100	}
101
102	/**
103	* Whether the site holds a WordPress.com connection.
104	*/
105	private static function is_connected(): bool {
106	return ( new Connection_Manager( 'jetpack' ) )->is_connected();
107	}
108
109	/**
110	* Whether Like buttons can still produce output.
111	*
112	* The module can be left active in the options through a disconnect,
113	* which is why support is checked too.
114	*/
115	public static function likes_module_running(): bool {
116	return self::likes_supported() && self::module_active( 'likes' );
117	}
118
119	/**
120	* Whether Simple's posts show neither a Like nor a Reblog button, bar those that opted in individually.
121	*
122	* Both count because the legacy widget renders for either. Jetpack and Atomic never
123	* render Reblog, and switch to the block by turning the module off instead.
124	*/
125	public static function legacy_likes_switched_off(): bool {
126	return self::is_simple_site()
127	&& ! Likes_Options::likes_enabled_sitewide()
128	&& ! Likes_Options::reblogs_enabled_sitewide();
129	}
130
131	/**
132	* Whether comments can still be liked.
133	*
134	* Comment Likes is its own module, but it reads the Likes settings: both
135	* `disabled_likes` and the shared placement gate `is_likes_visible()`. So a
136	* site running it without the Likes module still needs those controls.
137	*/
138	public static function comment_likes_module_running(): bool {
139	return self::likes_supported() && self::module_active( 'comment-likes' );
140	}
141
142	/**
143	* Whether Comment Likes are switched on for this site.
144	*
145	* - On WordPress.com Simple, which has no modules: the `jetpack_comment_likes_enabled` option.
146	* - On Atomic and self-hosted Jetpack sites: the Comment Likes module, which never reads that option.
147	*/
148	public static function comment_likes_enabled(): bool {
149	return self::is_simple_site() ? Likes_Options::comment_likes_enabled() : self::comment_likes_module_running();
150	}
151
152	/**
153	* Whether Comment Likes read the Likes settings: the sitewide default and placement. Simple's do not.
154	*/
155	public static function comment_likes_follow_likes_settings(): bool {
156	return ! self::is_simple_site() && self::comment_likes_module_running();
157	}
158
159	/**
160	* Whether anything on this site still reads the Likes settings.
161	*
162	* Both features are gated on `disabled_likes` and the shared placement, so
163	* either one running makes the Likes placement defaults the ones that apply.
164	*/
165	public static function likes_settings_in_use(): bool {
166	return self::likes_module_running() \|\| self::comment_likes_module_running();
167	}
168
169	/**
170	* Whether anything on this site reads the Twitter Site Tag option.
171	*
172	* Twitter Cards read it, and through them the Sharing Buttons block's X `via`.
173	* Simple's Twitter Cards read `twitter_via`, which wpcom serves and saves this option from.
174	*/
175	public static function twitter_site_tag_used(): bool {
176	/** This filter is documented in projects/plugins/jetpack/class.jetpack.php */
177	return ! apply_filters( 'jetpack_disable_twitter_cards', false );
178	}
179
180	/**
181	* Whether a module is active.
182	*
183	* Simple has no modules: wpcom loads both features on every request, so
184	* every module counts as active there whatever the option holds.
185	*
186	* @param string $slug Module slug.
187	*/
188	private static function module_active( string $slug ): bool {
189	return self::is_simple_site() \|\| ( new Modules() )->is_active( $slug );
190	}
191
192	/**
193	* Whether the Sharing Buttons block is available to offer as an alternative.
194	*/
195	public static function sharing_block_registered(): bool {
196	return self::block_is_registered( 'jetpack/sharing-buttons' );
197	}
198
199	/**
200	* Whether the Like block is available to offer as an alternative.
201	*/
202	public static function like_block_registered(): bool {
203	return self::block_is_registered( 'jetpack/like' );
204	}
205
206	/**
207	* Site Editor URL for the active theme's single post template.
208	*
209	* Empty when the theme has no `single` template, which callers treat as
210	* "offer no Site Editor link" rather than linking somewhere that 404s: a
211	* block theme shipping only `index.html` is the case that hits this.
212	*/
213	public static function single_template_editor_url(): string {
214	if ( null !== self::$single_template_editor_url ) {
215	return self::$single_template_editor_url;
216	}
217
218	$stylesheet = get_stylesheet();
219	$template = $stylesheet ? $stylesheet . '//single' : '';
220
221	if ( ! $template \|\| ! get_block_template( $template ) ) {
222	self::$single_template_editor_url = '';
223
224	return self::$single_template_editor_url;
225	}
226
227	// `add_query_arg()` does not encode, and the Site Editor router wants `p` percent-encoded.
228	self::$single_template_editor_url = admin_url(
229	'site-editor.php?p=' . rawurlencode( '/wp_template/' . $template ) . '&canvas=edit'
230	);
231
232	return self::$single_template_editor_url;
233	}
234
235	/**
236	* Whether a block is registered, and so available to add to a template.
237	*
238	* Registration happens on `init`, well before this screen renders.
239	*
240	* @param string $name Fully qualified block name.
241	*/
242	private static function block_is_registered( string $name ): bool {
243	return \WP_Block_Type_Registry::get_instance()->is_registered( $name );
244	}
245	}
246