Completed
Push — update/aag-security-card ( 06ca13...44763d )
by
unknown
204:52 queued 195:48
created

JITM::get_messages()   F

Complexity

Conditions 26
Paths 10457

Size

Total Lines 177

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 26
nc 10457
nop 2
dl 0
loc 177
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\Connection\Client;
8
use Automattic\Jetpack\Assets\Logo as Jetpack_Logo;
9
use Automattic\Jetpack\Tracking;
10
11
/**
12
 * Jetpack just in time messaging through out the admin
13
 *
14
 * @since 5.6.0
15
 */
16
class JITM {
17
18
	const PACKAGE_VERSION = '1.0';
19
20
	/**
21
	 * Tracking object.
22
	 *
23
	 * @var Automattic\Jetpack\Tracking
24
	 *
25
	 * @access private
26
	 */
27
	private $tracking;
28
29
	/**
30
	 * Constructor.
31
	 */
32
	public function __construct() {
33
		$this->tracking = new Tracking();
0 ignored issues
show
Documentation Bug introduced by
It seems like new \Automattic\Jetpack\Tracking() of type object<Automattic\Jetpack\Tracking> is incompatible with the declared type object<Automattic\Jetpac...attic\Jetpack\Tracking> of property $tracking.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
34
	}
35
36
	public function register() {
37
		/**
38
		 * Filter to turn off all just in time messages
39
		 *
40
		 * @since 3.7.0
41
		 * @since 5.4.0 Correct docblock to reflect default arg value
42
		 *
43
		 * @param bool false Whether to show just in time messages.
44
		 */
45
		if ( ! apply_filters( 'jetpack_just_in_time_msgs', false ) ) {
46
			return false;
47
		}
48
		add_action( 'current_screen', array( $this, 'prepare_jitms' ) );
49
		return true;
50
	}
51
52
	/**
53
	 * Get's the Jetpack emblem
54
	 *
55
	 * @return string The Jetpack emblem
56
	 */
57
	function get_emblem() {
58
		$jetpack_logo = new Jetpack_Logo();
59
		return '<div class="jp-emblem">' . $jetpack_logo->get_jp_emblem() . '</div>';
60
	}
61
62
	/**
63
	 * Prepare actions according to screen and post type.
64
	 *
65
	 * @since 3.8.2
66
	 *
67
	 * @uses Jetpack_Autoupdate::get_possible_failures()
68
	 *
69
	 * @param object $screen
70
	 */
71
	function prepare_jitms( $screen ) {
72
		if ( ! in_array(
73
			$screen->id,
74
			array(
75
				'jetpack_page_stats',
76
				'jetpack_page_akismet-key-config',
77
				'admin_page_jetpack_modules',
78
			)
79
		) ) {
80
			add_action( 'admin_enqueue_scripts', array( $this, 'jitm_enqueue_files' ) );
81
			add_action( 'admin_notices', array( $this, 'ajax_message' ) );
82
			add_action( 'edit_form_top', array( $this, 'ajax_message' ) );
83
		}
84
	}
85
86
	/**
87
	 * A special filter for WooCommerce, to set a message based on local state.
88
	 *
89
	 * @param $message string The current message
90
	 *
91
	 * @return array The new message
92
	 */
93
	static function jitm_woocommerce_services_msg( $content ) {
94
		if ( ! function_exists( 'wc_get_base_location' ) ) {
95
			return $content;
96
		}
97
98
		$base_location = wc_get_base_location();
99
100
		switch ( $base_location['country'] ) {
101
			case 'US':
102
				$content->message = esc_html__( 'New free service: Show USPS shipping rates on your store! Added bonus: print shipping labels without leaving WooCommerce.', 'jetpack' );
103
				break;
104
			case 'CA':
105
				$content->message = esc_html__( 'New free service: Show Canada Post shipping rates on your store!', 'jetpack' );
106
				break;
107
			default:
108
				$content->message = '';
109
		}
110
111
		return $content;
112
	}
113
114
	/**
115
	 * A special filter for WooCommerce Call To Action button
116
	 *
117
	 * @param $CTA string The existing CTA
118
	 *
119
	 * @return string The new CTA
120
	 */
121
	static function jitm_jetpack_woo_services_install( $CTA ) {
122
		return wp_nonce_url(
123
			add_query_arg(
124
				array(
125
					'wc-services-action' => 'install',
126
				),
127
				admin_url( 'admin.php?page=wc-settings' )
128
			),
129
			'wc-services-install'
130
		);
131
	}
132
133
	/**
134
	 * A special filter for WooCommerce Call To Action button
135
	 *
136
	 * @param $CTA string The existing CTA
137
	 *
138
	 * @return string The new CTA
139
	 */
140
	static function jitm_jetpack_woo_services_activate( $CTA ) {
141
		return wp_nonce_url(
142
			add_query_arg(
143
				array(
144
					'wc-services-action' => 'activate',
145
				),
146
				admin_url( 'admin.php?page=wc-settings' )
147
			),
148
			'wc-services-install'
149
		);
150
	}
151
152
	/**
153
	 * Injects the dom to show a JITM inside of
154
	 */
155
	function ajax_message() {
156
		$message_path   = $this->get_message_path();
157
		$query_string   = _http_build_query( $_GET, '', ',' );
158
		$current_screen = wp_unslash( $_SERVER['REQUEST_URI'] );
159
		?>
160
		<div class="jetpack-jitm-message"
161
			 data-nonce="<?php echo wp_create_nonce( 'wp_rest' ); ?>"
162
			 data-message-path="<?php echo esc_attr( $message_path ); ?>"
163
			 data-query="<?php echo urlencode_deep( $query_string ); ?>"
164
			 data-redirect="<?php echo urlencode_deep( $current_screen ); ?>"
165
		></div>
166
		<?php
167
	}
168
169
	/**
170
	 * Get's the current message path for display of a JITM
171
	 *
172
	 * @return string The message path
173
	 */
174
	function get_message_path() {
175
		$screen = get_current_screen();
176
177
		return 'wp:' . $screen->id . ':' . current_filter();
178
	}
179
180
	/**
181
	 * Function to enqueue jitm css and js
182
	 */
183
	function jitm_enqueue_files() {
184
		$asset_manager = new Asset_Tools();
185
		$min           = ''; // ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? '' : '.min';
186
		wp_register_style(
187
			'jetpack-jitm-css',
188
			plugins_url( "assets/jetpack-admin-jitm{$min}.css", __DIR__ ),
189
			false,
190
			self::PACKAGE_VERSION .
191
			'-201243242'
192
		);
193
		wp_style_add_data( 'jetpack-jitm-css', 'rtl', 'replace' );
194
		wp_style_add_data( 'jetpack-jitm-css', 'suffix', $min );
195
		wp_enqueue_style( 'jetpack-jitm-css' );
196
197
		wp_enqueue_script(
198
			'jetpack-jitm-new',
199
			$asset_manager->get_file_url_for_environment( '_inc/build/jetpack-jitm.min.js', '_inc/jetpack-jitm.js' ),
200
			array( 'jquery' ),
201
			self::PACKAGE_VERSION, // TODO: Keep in sync with version specified in composer.json
202
			true
203
		);
204
		wp_localize_script(
205
			'jetpack-jitm-new',
206
			'jitm_config',
207
			array(
208
				'api_root'               => esc_url_raw( rest_url() ),
209
				'activate_module_text'   => esc_html__( 'Activate', 'jetpack' ),
210
				'activated_module_text'  => esc_html__( 'Activated', 'jetpack' ),
211
				'activating_module_text' => esc_html__( 'Activating', 'jetpack' ),
212
			)
213
		);
214
	}
215
216
	/**
217
	 * Dismisses a JITM feature class so that it will no longer be shown
218
	 *
219
	 * @param $id string The id of the JITM that was dismissed
220
	 * @param $feature_class string The feature class of the JITM that was dismissed
221
	 *
222
	 * @return bool Always true
223
	 */
224
	function dismiss( $id, $feature_class ) {
225
		$this->tracking->record_user_event(
226
			'jitm_dismiss_client',
227
			array(
228
				'jitm_id'       => $id,
229
				'feature_class' => $feature_class,
230
			)
231
		);
232
233
		$hide_jitm = \Jetpack_Options::get_option( 'hide_jitm' );
234
		if ( ! is_array( $hide_jitm ) ) {
235
			$hide_jitm = array();
236
		}
237
238
		if ( isset( $hide_jitm[ $feature_class ] ) ) {
239
			if ( ! is_array( $hide_jitm[ $feature_class ] ) ) {
240
				$hide_jitm[ $feature_class ] = array(
241
					'last_dismissal' => 0,
242
					'number'         => 0,
243
				);
244
			}
245
		} else {
246
			$hide_jitm[ $feature_class ] = array(
247
				'last_dismissal' => 0,
248
				'number'         => 0,
249
			);
250
		}
251
252
		$number = $hide_jitm[ $feature_class ]['number'];
253
254
		$hide_jitm[ $feature_class ] = array(
255
			'last_dismissal' => time(),
256
			'number'         => $number + 1,
257
		);
258
259
		\Jetpack_Options::update_option( 'hide_jitm', $hide_jitm );
260
261
		return true;
262
	}
263
264
	/**
265
	 * Asks the wpcom API for the current message to display keyed on query string and message path
266
	 *
267
	 * @param $message_path string The message path to ask for
268
	 * @param $query string The query string originally from the front end
269
	 *
270
	 * @return array The JITM's to show, or an empty array if there is nothing to show
271
	 */
272
	function get_messages( $message_path, $query ) {
273
		// custom filters go here
274
		add_filter( 'jitm_woocommerce_services_msg', array( 'Jetpack_JITM', 'jitm_woocommerce_services_msg' ) );
275
		add_filter( 'jitm_jetpack_woo_services_install', array( 'Jetpack_JITM', 'jitm_jetpack_woo_services_install' ) );
276
		add_filter(
277
			'jitm_jetpack_woo_services_activate',
278
			array(
279
				'Jetpack_JITM',
280
				'jitm_jetpack_woo_services_activate',
281
			)
282
		);
283
284
		$user = wp_get_current_user();
285
286
		// unauthenticated or invalid requests just bail
287
		if ( ! $user ) {
288
			return array();
289
		}
290
291
		$site_id = \Jetpack_Options::get_option( 'id' );
292
293
		// build our jitm request
294
		$path = add_query_arg(
295
			array(
296
				'external_user_id' => urlencode_deep( $user->ID ),
297
				'query_string'     => urlencode_deep( $query ),
298
				'mobile_browser'   => jetpack_is_mobile( 'smart' ) ? 1 : 0,
299
				'_locale'          => get_user_locale(),
300
			),
301
			sprintf( '/sites/%d/jitm/%s', $site_id, $message_path )
302
		);
303
304
		// attempt to get from cache
305
		$envelopes = get_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ) );
