Completed
Push — fix/warning-if-plugins-use-pac... ( 301620...43d699 )
by Marin
800:31 queued 793:58
created

JITM::get_messages()   F

Complexity

Conditions 26
Paths 10457

Size

Total Lines 179

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 26
nc 10457
nop 2
dl 0
loc 179
rs 0
c 0
b 0
f 0

How to fix   Long Method    Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
3
namespace Automattic\Jetpack;
4
5
use Automattic\Jetpack\Asset_Tools;
6
use Automattic\Jetpack\Connection\Manager as Jetpack_Connection;
7
use Automattic\Jetpack\Assets\Logo as Jetpack_Logo;
8
use Automattic\Jetpack\Tracking;
9
10
/**
11
 * Jetpack just in time messaging through out the admin
12
 *
13
 * @since 5.6.0
14
 */
15
class JITM {
16
17
	const PACKAGE_VERSION = '1.0';
18
19
	public function register() {
20
		/**
21
		 * Filter to turn off all just in time messages
22
		 *
23
		 * @since 3.7.0
24
		 * @since 5.4.0 Correct docblock to reflect default arg value
25
		 *
26
		 * @param bool false Whether to show just in time messages.
27
		 */
28
		if ( ! apply_filters( 'jetpack_just_in_time_msgs', false ) ) {
29
			return false;
30
		}
31
		add_action( 'current_screen', array( $this, 'prepare_jitms' ) );
32
		return true;
33
	}
34
35
	/**
36
	 * Get's the Jetpack emblem
37
	 *
38
	 * @return string The Jetpack emblem
39
	 */
40
	function get_emblem() {
41
		$jetpack_logo = new Jetpack_Logo();
42
		return '<div class="jp-emblem">' . $jetpack_logo->get_jp_emblem() . '</div>';
43
	}
44
45
	/**
46
	 * Prepare actions according to screen and post type.
47
	 *
48
	 * @since 3.8.2
49
	 *
50
	 * @uses Jetpack_Autoupdate::get_possible_failures()
51
	 *
52
	 * @param object $screen
53
	 */
54
	function prepare_jitms( $screen ) {
55
		if ( ! in_array(
56
			$screen->id,
57
			array(
58
				'jetpack_page_stats',
59
				'jetpack_page_akismet-key-config',
60
				'admin_page_jetpack_modules',
61
			)
62
		) ) {
63
			add_action( 'admin_enqueue_scripts', array( $this, 'jitm_enqueue_files' ) );
64
			add_action( 'admin_notices', array( $this, 'ajax_message' ) );
65
			add_action( 'edit_form_top', array( $this, 'ajax_message' ) );
66
		}
67
	}
68
69
	/**
70
	 * A special filter for WooCommerce, to set a message based on local state.
71
	 *
72
	 * @param $message string The current message
73
	 *
74
	 * @return array The new message
75
	 */
76
	static function jitm_woocommerce_services_msg( $content ) {
77
		if ( ! function_exists( 'wc_get_base_location' ) ) {
78
			return $content;
79
		}
80
81
		$base_location = wc_get_base_location();
82
83
		switch ( $base_location['country'] ) {
84
			case 'US':
85
				$content->message = esc_html__( 'New free service: Show USPS shipping rates on your store! Added bonus: print shipping labels without leaving WooCommerce.', 'jetpack' );
86
				break;
87
			case 'CA':
88
				$content->message = esc_html__( 'New free service: Show Canada Post shipping rates on your store!', 'jetpack' );
89
				break;
90
			default:
91
				$content->message = '';
92
		}
93
94
		return $content;
95
	}
96
97
	/**
98
	 * A special filter for WooCommerce Call To Action button
99
	 *
100
	 * @param $CTA string The existing CTA
101
	 *
102
	 * @return string The new CTA
103
	 */
104
	static function jitm_jetpack_woo_services_install( $CTA ) {
105
		return wp_nonce_url(
106
			add_query_arg(
107
				array(
108
					'wc-services-action' => 'install',
109
				),
110
				admin_url( 'admin.php?page=wc-settings' )
111
			),
112
			'wc-services-install'
113
		);
114
	}
115
116
	/**
117
	 * A special filter for WooCommerce Call To Action button
118
	 *
119
	 * @param $CTA string The existing CTA
120
	 *
121
	 * @return string The new CTA
122
	 */
123
	static function jitm_jetpack_woo_services_activate( $CTA ) {
124
		return wp_nonce_url(
125
			add_query_arg(
126
				array(
127
					'wc-services-action' => 'activate',
128
				),
129
				admin_url( 'admin.php?page=wc-settings' )
130
			),
131
			'wc-services-install'
132
		);
133
	}
134
135
	/**
136
	 * Injects the dom to show a JITM inside of
137
	 */
138
	function ajax_message() {
139
		$message_path   = $this->get_message_path();
140
		$query_string   = _http_build_query( $_GET, '', ',' );
141
		$current_screen = wp_unslash( $_SERVER['REQUEST_URI'] );
142
		?>
143
		<div class="jetpack-jitm-message"
144
			 data-nonce="<?php echo wp_create_nonce( 'wp_rest' ); ?>"
145
			 data-message-path="<?php echo esc_attr( $message_path ); ?>"
146
			 data-query="<?php echo urlencode_deep( $query_string ); ?>"
147
			 data-redirect="<?php echo urlencode_deep( $current_screen ); ?>"
148
		></div>
149
		<?php
150
	}
151
152
	/**
153
	 * Get's the current message path for display of a JITM
154
	 *
155
	 * @return string The message path
156
	 */
157
	function get_message_path() {
158
		$screen = get_current_screen();
159
160
		return 'wp:' . $screen->id . ':' . current_filter();
161
	}
162
163
	/**
164
	 * Function to enqueue jitm css and js
165
	 */
166
	function jitm_enqueue_files() {
167
		$asset_manager = new Asset_Tools();
168
		$min           = ''; // ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? '' : '.min';
169
		wp_register_style(
170
			'jetpack-jitm-css',
171
			plugins_url( "assets/jetpack-admin-jitm{$min}.css", __DIR__ ),
172
			false,
173
			self::PACKAGE_VERSION .
174
			'-201243242'
175
		);
176
		wp_style_add_data( 'jetpack-jitm-css', 'rtl', 'replace' );
177
		wp_style_add_data( 'jetpack-jitm-css', 'suffix', $min );
178
		wp_enqueue_style( 'jetpack-jitm-css' );
179
180
		wp_enqueue_script(
181
			'jetpack-jitm-new',
182
			$asset_manager->get_file_url_for_environment( '_inc/build/jetpack-jitm.min.js', '_inc/jetpack-jitm.js' ),
183
			array( 'jquery' ),
184
			self::PACKAGE_VERSION, // TODO: Keep in sync with version specified in composer.json
185
			true
186
		);
187
		wp_localize_script(
188
			'jetpack-jitm-new',
189
			'jitm_config',
190
			array(
191
				'api_root'               => esc_url_raw( rest_url() ),
192
				'activate_module_text'   => esc_html__( 'Activate', 'jetpack' ),
193
				'activated_module_text'  => esc_html__( 'Activated', 'jetpack' ),
194
				'activating_module_text' => esc_html__( 'Activating', 'jetpack' ),
195
			)
196
		);
197
	}
198
199
	/**
200
	 * Dismisses a JITM feature class so that it will no longer be shown
201
	 *
202
	 * @param $id string The id of the JITM that was dismissed
203
	 * @param $feature_class string The feature class of the JITM that was dismissed
204
	 *
205
	 * @return bool Always true
206
	 */
207
	function dismiss( $id, $feature_class ) {
208
		Tracking::record_user_event(
209
			'jitm_dismiss_client',
210
			array(
211
				'jitm_id'       => $id,
212
				'feature_class' => $feature_class,
213
			)
214
		);
215
216
		$hide_jitm = \Jetpack_Options::get_option( 'hide_jitm' );
217
		if ( ! is_array( $hide_jitm ) ) {
218
			$hide_jitm = array();
219
		}
220
221
		if ( isset( $hide_jitm[ $feature_class ] ) ) {
222
			if ( ! is_array( $hide_jitm[ $feature_class ] ) ) {
223
				$hide_jitm[ $feature_class ] = array(
224
					'last_dismissal' => 0,
225
					'number'         => 0,
226
				);
227
			}
228
		} else {
229
			$hide_jitm[ $feature_class ] = array(
230
				'last_dismissal' => 0,
231
				'number'         => 0,
232
			);
233
		}
234
235
		$number = $hide_jitm[ $feature_class ]['number'];
236
237
		$hide_jitm[ $feature_class ] = array(
238
			'last_dismissal' => time(),
239
			'number'         => $number + 1,
240
		);
241
242
		\Jetpack_Options::update_option( 'hide_jitm', $hide_jitm );
243
244
		return true;
245
	}
246
247
	/**
248
	 * Asks the wpcom API for the current message to display keyed on query string and message path
249
	 *
250
	 * @param $message_path string The message path to ask for
251
	 * @param $query string The query string originally from the front end
252
	 *
253
	 * @return array The JITM's to show, or an empty array if there is nothing to show
254
	 */
255
	function get_messages( $message_path, $query ) {
256
		// custom filters go here
257
		add_filter( 'jitm_woocommerce_services_msg', array( 'Jetpack_JITM', 'jitm_woocommerce_services_msg' ) );
258
		add_filter( 'jitm_jetpack_woo_services_install', array( 'Jetpack_JITM', 'jitm_jetpack_woo_services_install' ) );
259
		add_filter(
260
			'jitm_jetpack_woo_services_activate',
261
			array(
262
				'Jetpack_JITM',
263
				'jitm_jetpack_woo_services_activate',
264
			)
265
		);
266
267
		$user = wp_get_current_user();
268
269
		// unauthenticated or invalid requests just bail
270
		if ( ! $user ) {
271
			return array();
272
		}
273
274
		require_once JETPACK__PLUGIN_DIR . 'class.jetpack-client.php';
275
276
		$site_id = \Jetpack_Options::get_option( 'id' );
277
278
		// build our jitm request
279
		$path = add_query_arg(
280
			array(
281
				'external_user_id' => urlencode_deep( $user->ID ),
282
				'query_string'     => urlencode_deep( $query ),
283
				'mobile_browser'   => jetpack_is_mobile( 'smart' ) ? 1 : 0,
284
				'_locale'          => get_user_locale(),
285
			),
286
			sprintf( '/sites/%d/jitm/%s', $site_id, $message_path )
287
		);
288
289
		// attempt to get from cache
290
		$envelopes = get_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ) );
