Completed
Push — update/import-sync-detection ( 0bf98c...8808a0 )
by
unknown
25:48 queued 17:49
created

Jetpack_React_Page::add_page_actions()   A

Complexity

Conditions 5
Paths 3

Size

Total Lines 24

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 5
nc 3
nop 1
dl 0
loc 24
rs 9.2248
c 0
b 0
f 0
1
<?php
2
include_once( 'class.jetpack-admin-page.php' );
3
4
// Builds the landing page and its menu
5
class Jetpack_React_Page extends Jetpack_Admin_Page {
6
7
	protected $dont_show_if_not_active = false;
8
9
	protected $is_redirecting = false;
10
11
	function get_page_hook() {
12
		// Add the main admin Jetpack menu
13
		return add_menu_page( 'Jetpack', 'Jetpack', 'jetpack_admin_page', 'jetpack', array( $this, 'render' ), 'div' );
14
	}
15
16
	function add_page_actions( $hook ) {
17
		/** This action is documented in class.jetpack.php */
18
		do_action( 'jetpack_admin_menu', $hook );
19
20
		// Place the Jetpack menu item on top and others in the order they appear
21
		add_filter( 'custom_menu_order',         '__return_true' );
22
		add_filter( 'menu_order',                array( $this, 'jetpack_menu_order' ) );
23
24
		if ( ! isset( $_GET['page'] ) || 'jetpack' !== $_GET['page'] || ! empty( $_GET['configure'] ) ) {
25
			return; // No need to handle the fallback redirection if we are not on the Jetpack page
26
		}
27
28
		// Adding a redirect meta tag if the REST API is disabled
29
		if ( ! $this->is_rest_api_enabled() ) {
30
			$this->is_redirecting = true;
31
			add_action( 'admin_head', array( $this, 'add_fallback_head_meta' ) );
32
		}
33
34
		// Adding a redirect meta tag wrapped in noscript tags for all browsers in case they have JavaScript disabled
35
		add_action( 'admin_head', array( $this, 'add_noscript_head_meta' ) );
36
37
		// Adding a redirect tag wrapped in browser conditional comments
38
		add_action( 'admin_head', array( $this, 'add_legacy_browsers_head_script' ) );
39
	}
40
41
	/**
42
	 * Add Jetpack Dashboard sub-link and point it to AAG if the user can view stats, manage modules or if Protect is active.
43
	 *
44
	 * Works in Dev Mode or when user is connected.
45
	 *
46
	 * @since 4.3.0
47
	 */
48
	function jetpack_add_dashboard_sub_nav_item() {
49 View Code Duplication
		if ( Jetpack::is_development_mode() || Jetpack::is_active() ) {
50
			global $submenu;
51
			if ( current_user_can( 'jetpack_admin_page' ) ) {
52
				$submenu['jetpack'][] = array( __( 'Dashboard', 'jetpack' ), 'jetpack_admin_page', 'admin.php?page=jetpack#/dashboard' );
53
			}
54
		}
55
	}
56
57
	/**
58
	 * If user is allowed to see the Jetpack Admin, add Settings sub-link.
59
	 *
60
	 * @since 4.3.0
61
	 */
62
	function jetpack_add_settings_sub_nav_item() {
63 View Code Duplication
		if ( ( Jetpack::is_development_mode() || Jetpack::is_active() ) && current_user_can( 'jetpack_admin_page' ) && current_user_can( 'edit_posts' ) ) {
64
			global $submenu;
65
			$submenu['jetpack'][] = array( __( 'Settings', 'jetpack' ), 'jetpack_admin_page', 'admin.php?page=jetpack#/settings' );
66
		}
67
	}
68
69
	function add_fallback_head_meta() {
70
		echo '<meta http-equiv="refresh" content="0; url=?page=jetpack_modules">';
71
	}
72
73
	function add_noscript_head_meta() {
74
		echo '<noscript>';
75
		$this->add_fallback_head_meta();
76
		echo '</noscript>';
77
	}
78
79
	function add_legacy_browsers_head_script() {
80
		echo
81
			"<script type=\"text/javascript\">\n"
82
			. "/*@cc_on\n"
83
			. "if ( @_jscript_version <= 10) {\n"
84
			. "window.location.href = '?page=jetpack_modules';\n"
85
			. "}\n"
86
			. "@*/\n"
87
			. "</script>";
88
	}
89
90 View Code Duplication
	function jetpack_menu_order( $menu_order ) {
91
		$jp_menu_order = array();
92
93
		foreach ( $menu_order as $index => $item ) {
94
			if ( $item != 'jetpack' )
95
				$jp_menu_order[] = $item;
96
97
			if ( $index == 0 )
98
				$jp_menu_order[] = 'jetpack';
99
		}
100
101
		return $jp_menu_order;
102
	}
103
104
	// Render the configuration page for the module if it exists and an error
105
	// screen if the module is not configurable
106
	// @todo remove when real settings are in place
107
	function render_nojs_configurable( $module_name ) {
108
		$module_name = preg_replace( '/[^\da-z\-]+/', '', $_GET['configure'] );
109
110
		echo '<div class="wrap configure-module">';
111
112
		if ( Jetpack::is_module( $module_name ) && current_user_can( 'jetpack_configure_modules' ) ) {
113
			Jetpack::admin_screen_configure_module( $module_name );
114
		} else {
115
			echo '<h2>' . esc_html__( 'Error, bad module.', 'jetpack' ) . '</h2>';
116
		}
117
118
		echo '</div><!-- /wrap -->';
119
	}
120
121
	function page_render() {
122
		// Handle redirects to configuration pages
123
		if ( ! empty( $_GET['configure'] ) ) {
124
			return $this->render_nojs_configurable( $_GET['configure'] );
125
		}
126
127
		/** This action is already documented in views/admin/admin-page.php */
128
		do_action( 'jetpack_notices' );
129
130
		// Try fetching by patch
131
		$static_html = @file_get_contents( JETPACK__PLUGIN_DIR . '_inc/build/static.html' );
132
133
		if ( false === $static_html ) {
134
135
			// If we still have nothing, display an error
136
			echo '<p>';
137
			esc_html_e( 'Error fetching static.html. Try running: ', 'jetpack' );
138
			echo '<code>yarn distclean && yarn build</code>';
139
			echo '</p>';
140
		} else {
141
142
			// We got the static.html so let's display it
143
			echo $static_html;
144
		}
145
	}
146
147
	/**
148
	 * Gets array of any Jetpack notices that have been dismissed.
149
	 *
150
	 * @since 4.0.1
151
	 * @return mixed|void
152
	 */
153
	function get_dismissed_jetpack_notices() {
154
		$jetpack_dismissed_notices = get_option( 'jetpack_dismissed_notices', array() );
155
		/**
156
		 * Array of notices that have been dismissed.
157
		 *
158
		 * @since 4.0.1
159
		 *
160
		 * @param array $jetpack_dismissed_notices If empty, will not show any Jetpack notices.
161
		 */
162
		$dismissed_notices = apply_filters( 'jetpack_dismissed_notices', $jetpack_dismissed_notices );
163
		return $dismissed_notices;
164
	}
165
166
	function additional_styles() {
167
		Jetpack_Admin_Page::load_wrapper_styles();
168
	}
169
170
	function page_admin_scripts() {
171
		if ( $this->is_redirecting || isset( $_GET['configure'] ) ) {
172
			return; // No need for scripts on a fallback page.
173
		}
174
175
		wp_enqueue_script(
176
			'react-plugin',
177
			plugins_url( '_inc/build/admin.js', JETPACK__PLUGIN_FILE ),
178
			array( 'wp-i18n' ),
179
			JETPACK__VERSION,
180
			true
181
		);
182
183
		wp_set_script_translations( 'react-plugin', 'jetpack', JETPACK__PLUGIN_DIR . 'languages/json' );
184
185
		if ( ! Jetpack::is_development_mode() && Jetpack::is_active() ) {
186
			// Required for Analytics.
187
			wp_enqueue_script( 'jp-tracks', '//stats.wp.com/w.js', array(), gmdate( 'YW' ), true );
188
		}
189
190
		// Add objects to be passed to the initial state of the app.
191
		wp_localize_script( 'react-plugin', 'Initial_State', $this->get_initial_state() );
192
	}
193
194
	function get_initial_state() {
195
		// Load API endpoint base classes and endpoints for getting the module list fed into the JS Admin Page
196
		require_once JETPACK__PLUGIN_DIR . '_inc/lib/core-api/class.jetpack-core-api-xmlrpc-consumer-endpoint.php';
197
		require_once JETPACK__PLUGIN_DIR . '_inc/lib/core-api/class.jetpack-core-api-module-endpoints.php';
198
		$moduleListEndpoint = new Jetpack_Core_API_Module_List_Endpoint();
199
		$modules = $moduleListEndpoint->get_modules();
200
201
		// Preparing translated fields for JSON encoding by transforming all HTML entities to
202
		// respective characters.
203
		foreach( $modules as $slug => $data ) {
0 ignored issues
show
Bug introduced by
The expression $modules of type string|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
204
			$modules[ $slug ]['name'] = html_entity_decode( $data['name'] );
205
			$modules[ $slug ]['description'] = html_entity_decode( $data['description'] );
206
			$modules[ $slug ]['short_description'] = html_entity_decode( $data['short_description'] );
207
			$modules[ $slug ]['long_description'] = html_entity_decode( $data['long_description'] );
208
		}
209
210
		// Collecting roles that can view site stats.
211
		$stats_roles = array();
212
		$enabled_roles = function_exists( 'stats_get_option' ) ? stats_get_option( 'roles' ) : array( 'administrator' );
213
214
		if ( ! function_exists( 'get_editable_roles' ) ) {
215
			require_once ABSPATH . 'wp-admin/includes/user.php';
216
		}
217
		foreach ( get_editable_roles() as $slug => $role ) {
218
			$stats_roles[ $slug ] = array(
219
				'name' => translate_user_role( $role['name'] ),
220
				'canView' => is_array( $enabled_roles ) ? in_array( $slug, $enabled_roles, true ) : false,
221
			);
222
		}
223
224
		// Get information about current theme.
225
		$current_theme = wp_get_theme();
226
227
		// Get all themes that Infinite Scroll provides support for natively.
228
		$inf_scr_support_themes = array();
229
		foreach ( Jetpack::glob_php( JETPACK__PLUGIN_DIR . 'modules/infinite-scroll/themes' ) as $path ) {
230
			if ( is_readable( $path ) ) {
231
				$inf_scr_support_themes[] = basename( $path, '.php' );
232
			}
233
		}
234
235
		// Get last post, to build the link to Customizer in the Related Posts module.
236
		$last_post = get_posts( array( 'posts_per_page' => 1 ) );
237
		$last_post = isset( $last_post[0] ) && $last_post[0] instanceof WP_Post
0 ignored issues
show
Bug introduced by
The class WP_Post does not exist. Did you forget a USE statement, or did you not list all dependencies?

This error could be the result of:

1. Missing dependencies

PHP Analyzer uses your composer.json file (if available) to determine the dependencies of your project and to determine all the available classes and functions. It expects the composer.json to be in the root folder of your repository.

Are you sure this class is defined by one of your dependencies, or did you maybe not list a dependency in either the require or require-dev section?

2. Missing use statement

PHP does not complain about undefined classes in ìnstanceof checks. For example, the following PHP code will work perfectly fine:

if ($x instanceof DoesNotExist) {
    // Do something.
}

If you have not tested against this specific condition, such errors might go unnoticed.

Loading history...
238
			? get_permalink( $last_post[0]->ID )
239
			: get_home_url();
240
241
		// Ensure that class to get the affiliate code is loaded
242
		if ( ! class_exists( 'Jetpack_Affiliate' ) ) {
243
			require_once JETPACK__PLUGIN_DIR . 'class.jetpack-affiliate.php';
244
		}
245
246
		return array(
247
			'WP_API_root' => esc_url_raw( rest_url() ),
248
			'WP_API_nonce' => wp_create_nonce( 'wp_rest' ),
249
			'pluginBaseUrl' => plugins_url( '', JETPACK__PLUGIN_FILE ),
250
			'connectionStatus' => array(
251
				'isActive'  => Jetpack::is_active(),
252
				'isStaging' => Jetpack::is_staging_site(),
253
				'devMode'   => array(
254
					'isActive' => Jetpack::is_development_mode(),
255
					'constant' => defined( 'JETPACK_DEV_DEBUG' ) && JETPACK_DEV_DEBUG,
256
					'url'      => site_url() && false === strpos( site_url(), '.' ),
257
					'filter'   => apply_filters( 'jetpack_development_mode', false ),
258
				),
259
				'isPublic'	=> '1' == get_option( 'blog_public' ),
260
				'isInIdentityCrisis' => Jetpack::validate_sync_error_idc_option(),
261
				'sandboxDomain' => JETPACK__SANDBOX_DOMAIN,
262
			),
263
			'connectUrl' => Jetpack::init()->build_connect_url( true, false, false ),
264
			'dismissedNotices' => $this->get_dismissed_jetpack_notices(),
265
			'isDevVersion' => Jetpack::is_development_version(),
266
			'currentVersion' => JETPACK__VERSION,
267
			'is_gutenberg_available' => true,
268
			'getModules' => $modules,
269
			'showJumpstart' => jetpack_show_jumpstart(),
270
			'rawUrl' => Jetpack::build_raw_urls( get_home_url() ),
271
			'adminUrl' => esc_url( admin_url() ),
272
			'stats' => array(
273
				// data is populated asynchronously on page load
274
				'data'  => array(
275
					'general' => false,
276
					'day'     => false,
277
					'week'    => false,
278
					'month'   => false,
279
				),
280
				'roles' => $stats_roles,
281
			),
282
			'aff' => Jetpack_Affiliate::init()->get_affiliate_code(),
283
			'settings' => $this->get_flattened_settings( $modules ),
0 ignored issues
show
Bug introduced by
It seems like $modules defined by $moduleListEndpoint->get_modules() on line 199 can also be of type string; however, Jetpack_React_Page::get_flattened_settings() does only seem to accept array, maybe add an additional type check?

If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check:

/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}

If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue.

Loading history...
284
			'userData' => array(
285
//				'othersLinked' => Jetpack::get_other_linked_admins(),
286
				'currentUser'  => jetpack_current_user_data(),
287
			),
288
			'siteData' => array(
289
				'icon' => has_site_icon()
290
					? apply_filters( 'jetpack_photon_url', get_site_icon_url(), array( 'w' => 64 ) )
291
					: '',
292
				'siteVisibleToSearchEngines' => '1' == get_option( 'blog_public' ),
293
				/**
294
				 * Whether promotions are visible or not.
295
				 *
296
				 * @since 4.8.0
297
				 *
298
				 * @param bool $are_promotions_active Status of promotions visibility. True by default.
299
				 */
300
				'showPromotions' => apply_filters( 'jetpack_show_promotions', true ),
301
				'isAtomicSite' => jetpack_is_atomic_site(),
302
				'plan' => Jetpack_Plan::get(),
303
				'showBackups' => Jetpack::show_backups_ui(),
304
			),
305
			'themeData' => array(
306
				'name'      => $current_theme->get( 'Name' ),
307
				'hasUpdate' => (bool) get_theme_update_available( $current_theme ),
308
				'support'   => array(
309
					'infinite-scroll' => current_theme_supports( 'infinite-scroll' ) || in_array( $current_theme->get_stylesheet(), $inf_scr_support_themes ),
310
				),
311
			),
312
			'locale' => Jetpack::get_i18n_data_json(),
313
			'localeSlug' => join( '-', explode( '_', get_user_locale() ) ),
314
			'jetpackStateNotices' => array(
315
				'messageCode' => Jetpack::state( 'message' ),
316
				'errorCode' => Jetpack::state( 'error' ),
317
				'errorDescription' => Jetpack::state( 'error_description' ),
318
			),
319
			'tracksUserData' => Jetpack_Tracks_Client::get_connected_user_tracks_identity(),
320
			'currentIp' => function_exists( 'jetpack_protect_get_ip' ) ? jetpack_protect_get_ip() : false,
321
			'lastPostUrl' => esc_url( $last_post ),
322
			'externalServicesConnectUrls' => $this->get_external_services_connect_urls()
323
		);
324
	}