306
307
		// if something is in the cache and it was put in the cache after the last sync we care about, use it
308
		$use_cache = false;
309
310
		/** This filter is documented in class.jetpack.php */
311
		if ( apply_filters( 'jetpack_just_in_time_msg_cache', false ) ) {
312
			$use_cache = true;
313
		}
314
315
		if ( $use_cache ) {
316
			$last_sync  = (int) get_transient( 'jetpack_last_plugin_sync' );
317
			$from_cache = $envelopes && $last_sync > 0 && $last_sync < $envelopes['last_response_time'];
318
		} else {
319
			$from_cache = false;
320
		}
321
322
		// otherwise, ask again
323
		if ( ! $from_cache ) {
324
			$wpcom_response = Client::wpcom_json_api_request_as_blog(
325
				$path,
326
				'2',
327
				array(
328
					'user_id'    => $user->ID,
329
					'user_roles' => implode( ',', $user->roles ),
330
				),
331
				null,
332
				'wpcom'
333
			);
334
335
			// silently fail...might be helpful to track it?
336
			if ( is_wp_error( $wpcom_response ) ) {
337
				return array();
338
			}
339
340
			$envelopes = json_decode( $wpcom_response['body'] );
341
342
			if ( ! is_array( $envelopes ) ) {
343
				return array();
344
			}
345
346
			$expiration = isset( $envelopes[0] ) ? $envelopes[0]->ttl : 300;
347
348
			// do not cache if expiration is 0 or we're not using the cache
349
			if ( 0 != $expiration && $use_cache ) {
350
				$envelopes['last_response_time'] = time();
351
352
				set_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ), $envelopes, $expiration );