291
292
		// if something is in the cache and it was put in the cache after the last sync we care about, use it
293
		$use_cache = false;
294
295
		/** This filter is documented in class.jetpack.php */
296
		if ( apply_filters( 'jetpack_just_in_time_msg_cache', false ) ) {
297
			$use_cache = true;
298
		}
299
300
		if ( $use_cache ) {
301
			$last_sync  = (int) get_transient( 'jetpack_last_plugin_sync' );
302
			$from_cache = $envelopes && $last_sync > 0 && $last_sync < $envelopes['last_response_time'];
303
		} else {
304
			$from_cache = false;
305
		}
306
307
		// otherwise, ask again
308
		if ( ! $from_cache ) {
309
			$wpcom_response = \Jetpack_Client::wpcom_json_api_request_as_blog(
310
				$path,
311
				'2',
312
				array(
313
					'user_id'    => $user->ID,
314
					'user_roles' => implode( ',', $user->roles ),
315
				),
316
				null,
317
				'wpcom'
318
			);
319
320
			// silently fail...might be helpful to track it?
321
			if ( is_wp_error( $wpcom_response ) ) {
322
				return array();
323
			}
324
325
			$envelopes = json_decode( $wpcom_response['body'] );
326
327
			if ( ! is_array( $envelopes ) ) {
328
				return array();
329
			}
330
331
			$expiration = isset( $envelopes[0] ) ? $envelopes[0]->ttl : 300;
332
333
			// do not cache if expiration is 0 or we're not using the cache
334
			if ( 0 != $expiration && $use_cache ) {
335
				$envelopes['last_response_time'] = time();
336
337
				set_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ), $envelopes, $expiration );