325
326
	function get_external_services_connect_urls() {
327
		$connect_urls = array();
328
		jetpack_require_lib( 'class.jetpack-keyring-service-helper' );
329
		foreach ( Jetpack_Keyring_Service_Helper::$SERVICES as $service_name => $service_info ) {
330
			$connect_urls[ $service_name ] = Jetpack_Keyring_Service_Helper::connect_url( $service_name, $service_info[ 'for' ] );
331
		}
332
		return $connect_urls;
333
	}
334
335
	/**
336
	 * Returns an array of modules and settings both as first class members of the object.
337
	 *
338
	 * @param array $modules the result of an API request to get all modules.
339
	 *
340
	 * @return array flattened settings with modules.
341
	 */
342
	function get_flattened_settings( $modules ) {
343
		$core_api_endpoint = new Jetpack_Core_API_Data();
344
		$settings = $core_api_endpoint->get_all_options();
345
		return $settings->data;
346
	}
347
}
348
349
/*
350
 * Only show Jump Start on first activation.
351
 * Any option 'jumpstart' other than 'new connection' will hide it.
352
 *
353
 * The option can be of 4 things, and will be stored as such:
354
 * new_connection      : Brand new connection - Show
355
 * jumpstart_activated : Jump Start has been activated - dismiss
356
 * jetpack_action_taken: Manual activation of a module already happened - dismiss
357
 * jumpstart_dismissed : Manual dismissal of Jump Start - dismiss
358
 *
359
 * @todo move to functions.global.php when available
360
 * @since 3.6
361
 * @return bool | show or hide
362
 */
