These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more
1 | <?php |
||
2 | |||
3 | /** |
||
4 | * Jetpack just in time messaging through out the admin |
||
5 | * |
||
6 | * @since 3.7.0 |
||
7 | */ |
||
8 | class Jetpack_JITM { |
||
9 | |||
10 | /** |
||
11 | * @var Jetpack_JITM |
||
12 | **/ |
||
13 | private static $instance = null; |
||
14 | |||
15 | /** |
||
16 | * Initializes the class, or returns the singleton |
||
17 | * |
||
18 | * @return Jetpack_JITM | false |
||
19 | */ |
||
20 | static function init() { |
||
21 | /** |
||
22 | * Filter to turn off all just in time messages |
||
23 | * |
||
24 | * @since 3.7.0 |
||
25 | * @since 5.4.0 Correct docblock to reflect default arg value |
||
26 | * |
||
27 | * @param bool false Whether to show just in time messages. |
||
28 | */ |
||
29 | if ( ! apply_filters( 'jetpack_just_in_time_msgs', false ) ) { |
||
30 | return false; |
||
31 | } |
||
32 | |||
33 | if ( is_null( self::$instance ) ) { |
||
34 | self::$instance = new Jetpack_JITM; |
||
35 | } |
||
36 | |||
37 | return self::$instance; |
||
38 | } |
||
39 | |||
40 | /** |
||
41 | * Jetpack_JITM constructor. |
||
42 | */ |
||
43 | private function __construct() { |
||
44 | if ( ! Jetpack::is_active() || Jetpack::is_development_mode() ) { |
||
45 | return; |
||
46 | } |
||
47 | add_action( 'current_screen', array( $this, 'prepare_jitms' ) ); |
||
48 | } |
||
49 | |||
50 | /** |
||
51 | * Get's the Jetpack emblem |
||
52 | * |
||
53 | * @return string The Jetpack emblem |
||
54 | */ |
||
55 | function get_emblem() { |
||
56 | return '<div class="jp-emblem">' . Jetpack::get_jp_emblem() . '</div>'; |
||
57 | } |
||
58 | |||
59 | /** |
||
60 | * Prepare actions according to screen and post type. |
||
61 | * |
||
62 | * @since 3.8.2 |
||
63 | * |
||
64 | * @uses Jetpack_Autoupdate::get_possible_failures() |
||
65 | * |
||
66 | * @param object $screen |
||
67 | */ |
||
68 | function prepare_jitms( $screen ) { |
||
69 | if ( ! in_array( $screen->id, array( |
||
70 | 'toplevel_page_jetpack', |
||
71 | 'jetpack_page_stats', |
||
72 | 'jetpack_page_akismet-key-config', |
||
73 | 'admin_page_jetpack_modules' |
||
74 | ) ) ) { |
||
75 | add_action( 'admin_enqueue_scripts', array( $this, 'jitm_enqueue_files' ) ); |
||
76 | add_action( 'admin_notices', array( $this, 'ajax_message' ) ); |
||
77 | add_action( 'edit_form_top', array( $this, 'ajax_message' ) ); |
||
78 | } |
||
79 | } |
||
80 | |||
81 | /** |
||
82 | * A special filter for WooCommerce, to set a message based on local state. |
||
83 | * |
||
84 | * @param $message string The current message |
||
85 | * |
||
86 | * @return array The new message |
||
87 | */ |
||
88 | static function jitm_woocommerce_services_msg( $content ) { |
||
89 | if ( ! function_exists( 'wc_get_base_location' ) ) { |
||
90 | return $content; |
||
91 | } |
||
92 | |||
93 | $base_location = wc_get_base_location(); |
||
94 | |||
95 | switch ( $base_location['country'] ) { |
||
96 | case 'US': |
||
97 | $content->message = esc_html__( 'New free service: Show USPS shipping rates on your store! Added bonus: print shipping labels without leaving WooCommerce.', 'jetpack' ); |
||
98 | break; |
||
99 | case 'CA': |
||
100 | $content->message = esc_html__( 'New free service: Show Canada Post shipping rates on your store!', 'jetpack' ); |
||
101 | break; |
||
102 | default: |
||
103 | $content->message = ''; |
||
104 | } |
||
105 | |||
106 | return $content; |
||
107 | } |
||
108 | |||
109 | /** |
||
110 | * A special filter for WooCommerce Call To Action button |
||
111 | * |
||
112 | * @param $CTA string The existing CTA |
||
113 | * |
||
114 | * @return string The new CTA |
||
115 | */ |
||
116 | static function jitm_jetpack_woo_services_install( $CTA ) { |
||
117 | return wp_nonce_url( add_query_arg( array( |
||
118 | 'wc-services-action' => 'install' |
||
119 | ), admin_url( 'admin.php?page=wc-settings' ) ), 'wc-services-install' ); |
||
120 | } |
||
121 | |||
122 | /** |
||
123 | * A special filter for WooCommerce Call To Action button |
||
124 | * |
||
125 | * @param $CTA string The existing CTA |
||
126 | * |
||
127 | * @return string The new CTA |
||
128 | */ |
||
129 | static function jitm_jetpack_woo_services_activate( $CTA ) { |
||
130 | return wp_nonce_url( add_query_arg( array( |
||
131 | 'wc-services-action' => 'activate' |
||
132 | ), admin_url( 'admin.php?page=wc-settings' ) ), 'wc-services-install' ); |
||
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 | |||
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 | ></div> |
||
148 | <?php |
||
149 | } |
||
150 | |||
151 | /** |
||
152 | * Get's the current message path for display of a JITM |
||
153 | * |
||
154 | * @return string The message path |
||
155 | */ |
||
156 | function get_message_path() { |
||
157 | $screen = get_current_screen(); |
||
158 | |||
159 | return 'wp:' . $screen->id . ':' . current_filter(); |
||
160 | } |
||
161 | |||
162 | /** |
||
163 | * Function to enqueue jitm css and js |
||
164 | */ |
||
165 | function jitm_enqueue_files() { |
||
166 | $min = ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? '' : '.min'; |
||
167 | wp_register_style( |
||
168 | 'jetpack-jitm-css', |
||
169 | plugins_url( "css/jetpack-admin-jitm{$min}.css", JETPACK__PLUGIN_FILE ), |
||
170 | false, |
||
171 | JETPACK__VERSION . |
||
172 | '-201243242' |
||
173 | ); |
||
174 | wp_style_add_data( 'jetpack-jitm-css', 'rtl', 'replace' ); |
||
175 | wp_style_add_data( 'jetpack-jitm-css', 'suffix', $min ); |
||
176 | wp_enqueue_style( 'jetpack-jitm-css' ); |
||
177 | |||
178 | wp_enqueue_script( 'jetpack-jitm-new', plugins_url( '_inc/jetpack-jitm.js', JETPACK__PLUGIN_FILE ), array( 'jquery' ), JETPACK__VERSION, true ); |
||
179 | wp_localize_script( 'jetpack-jitm-new', 'jitm_config', array( |
||
180 | 'api_root' => esc_url_raw( rest_url() ), |
||
181 | ) ); |
||
182 | } |
||
183 | |||
184 | /** |
||
185 | * Dismisses a JITM feature class so that it will no longer be shown |
||
186 | * |
||
187 | * @param $id string The id of the JITM that was dismissed |
||
188 | * @param $feature_class string The feature class of the JITM that was dismissed |
||
189 | * |
||
190 | * @return bool Always true |
||
191 | */ |
||
192 | function dismiss( $id, $feature_class ) { |
||
193 | // todo: track dismissal of id and feature class? |
||
0 ignored issues
–
show
Coding Style
Best Practice
introduced
by
![]() |
|||
194 | $hide_jitm = Jetpack_Options::get_option( 'hide_jitm' ); |
||
195 | if ( ! is_array( $hide_jitm ) ) { |
||
196 | $hide_jitm = array(); |
||
197 | } |
||
198 | |||
199 | if ( isset( $hide_jitm[ $feature_class ] ) ) { |
||
200 | if ( ! is_array( $hide_jitm[ $feature_class ] ) ) { |
||
201 | $hide_jitm[ $feature_class ] = array( 'last_dismissal' => 0, 'number' => 0 ); |
||
202 | } |
||
203 | } else { |
||
204 | $hide_jitm[ $feature_class ] = array( 'last_dismissal' => 0, 'number' => 0 ); |
||
205 | } |
||
206 | |||
207 | $number = $hide_jitm[ $feature_class ]['number']; |
||
208 | |||
209 | $hide_jitm[ $feature_class ] = array( 'last_dismissal' => time(), 'number' => $number + 1 ); |
||
210 | |||
211 | Jetpack_Options::update_option( 'hide_jitm', $hide_jitm ); |
||
212 | |||
213 | return true; |
||
214 | } |
||
215 | |||
216 | /** |
||
217 | * Asks the wpcom API for the current message to display keyed on query string and message path |
||
218 | * |
||
219 | * @param $message_path string The message path to ask for |
||
220 | * @param $query string The query string originally from the front end |
||
221 | * |
||
222 | * @return array The JITM's to show, or an empty array if there is nothing to show |
||
223 | */ |
||
224 | function get_messages( $message_path, $query ) { |
||
225 | // custom filters go here |
||
226 | add_filter( 'jitm_woocommerce_services_msg', array( 'Jetpack_JITM', 'jitm_woocommerce_services_msg' ) ); |
||
227 | add_filter( 'jitm_jetpack_woo_services_install', array( 'Jetpack_JITM', 'jitm_jetpack_woo_services_install' ) ); |
||
228 | add_filter( 'jitm_jetpack_woo_services_activate', array( |
||
229 | 'Jetpack_JITM', |
||
230 | 'jitm_jetpack_woo_services_activate' |
||
231 | ) ); |
||
232 | |||
233 | $user = wp_get_current_user(); |
||
234 | |||
235 | // unauthenticated or invalid requests just bail |
||
236 | if ( ! $user ) { |
||
237 | return array(); |
||
238 | } |
||
239 | |||
240 | require_once( JETPACK__PLUGIN_DIR . 'class.jetpack-client.php' ); |
||
241 | |||
242 | $site_id = Jetpack_Options::get_option( 'id' ); |
||
243 | |||
244 | // build our jitm request |
||
245 | $path = add_query_arg( array( |
||
246 | 'external_user_id' => urlencode_deep( $user->ID ), |
||
247 | 'user_roles' => urlencode_deep( implode( ',', $user->roles ) ), |
||
248 | 'query_string' => urlencode_deep( $query ), |
||
249 | ), sprintf( '/sites/%d/jitm/%s', $site_id, $message_path ) ); |
||
250 | |||
251 | // attempt to get from cache |
||
252 | $envelopes = get_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ) ); |
||
253 | |||
254 | // if something is in the cache and it was put in the cache after the last sync we care about, use it |
||
255 | $use_cache = false; |
||
256 | |||
257 | /** This filter is documented in class.jetpack.php */ |
||
258 | if ( apply_filters( 'jetpack_just_in_time_msg_cache', false ) ) { |
||
259 | $use_cache = true; |
||
260 | } |
||
261 | |||
262 | if ( $use_cache ) { |
||
263 | $last_sync = (int) get_transient( 'jetpack_last_plugin_sync' ); |
||
264 | $from_cache = $envelopes && $last_sync > 0 && $last_sync < $envelopes['last_response_time']; |
||
265 | } else { |
||
266 | $from_cache = false; |
||
267 | } |
||
268 | |||
269 | // otherwise, ask again |
||
270 | if ( ! $from_cache ) { |
||
271 | $wpcom_response = Jetpack_Client::wpcom_json_api_request_as_blog( |
||
272 | $path, |
||
273 | '2', |
||
274 | array( |
||
275 | 'user_id' => $user->ID, |
||
276 | 'user_roles' => implode( ',', $user->roles ), |
||
277 | ), |
||
278 | null, |
||
279 | 'wpcom' |
||
280 | ); |
||
281 | |||
282 | // silently fail...might be helpful to track it? |
||
283 | if ( is_wp_error( $wpcom_response ) ) { |
||
284 | return array(); |
||
285 | } |
||
286 | |||
287 | $envelopes = json_decode( $wpcom_response['body'] ); |
||
288 | |||
289 | if ( ! is_array( $envelopes ) ) { |
||
290 | return array(); |
||
291 | } |
||
292 | |||
293 | $expiration = isset( $envelopes[0] ) ? $envelopes[0]->ttl : 300; |
||
294 | |||
295 | // do not cache if expiration is 0 or we're not using the cache |
||
296 | if ( 0 != $expiration && $use_cache ) { |
||
297 | $envelopes['last_response_time'] = time(); |
||
298 | |||
299 | set_transient( 'jetpack_jitm_' . substr( md5( $path ), 0, 31 ), $envelopes, $expiration ); |
||
300 | } |
||
301 | } |
||
302 | |||
303 | $hidden_jitms = Jetpack_Options::get_option( 'hide_jitm' ); |
||
304 | unset( $envelopes['last_response_time'] ); |
||
305 | |||
306 | foreach ( $envelopes as $idx => &$envelope ) { |
||
307 | |||
308 | $dismissed_feature = isset( $hidden_jitms[ $envelope->feature_class ] ) && is_array( $hidden_jitms[ $envelope->feature_class ] ) ? $hidden_jitms[ $envelope->feature_class ] : null; |
||
309 | |||
310 | // if the this feature class has been dismissed and the request has not expired from the cache, skip it as it's been dismissed |
||
311 | if ( is_array( $dismissed_feature ) && $from_cache && time() - $dismissed_feature['last_dismissal'] < $expiration + 60 ) { |
||
0 ignored issues
–
show
The variable
$expiration does not seem to be defined for all execution paths leading up to this point.
If you define a variable conditionally, it can happen that it is not defined for all execution paths. Let’s take a look at an example: function myFunction($a) {
switch ($a) {
case 'foo':
$x = 1;
break;
case 'bar':
$x = 2;
break;
}
// $x is potentially undefined here.
echo $x;
}
In the above example, the variable $x is defined if you pass “foo” or “bar” as argument for $a. However, since the switch statement has no default case statement, if you pass any other value, the variable $x would be undefined. Available Fixes
![]() |
|||
312 | unset( $envelopes[ $idx ] ); |
||
313 | continue; |
||
314 | } |
||
315 | |||
316 | JetpackTracking::record_user_event( 'jitm_view_client', array( |
||
317 | 'jitm_id' => $envelope->id, |
||
318 | ) ); |
||
319 | |||
320 | $normalized_site_url = Jetpack::build_raw_urls( get_home_url() ); |
||
321 | $envelope->url = 'https://jetpack.com/redirect/?source=jitm-' . $envelope->id . '&site=' . $normalized_site_url . '&u=' . $user->ID; |
||
322 | $envelope->jitm_stats_url = Jetpack::build_stats_url( array( 'x_jetpack-jitm' => $envelope->id ) ); |
||
323 | |||
324 | if ( $envelope->CTA->hook ) { |
||
325 | $envelope->url = apply_filters( 'jitm_' . $envelope->CTA->hook, $envelope->url ); |
||
326 | unset( $envelope->CTA->hook ); |
||
327 | } |
||
328 | |||
329 | if ( isset( $envelope->content->hook ) ) { |
||
330 | $envelope->content = apply_filters( 'jitm_' . $envelope->content->hook, $envelope->content ); |
||
331 | unset( $envelope->content->hook ); |
||
332 | } |
||
333 | |||
334 | // no point in showing an empty message |
||
335 | if ( empty( $envelope->content->message ) ) { |
||
336 | return array(); |
||
337 | } |
||
338 | |||
339 | switch ( $envelope->content->icon ) { |
||
340 | case 'jetpack': |
||
341 | $envelope->content->icon = '<div class="jp-emblem">' . Jetpack::get_jp_emblem() . '</div>'; |
||
342 | break; |
||
343 | case 'woocommerce': |
||
344 | $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"> |
||
345 | .st0{clip-path:url(#SVGID_2_);enable-background:new ;} |
||
346 | .st1{clip-path:url(#SVGID_4_);} |
||
347 | .st2{clip-path:url(#SVGID_6_);} |
||
348 | .st3{clip-path:url(#SVGID_8_);fill:#8F567F;} |
||
349 | .st4{clip-path:url(#SVGID_10_);fill:#FFFFFE;} |
||
350 | .st5{clip-path:url(#SVGID_12_);fill:#FFFFFE;} |
||
351 | .st6{clip-path:url(#SVGID_14_);fill:#FFFFFE;} |
||
352 | </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>'; |
||
353 | break; |
||
354 | default: |
||
355 | $envelope->content->icon = ''; |
||
356 | break; |
||
357 | } |
||
358 | |||
359 | $jetpack = Jetpack::init(); |
||
360 | $jetpack->stat( 'jitm', $envelope->id . '-viewed-' . JETPACK__VERSION ); |
||
361 | $jetpack->do_stats( 'server_side' ); |
||
362 | } |
||
363 | |||
364 | return $envelopes; |
||
365 | } |
||
366 | } |
||
367 | |||
368 | add_action( 'init', array( 'Jetpack_JITM', 'init' ) ); |
||
369 |