338
			}
339
		}
340
341
		$hidden_jitms = \Jetpack_Options::get_option( 'hide_jitm' );
342
		unset( $envelopes['last_response_time'] );
343
344
		/**
345
		 * Allow adding your own custom JITMs after a set of JITMs has been received.
346
		 *
347
		 * @since 6.9.0
348
		 *
349
		 * @param array $envelopes array of existing JITMs.
350
		 */
351
		$envelopes = apply_filters( 'jetpack_jitm_received_envelopes', $envelopes );
352
353
		foreach ( $envelopes as $idx => &$envelope ) {
354
355
			$dismissed_feature = isset( $hidden_jitms[ $envelope->feature_class ] ) && is_array( $hidden_jitms[ $envelope->feature_class ] ) ? $hidden_jitms[ $envelope->feature_class ] : null;
356
357
			// if the this feature class has been dismissed and the request has not passed the ttl, skip it as it's been dismissed
358
			if ( is_array( $dismissed_feature ) && ( time() - $dismissed_feature['last_dismissal'] < $envelope->expires || $dismissed_feature['number'] >= $envelope->max_dismissal ) ) {
359
				unset( $envelopes[ $idx ] );
360
				continue;
361
			}
362
363
			Tracking::record_user_event(
364
				'jitm_view_client',
365
				array(
366
					'jitm_id' => $envelope->id,
367
				)
368
			);
369
370
			$normalized_site_url = \Jetpack::build_raw_urls( get_home_url() );
371
372
			$url_params = array(
373
				'source' => "jitm-$envelope->id",
374
				'site'   => $normalized_site_url,
375
				'u'      => $user->ID,
376
			);
377
378
			if ( ! class_exists( 'Jetpack_Affiliate' ) ) {
379
				require_once JETPACK__PLUGIN_DIR . 'class.jetpack-affiliate.php';
380
			}
381
			// Get affiliate code and add it to the array of URL parameters
382
			if ( '' !== ( $aff = \Jetpack_Affiliate::init()->get_affiliate_code() ) ) {
383
				$url_params['aff'] = $aff;
384
			}
385
386
			$envelope->url = add_query_arg( $url_params, 'https://jetpack.com/redirect/' );
387
388
			$envelope->jitm_stats_url = \Jetpack::build_stats_url( array( 'x_jetpack-jitm' => $envelope->id ) );
389
390
			if ( $envelope->CTA->hook ) {
391
				$envelope->url = apply_filters( 'jitm_' . $envelope->CTA->hook, $envelope->url );
392
				unset( $envelope->CTA->hook );
393
			}
394
395
			if ( isset( $envelope->content->hook ) ) {
396
				$envelope->content = apply_filters( 'jitm_' . $envelope->content->hook, $envelope->content );
397
				unset( $envelope->content->hook );
398
			}
399
400
			// no point in showing an empty message
401
			if ( empty( $envelope->content->message ) ) {
402
				unset( $envelopes[ $idx ] );
403
				continue;
404
			}
405
406
			switch ( $envelope->content->icon ) {
407
				case 'jetpack':
408
					$jetpack_logo            = new Jetpack_Logo();
409
					$envelope->content->icon = '<div class="jp-emblem">' . $jetpack_logo->get_jp_emblem() . '</div>';
410
					break;
411
				case 'woocommerce':
412
					$envelope->content->icon = '<div class="jp-emblem"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" id="Layer_1" x="0px" y="0px" viewBox="0 0 168 100" xml:space="preserve" enable-background="new 0 0 168 100" width="50" height="30"><style type="text/css">
413
					.st0{clip-path:url(#SVGID_2_);enable-background:new    ;}
414
					.st1{clip-path:url(#SVGID_4_);}
415
					.st2{clip-path:url(#SVGID_6_);}
416
					.st3{clip-path:url(#SVGID_8_);fill:#8F567F;}
417
					.st4{clip-path:url(#SVGID_10_);fill:#FFFFFE;}
418
					.st5{clip-path:url(#SVGID_12_);fill:#FFFFFE;}
419
					.st6{clip-path:url(#SVGID_14_);fill:#FFFFFE;}
420
				</style><g><defs><polygon id="SVGID_1_" points="83.8 100 0 100 0 0.3 83.8 0.3 167.6 0.3 167.6 100 "/></defs><clipPath id="SVGID_2_"><use xlink:href="#SVGID_1_" overflow="visible"/></clipPath><g class="st0"><g><defs><rect id="SVGID_3_" width="168" height="100"/></defs><clipPath id="SVGID_4_"><use xlink:href="#SVGID_3_" overflow="visible"/></clipPath><g class="st1"><defs><path id="SVGID_5_" d="M15.6 0.3H152c8.6 0 15.6 7 15.6 15.6v52c0 8.6-7 15.6-15.6 15.6h-48.9l6.7 16.4L80.2 83.6H15.6C7 83.6 0 76.6 0 67.9v-52C0 7.3 7 0.3 15.6 0.3"/></defs><clipPath id="SVGID_6_"><use xlink:href="#SVGID_5_" overflow="visible"/></clipPath><g class="st2"><defs><rect id="SVGID_7_" width="168" height="100"/></defs><clipPath id="SVGID_8_"><use xlink:href="#SVGID_7_" overflow="visible"/></clipPath><rect x="-10" y="-9.7" class="st3" width="187.6" height="119.7"/></g></g></g></g></g><g><defs><path id="SVGID_9_" d="M8.4 14.5c1-1.3 2.4-2 4.3-2.1 3.5-0.2 5.5 1.4 6 4.9 2.1 14.3 4.4 26.4 6.9 36.4l15-28.6c1.4-2.6 3.1-3.9 5.2-4.1 3-0.2 4.9 1.7 5.6 5.7 1.7 9.1 3.9 16.9 6.5 23.4 1.8-17.4 4.8-30 9-37.7 1-1.9 2.5-2.9 4.5-3 1.6-0.1 3 0.3 4.3 1.4 1.3 1 2 2.3 2.1 3.9 0.1 1.2-0.1 2.3-0.7 3.3 -2.7 5-4.9 13.2-6.6 24.7 -1.7 11.1-2.3 19.8-1.9 26.1 0.1 1.7-0.1 3.2-0.8 4.5 -0.8 1.5-2 2.4-3.7 2.5 -1.8 0.1-3.6-0.7-5.4-2.5C52.4 66.7 47.4 57 43.7 44.1c-4.4 8.8-7.7 15.3-9.9 19.7 -4 7.7-7.5 11.7-10.3 11.9 -1.9 0.1-3.5-1.4-4.8-4.7 -3.5-9-7.3-26.3-11.3-52C7.1 17.3 7.5 15.8 8.4 14.5"/></defs><clipPath id="SVGID_10_"><use xlink:href="#SVGID_9_" overflow="visible"/></clipPath><rect x="-2.7" y="-0.6" class="st4" width="90.6" height="86.4"/></g><g><defs><path id="SVGID_11_" d="M155.6 25.2c-2.5-4.3-6.1-6.9-11-7.9 -1.3-0.3-2.5-0.4-3.7-0.4 -6.6 0-11.9 3.4-16.1 10.2 -3.6 5.8-5.3 12.3-5.3 19.3 0 5.3 1.1 9.8 3.3 13.6 2.5 4.3 6.1 6.9 11 7.9 1.3 0.3 2.5 0.4 3.7 0.4 6.6 0 12-3.4 16.1-10.2 3.6-5.9 5.3-12.4 5.3-19.4C159 33.4 157.9 28.9 155.6 25.2zM147 44.2c-0.9 4.5-2.7 7.9-5.2 10.1 -2 1.8-3.9 2.5-5.5 2.2 -1.7-0.3-3-1.8-4-4.4 -0.8-2.1-1.2-4.2-1.2-6.2 0-1.7 0.2-3.4 0.5-5 0.6-2.8 1.8-5.5 3.6-8.1 2.3-3.3 4.7-4.8 7.1-4.2 1.7 0.3 3 1.8 4 4.4 0.8 2.1 1.2 4.2 1.2 6.2C147.5 40.9 147.3 42.6 147 44.2z"/></defs><clipPath id="SVGID_12_"><use xlink:href="#SVGID_11_" overflow="visible"/></clipPath><rect x="109.6" y="6.9" class="st5" width="59.4" height="71.4"/></g><g><defs><path id="SVGID_13_" d="M112.7 25.2c-2.5-4.3-6.1-6.9-11-7.9 -1.3-0.3-2.5-0.4-3.7-0.4 -6.6 0-11.9 3.4-16.1 10.2 -3.5 5.8-5.3 12.3-5.3 19.3 0 5.3 1.1 9.8 3.3 13.6 2.5 4.3 6.1 6.9 11 7.9 1.3 0.3 2.5 0.4 3.7 0.4 6.6 0 12-3.4 16.1-10.2 3.5-5.9 5.3-12.4 5.3-19.4C116 33.4 114.9 28.9 112.7 25.2zM104.1 44.2c-0.9 4.5-2.7 7.9-5.2 10.1 -2 1.8-3.9 2.5-5.5 2.2 -1.7-0.3-3-1.8-4-4.4 -0.8-2.1-1.2-4.2-1.2-6.2 0-1.7 0.2-3.4 0.5-5 0.6-2.8 1.8-5.5 3.6-8.1 2.3-3.3 4.7-4.8 7.1-4.2 1.7 0.3 3 1.8 4 4.4 0.8 2.1 1.2 4.2 1.2 6.2C104.6 40.9 104.4 42.6 104.1 44.2z"/></defs><clipPath id="SVGID_14_"><use xlink:href="#SVGID_13_" overflow="visible"/></clipPath><rect x="66.7" y="6.9" class="st6" width="59.4" height="71.4"/></g></svg></div>';
421
					break;
422
				default:
423
					$envelope->content->icon = '';
424
					break;
425
			}
426
427
			$jetpack = \Jetpack::init();
428
			$jetpack->stat( 'jitm', $envelope->id . '-viewed-' . JETPACK__VERSION );
429
			$jetpack->do_stats( 'server_side' );
430
		}
431
432
		return $envelopes;
433
	}
434
}
435