363
function jetpack_show_jumpstart() {
364
	if ( ! Jetpack::is_active() ) {
365
		return false;
366
	}
367
	$jumpstart_option = Jetpack_Options::get_option( 'jumpstart' );
368
369
	$hide_options = array(
370
		'jumpstart_activated',
371
		'jetpack_action_taken',
372
		'jumpstart_dismissed'
373
	);
374
375
	if ( ! $jumpstart_option || in_array( $jumpstart_option, $hide_options ) ) {
376
		return false;
377
	}
378
379
	return true;
380
}
381
382
/**
383
 * Gather data about the current user.
384
 *
385
 * @since 4.1.0
386
 *
387
 * @return array
388
 */
389
function jetpack_current_user_data() {
390
	$current_user = wp_get_current_user();
391
	$is_master_user = $current_user->ID == Jetpack_Options::get_option( 'master_user' );
392
	$dotcom_data    = Jetpack::get_connected_user_data();
393
	// Add connected user gravatar to the returned dotcom_data.
394
	$dotcom_data['avatar'] = get_avatar_url( $dotcom_data['email'], array( 'size' => 64, 'default' => 'mysteryman' ) );
395
396
	$current_user_data = array(
397
		'isConnected' => Jetpack::is_user_connected( $current_user->ID ),
398
		'isMaster'    => $is_master_user,
399
		'username'    => $current_user->user_login,
400
		'id'          => $current_user->ID,
401
		'wpcomUser'   => $dotcom_data,
402
		'gravatar'    => get_avatar( $current_user->ID, 40, 'mm', '', array( 'force_display' => true ) ),
403
		'permissions' => array(
404
			'admin_page'         => current_user_can( 'jetpack_admin_page' ),
405
			'connect'            => current_user_can( 'jetpack_connect' ),
406
			'disconnect'         => current_user_can( 'jetpack_disconnect' ),
407
			'manage_modules'     => current_user_can( 'jetpack_manage_modules' ),
408
			'network_admin'      => current_user_can( 'jetpack_network_admin_page' ),
409
			'network_sites_page' => current_user_can( 'jetpack_network_sites_page' ),
410
			'edit_posts'         => current_user_can( 'edit_posts' ),
411
			'publish_posts'      => current_user_can( 'publish_posts' ),
412
			'manage_options'     => current_user_can( 'manage_options' ),
413
			'view_stats'		 => current_user_can( 'view_stats' ),
414
			'manage_plugins'	 => current_user_can( 'install_plugins' )
415
									&& current_user_can( 'activate_plugins' )
416
									&& current_user_can( 'update_plugins' )
417
									&& current_user_can( 'delete_plugins' ),
418
		),
419
	);
420
421
	return $current_user_data;
422
}
423