353
			}
354
		}
355
356
		$hidden_jitms = \Jetpack_Options::get_option( 'hide_jitm' );
357
		unset( $envelopes['last_response_time'] );
358
359
		/**
360
		 * Allow adding your own custom JITMs after a set of JITMs has been received.
361
		 *
362
		 * @since 6.9.0
363
		 *
364
		 * @param array $envelopes array of existing JITMs.
365
		 */
366
		$envelopes = apply_filters( 'jetpack_jitm_received_envelopes', $envelopes );
367
368
		foreach ( $envelopes as $idx => &$envelope ) {
369
370
			$dismissed_feature = isset( $hidden_jitms[ $envelope->feature_class ] ) && is_array( $hidden_jitms[ $envelope->feature_class ] ) ? $hidden_jitms[ $envelope->feature_class ] : null;
371
372
			// if the this feature class has been dismissed and the request has not passed the ttl, skip it as it's been dismissed
373
			if ( is_array( $dismissed_feature ) && ( time() - $dismissed_feature['last_dismissal'] < $envelope->expires || $dismissed_feature['number'] >= $envelope->max_dismissal ) ) {
374
				unset( $envelopes[ $idx ] );
375
				continue;
376
			}
377
378
			$this->tracking->record_user_event(
379
				'jitm_view_client',
380
				array(
381
					'jitm_id' => $envelope->id,
382
				)
383
			);
384
385
			$normalized_site_url = \Jetpack::build_raw_urls( get_home_url() );
386
387
			$url_params = array(
388
				'source' => "jitm-$envelope->id",
389
				'site'   => $normalized_site_url,
390
				'u'      => $user->ID,
391
			);
392
393
			if ( ! class_exists( 'Jetpack_Affiliate' ) ) {
394
				require_once JETPACK__PLUGIN_DIR . 'class.jetpack-affiliate.php';
395
			}
396
			// Get affiliate code and add it to the array of URL parameters
397
			if ( '' !== ( $aff = \Jetpack_Affiliate::init()->get_affiliate_code() ) ) {
398
				$url_params['aff'] = $aff;
399
			}
400
401
			$envelope->url = add_query_arg( $url_params, 'https://jetpack.com/redirect/' );
402
403
			$envelope->jitm_stats_url = \Jetpack::build_stats_url( array( 'x_jetpack-jitm' => $envelope->id ) );
404
405
			if ( $envelope->CTA->hook ) {
406
				$envelope->url = apply_filters( 'jitm_' . $envelope->CTA->hook, $envelope->url );
407
				unset( $envelope->CTA->hook );
408
			}
409
410
			if ( isset( $envelope->content->hook ) ) {
411
				$envelope->content = apply_filters( 'jitm_' . $envelope->content->hook, $envelope->content );
412
				unset( $envelope->content->hook );
413
			}
414
415
			// no point in showing an empty message
416
			if ( empty( $envelope->content->message ) ) {
417
				unset( $envelopes[ $idx ] );
418
				continue;
419
			}
420
421
			switch ( $envelope->content->icon ) {
422
				case 'jetpack':
423
					$jetpack_logo            = new Jetpack_Logo();
424
					$envelope->content->icon = '<div class="jp-emblem">' . $jetpack_logo->get_jp_emblem() . '</div>';
425
					break;
426
				case 'woocommerce':
427
					$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">
428
					.st0{clip-path:url(#SVGID_2_);enable-background:new    ;}
429
					.st1{clip-path:url(#SVGID_4_);}
430
					.st2{clip-path:url(#SVGID_6_);}
431
					.st3{clip-path:url(#SVGID_8_);fill:#8F567F;}
432
					.st4{clip-path:url(#SVGID_10_);fill:#FFFFFE;}
433
					.st5{clip-path:url(#SVGID_12_);fill:#FFFFFE;}
434
					.st6{clip-path:url(#SVGID_14_);fill:#FFFFFE;}
435
				</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>';
436
					break;
437
				default:
438
					$envelope->content->icon = '';
439
					break;
440
			}
441
442
			$jetpack = \Jetpack::init();
443
			$jetpack->stat( 'jitm', $envelope->id . '-viewed-' . JETPACK__VERSION );
444
			$jetpack->do_stats( 'server_side' );
445
		}
446
447
		return $envelopes;
448
	}
449
}
450