class.jetpack-network.php — Jetpack – WP Security, Backup, Speed, & Growth 11.1.1

jetpack / class.jetpack-network.php

jetpack Last commit date

class.jetpack-network.php

738 lines

1	<?php //phpcs:ignore WordPress.Files.FileName.InvalidClassFilename
2	/**
3	* Jetpack Network Manager class file.
4	*
5	* @package automattic/jetpack
6	*/
7
8	use Automattic\Jetpack\Connection\Manager;
9	use Automattic\Jetpack\Connection\Tokens;
10	use Automattic\Jetpack\Status;
11
12	/**
13	* Used to manage Jetpack installation on Multisite Network installs
14	*
15	* SINGLETON: To use call Jetpack_Network::init()
16	*
17	* DO NOT USE ANY STATIC METHODS IN THIS CLASS!!!!!!
18	*
19	* @since 2.9
20	*/
21	class Jetpack_Network {
22
23	/**
24	* Holds a static copy of Jetpack_Network for the singleton
25	*
26	* @since 2.9
27	* @var Jetpack_Network
28	*/
29	private static $instance = null;
30
31	/**
32	* An instance of the connection manager object.
33	*
34	* @since 7.7
35	* @var Automattic\Jetpack\Connection\Manager
36	*/
37	private $connection;
38
39	/**
40	* Name of the network wide settings
41	*
42	* @since 2.9
43	* @var string
44	*/
45	private $settings_name = 'jetpack-network-settings';
46
47	/**
48	* Defaults for settings found on the Jetpack > Settings page
49	*
50	* @since 2.9
51	* @var array
52	*/
53	private $setting_defaults = array(
54	'auto-connect' => 0,
55	'sub-site-connection-override' => 1,
56	);
57
58	/**
59	* Constructor
60	*
61	* @since 2.9
62	*/
63	private function __construct() {
64	require_once ABSPATH . '/wp-admin/includes/plugin.php'; // For the is_plugin... check.
65	require_once JETPACK__PLUGIN_DIR . 'modules/protect/shared-functions.php'; // For managing the global whitelist.
66
67	/**
68	* Sanity check to ensure the install is Multisite and we
69	* are in Network Admin
70	*/
71	if ( is_multisite() && is_network_admin() ) {
72	add_action( 'network_admin_menu', array( $this, 'add_network_admin_menu' ) );
73	add_action( 'network_admin_edit_jetpack-network-settings', array( $this, 'save_network_settings_page' ), 10, 0 );
74	add_filter( 'admin_body_class', array( $this, 'body_class' ) );
75
76	if ( isset( $_GET['page'] ) && 'jetpack' === $_GET['page'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- This is view logic.
77	add_action( 'admin_init', array( $this, 'jetpack_sites_list' ) );
78	}
79	}
80
81	/*
82	* Things that should only run on multisite
83	*/
84	if ( is_multisite() && is_plugin_active_for_network( 'jetpack/jetpack.php' ) ) {
85	add_action( 'wp_before_admin_bar_render', array( $this, 'add_to_menubar' ) );
86	add_filter( 'jetpack_disconnect_cap', array( $this, 'set_multisite_disconnect_cap' ) );
87
88	/*
89	* If admin wants to automagically register new sites set the hook here
90	*
91	* This is a hacky way because xmlrpc is not available on wp_initialize_site
92	*/
93	if ( 1 === $this->get_option( 'auto-connect' ) ) {
94	add_action( 'wp_initialize_site', array( $this, 'do_automatically_add_new_site' ) );
95	}
96	}
97	}
98
99	/**
100	* Sets a connection object.
101	*
102	* @param Automattic\Jetpack\Connection\Manager $connection the connection manager object.
103	*/
104	public function set_connection( Manager $connection ) {
105	$this->connection = $connection;
106	}
107
108	/**
109	* Registers new sites upon creation
110	*
111	* @since 2.9
112	* @since 7.4.0 Uses a WP_Site object.
113	* @uses wp_initialize_site
114	*
115	* @param WP_Site $site the WordPress site object.
116	**/
117	public function do_automatically_add_new_site( $site ) {
118	if ( is_a( $site, 'WP_Site' ) ) {
119	$this->do_subsiteregister( $site->id );
120	}
121	}
122
123	/**
124	* Adds .network-admin class to the body tag
125	* Helps distinguish network admin JP styles from regular site JP styles
126	*
127	* @since 2.9
128	*
129	* @param String $classes current assigned body classes.
130	* @return String amended class string.
131	*/
132	public function body_class( $classes ) {
133	return trim( $classes ) . ' network-admin ';
134	}
135
136	/**
137	* Provides access to an instance of Jetpack_Network
138	*
139	* This is how the Jetpack_Network object should always be accessed
140	*
141	* @since 2.9
142	* @return Jetpack_Network
143	*/
144	public static function init() {
145	if ( ! self::$instance \|\| ! is_a( self::$instance, 'Jetpack_Network' ) ) {
146	self::$instance = new Jetpack_Network();
147	}
148
149	return self::$instance;
150	}
151
152	/**
153	* Registers the Multisite admin bar menu item shortcut.
154	* This shortcut helps users quickly and easily navigate to the Jetpack Network Admin
155	* menu from anywhere in their network.
156	*
157	* @since 2.9
158	*/
159	public function register_menubar() {
160	add_action( 'wp_before_admin_bar_render', array( $this, 'add_to_menubar' ) );
161	}
162
163	/**
164	* Runs when Jetpack is deactivated from the network admin plugins menu.
165	* Each individual site will need to have Jetpack::disconnect called on it.
166	* Site that had Jetpack individually enabled will not be disconnected as
167	* on Multisite individually activated plugins are still activated when
168	* a plugin is deactivated network wide.
169	*
170	* @since 2.9
171	**/
172	public function deactivate() {
173	// Only fire if in network admin.
174	if ( ! is_network_admin() ) {
175	return;
176	}
177
178	$sites = get_sites();
179
180	foreach ( $sites as $s ) {
181	switch_to_blog( $s->blog_id );
182	$active_plugins = get_option( 'active_plugins' );
183
184	/*
185	* If this plugin was activated in the subsite individually
186	* we do not want to call disconnect. Plugins activated
187	* individually (before network activation) stay activated
188	* when the network deactivation occurs
189	*/
190	if ( ! in_array( 'jetpack/jetpack.php', $active_plugins, true ) ) {
191	Jetpack::disconnect();
192	Jetpack_Options::delete_option( 'version' );
193	}
194	restore_current_blog();
195	}
196
197	}
198
199	/**
200	* Adds a link to the Jetpack Network Admin page in the network admin menu bar.
201	*
202	* @since 2.9
203	**/
204	public function add_to_menubar() {
205	global $wp_admin_bar;
206	// Don't show for logged out users or single site mode.
207	if ( ! is_user_logged_in() \|\| ! is_multisite() ) {
208	return;
209	}
210
211	$wp_admin_bar->add_node(
212	array(
213	'parent' => 'network-admin',
214	'id' => 'network-admin-jetpack',
215	'title' => 'Jetpack',
216	'href' => $this->get_url( 'network_admin_page' ),
217	)
218	);
219	}
220
221	/**
222	* Returns various URL strings. Factory like
223	*
224	* $args can be a string or an array.
225	* If $args is an array there must be an element called name for the switch statement
226	*
227	* Currently supports:
228	* - subsiteregister: Pass array( 'name' => 'subsiteregister', 'site_id' => SITE_ID )
229	* - network_admin_page: Provides link to /wp-admin/network/JETPACK
230	* - subsitedisconnect: Pass array( 'name' => 'subsitedisconnect', 'site_id' => SITE_ID )
231	*
232	* @since 2.9
233	*
234	* @param Mixed $args URL parameters.
235	*
236	* @return String
237	**/
238	public function get_url( $args ) {
239	$url = null; // Default url value.
240
241	if ( is_string( $args ) ) {
242	$name = $args;
243	} elseif ( is_array( $args ) ) {
244	$name = $args['name'];
245	} else {
246	return $url;
247	}
248
249	switch ( $name ) {
250	case 'subsiteregister':
251	if ( ! isset( $args['site_id'] ) ) {
252	break; // If there is not a site id present we cannot go further.
253	}
254	$url = network_admin_url(
255	'admin.php?page=jetpack&action=subsiteregister&site_id='
256	. $args['site_id']
257	);
258	break;
259
260	case 'network_admin_page':
261	$url = network_admin_url( 'admin.php?page=jetpack' );
262	break;
263
264	case 'subsitedisconnect':
265	if ( ! isset( $args['site_id'] ) ) {
266	break; // If there is not a site id present we cannot go further.
267	}
268	$url = network_admin_url(
269	'admin.php?page=jetpack&action=subsitedisconnect&site_id='
270	. $args['site_id']
271	);
272	break;
273	}
274
275	return $url;
276	}
277
278	/**
279	* Adds the Jetpack menu item to the Network Admin area
280	*
281	* @since 2.9
282	*/
283	public function add_network_admin_menu() {
284	add_menu_page( 'Jetpack', 'Jetpack', 'jetpack_network_admin_page', 'jetpack', array( $this, 'wrap_network_admin_page' ), 'div', 3 );
285	$jetpack_sites_page_hook = add_submenu_page( 'jetpack', __( 'Jetpack Sites', 'jetpack' ), __( 'Sites', 'jetpack' ), 'jetpack_network_sites_page', 'jetpack', array( $this, 'wrap_network_admin_page' ) );
286	$jetpack_settings_page_hook = add_submenu_page( 'jetpack', __( 'Settings', 'jetpack' ), __( 'Settings', 'jetpack' ), 'jetpack_network_settings_page', 'jetpack-settings', array( $this, 'wrap_render_network_admin_settings_page' ) );
287	add_action( "admin_print_styles-$jetpack_sites_page_hook", array( 'Jetpack_Admin_Page', 'load_wrapper_styles' ) );
288	add_action( "admin_print_styles-$jetpack_settings_page_hook", array( 'Jetpack_Admin_Page', 'load_wrapper_styles' ) );
289	/**
290	* As jetpack_register_genericons is by default fired off a hook,
291	* the hook may have already fired by this point.
292	* So, let's just trigger it manually.
293	*/
294	require_once JETPACK__PLUGIN_DIR . '_inc/genericons.php';
295	jetpack_register_genericons();
296
297	if ( ! wp_style_is( 'jetpack-icons', 'registered' ) ) {
298	wp_register_style( 'jetpack-icons', plugins_url( 'css/jetpack-icons.min.css', JETPACK__PLUGIN_FILE ), false, JETPACK__VERSION );
299	}
300
301	add_action( 'admin_enqueue_scripts', array( $this, 'admin_menu_css' ) );
302	}
303
304	/**
305	* Adds JP menu icon
306	*
307	* @since 2.9
308	**/
309	public function admin_menu_css() {
310	wp_enqueue_style( 'jetpack-icons' );
311	}
312
313	/**
314	* Provides functionality for the Jetpack > Sites page.
315	* Does not do the display!
316	*
317	* @since 2.9
318	*/
319	public function jetpack_sites_list() {
320	Jetpack::init();
321
322	if ( isset( $_GET['action'] ) ) {
323	switch ( $_GET['action'] ) {
324	case 'subsiteregister':
325	check_admin_referer( 'jetpack-subsite-register' );
326	Jetpack::log( 'subsiteregister' );
327
328	// If no site_id, stop registration and error.
329	if ( ! isset( $_GET['site_id'] ) \|\| empty( $_GET['site_id'] ) ) {
330	/**
331	* Log error to state cookie for display later.
332	*
333	* @todo Make state messages show on Jetpack NA pages
334	*/
335	Jetpack::state( 'missing_site_id', esc_html__( 'Site ID must be provided to register a sub-site.', 'jetpack' ) );
336	break;
337	}
338
339	// Send data to register endpoint and retrieve shadow blog details.
340	$result = $this->do_subsiteregister();
341	$url = $this->get_url( 'network_admin_page' );
342
343	if ( is_wp_error( $result ) ) {
344	$url = add_query_arg( 'action', 'connection_failed', $url );
345	} else {
346	$url = add_query_arg( 'action', 'connected', $url );
347	}
348
349	wp_safe_redirect( $url );
350	exit;
351
352	case 'subsitedisconnect':
353	check_admin_referer( 'jetpack-subsite-disconnect' );
354	Jetpack::log( 'subsitedisconnect' );
355
356	if ( ! isset( $_GET['site_id'] ) \|\| empty( $_GET['site_id'] ) ) {
357	Jetpack::state( 'missing_site_id', esc_html__( 'Site ID must be provided to disconnect a sub-site.', 'jetpack' ) );
358	break;
359	}
360
361	$this->do_subsitedisconnect();
362	break;
363
364	case 'connected':
365	case 'connection_failed':
366	add_action( 'jetpack_notices', array( $this, 'show_jetpack_notice' ) );
367	break;
368	}
369	}
370	}
371
372	/**
373	* Set the disconnect capability for multisite.
374	*
375	* @param array $caps The capabilities array.
376	*/
377	public function set_multisite_disconnect_cap( $caps ) {
378	// Can individual site admins manage their own connection?
379	if ( ! is_super_admin() && ! $this->get_option( 'sub-site-connection-override' ) ) {
380	/*
381	* We need to update the option name -- it's terribly unclear which
382	* direction the override goes.
383	*
384	* @todo: Update the option name to `sub-sites-can-manage-own-connections`
385	*/
386	return array( 'do_not_allow' );
387	}
388
389	return $caps;
390	}
391
392	/**
393	* Shows the Jetpack plugin notices.
394	*/
395	public function show_jetpack_notice() {
396	if ( isset( $_GET['action'] ) && 'connected' === $_GET['action'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- This is view logic.
397	$notice = __( 'Site successfully connected.', 'jetpack' );
398	$classname = 'updated';
399	} elseif ( isset( $_GET['action'] ) && 'connection_failed' === $_GET['action'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- This is view logic.
400	$notice = __( 'Site connection failed!', 'jetpack' );
401	$classname = 'error';
402	}
403	?>
404	<div id="message" class="<?php echo esc_attr( $classname ); ?> jetpack-message jp-connect" style="display:block !important;">
405	<p><?php echo esc_html( $notice ); ?></p>
406	</div>
407	<?php
408	}
409
410	/**
411	* Disconnect functionality for an individual site
412	*
413	* @since 2.9
414	* @see Jetpack_Network::jetpack_sites_list()
415	*
416	* @param int $site_id the site identifier.
417	*/
418	public function do_subsitedisconnect( $site_id = null ) {
419	if ( ! current_user_can( 'jetpack_disconnect' ) ) {
420	return;
421	}
422	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Caller (i.e. `$this->jetpack_sites_list()`) should check.
423	$site_id = ( $site_id === null ) ? ( isset( $_GET['site_id'] ) ? (int) $_GET['site_id'] : null ) : $site_id;
424	switch_to_blog( $site_id );
425	Jetpack::disconnect();
426	restore_current_blog();
427	}
428
429	/**
430	* Registers a subsite with the Jetpack servers
431	*
432	* @since 2.9
433	* @todo Break apart into easier to manage chunks that can be unit tested
434	* @see Jetpack_Network::jetpack_sites_list();
435	*
436	* @param int $site_id the site identifier.
437	*/
438	public function do_subsiteregister( $site_id = null ) {
439	if ( ! current_user_can( 'jetpack_disconnect' ) ) {
440	return;
441	}
442
443	if ( ( new Status() )->is_offline_mode() ) {
444	return;
445	}
446
447	// Figure out what site we are working on.
448	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Caller (i.e. `$this->jetpack_sites_list()`) should check.
449	$site_id = ( $site_id === null ) ? ( isset( $_GET['site_id'] ) ? (int) $_GET['site_id'] : null ) : $site_id;
450
451	/*
452	* Here we need to switch to the subsite
453	* For the registration process we really only hijack how it
454	* works for an individual site and pass in some extra data here
455	*/
456	switch_to_blog( $site_id );
457
458	add_filter( 'jetpack_register_request_body', array( $this, 'filter_register_request_body' ) );
459	add_action( 'jetpack_site_registered_user_token', array( $this, 'filter_register_user_token' ) );
460
461	// Save the secrets in the subsite so when the wpcom server does a pingback it
462	// will be able to validate the connection.
463	$result = $this->connection->register( 'subsiteregister' );
464
465	if ( is_wp_error( $result ) \|\| ! $result ) {
466	restore_current_blog();
467	return $result;
468	}
469
470	Jetpack::activate_default_modules( false, false, array(), false );
471
472	restore_current_blog();
473	}
474
475	/**
476	* Receives the registration response token.
477	*
478	* @param Object $token the received token.
479	*/
480	public function filter_register_user_token( $token ) {
481	$is_connection_owner = ! $this->connection->has_connected_owner();
482	( new Tokens() )->update_user_token(
483	get_current_user_id(),
484	sprintf( '%s.%d', $token->secret, get_current_user_id() ),
485	$is_connection_owner
486	);
487	}
488
489	/**
490	* Filters the registration request body to include additional properties.
491	*
492	* @param array $properties standard register request body properties.
493	* @return array amended properties.
494	*/
495	public function filter_register_request_body( $properties ) {
496	$blog_details = get_blog_details();
497
498	$network = get_network();
499
500	switch_to_blog( $network->blog_id );
501	// The blog id on WordPress.com of the primary network site.
502	$network_wpcom_blog_id = Jetpack_Options::get_option( 'id' );
503	restore_current_blog();
504
505	/**
506	* Both `state` and `user_id` need to be sent in the request, even though they are the same value.
507	* Connecting via the network admin combines `register()` and `authorize()` methods into one step,
508	* because we assume the main site is already authorized. `state` is used to verify the `register()`
509	* request, while `user_id()` is used to create the token in the `authorize()` request.
510	*/
511	return array_merge(
512	$properties,
513	array(
514	'network_url' => $this->get_url( 'network_admin_page' ),
515	'network_wpcom_blog_id' => $network_wpcom_blog_id,
516	'user_id' => get_current_user_id(),
517
518	/*
519	* Use the subsite's registration date as the site creation date.
520	*
521	* This is in contrast to regular standalone sites, where we use the helper
522	* `Jetpack::get_assumed_site_creation_date()` to assume the site's creation date.
523	*/
524	'site_created' => $blog_details->registered,
525	)
526	);
527	}
528
529	/**
530	* A hook handler for adding admin pages and subpages.
531	*/
532	public function wrap_network_admin_page() {
533	Jetpack_Admin_Page::wrap_ui( array( $this, 'network_admin_page' ) );
534	}
535
536	/**
537	* Handles the displaying of all sites on the network that are
538	* dis/connected to Jetpack
539	*
540	* @since 2.9
541	* @see Jetpack_Network::jetpack_sites_list()
542	*/
543	public function network_admin_page() {
544	global $current_site;
545	$this->network_admin_page_header();
546
547	$jp = Jetpack::init();
548
549	// We should be, but ensure we are on the main blog.
550	switch_to_blog( $current_site->blog_id );
551	$main_active = $jp->is_connection_ready();
552	restore_current_blog();
553
554	// If we are in dev mode, just show the notice and bail.
555	if ( ( new Status() )->is_offline_mode() ) {
556	Jetpack::show_development_mode_notice();
557	return;
558	}
559
560	/*
561	* Ensure the main blog is connected as all other subsite blog
562	* connections will feed off this one
563	*/
564	if ( ! $main_active ) {
565	$data = array( 'url' => $jp->build_connect_url() );
566	Jetpack::init()->load_view( 'admin/must-connect-main-blog.php', $data );
567
568	return;
569	}
570
571	require_once __DIR__ . '/class.jetpack-network-sites-list-table.php';
572
573	$network_sites_table = new Jetpack_Network_Sites_List_Table();
574	echo '<div class="wrap"><h2>' . esc_html__( 'Sites', 'jetpack' ) . '</h2>';
575	echo '<form method="post">';
576	$network_sites_table->prepare_items();
577	$network_sites_table->display();
578	echo '</form></div>';
579
580	}
581
582	/**
583	* Stylized JP header formatting
584	*
585	* @since 2.9
586	*/
587	public function network_admin_page_header() {
588	$is_connected = Jetpack::is_connection_ready();
589
590	$data = array(
591	'is_connected' => $is_connected,
592	);
593	Jetpack::init()->load_view( 'admin/network-admin-header.php', $data );
594	}
595
596	/**
597	* Fires when the Jetpack > Settings page is saved.
598	*
599	* @since 2.9
600	*/
601	public function save_network_settings_page() {
602
603	if ( ! isset( $_POST['_wpnonce'] ) \|\| ! wp_verify_nonce( $_POST['_wpnonce'], 'jetpack-network-settings' ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
604	// No nonce, push back to settings page.
605	wp_safe_redirect(
606	add_query_arg(
607	array( 'page' => 'jetpack-settings' ),
608	network_admin_url( 'admin.php' )
609	)
610	);
611	exit();
612	}
613
614	// Try to save the Protect whitelist before anything else, since that action can result in errors.
615	$whitelist = isset( $_POST['global-whitelist'] ) ? filter_var( wp_unslash( $_POST['global-whitelist'] ) ) : '';
616	$whitelist = str_replace( ' ', '', $whitelist );
617	$whitelist = explode( PHP_EOL, $whitelist );
618	$result = jetpack_protect_save_whitelist( $whitelist, true );
619	if ( is_wp_error( $result ) ) {
620	wp_safe_redirect(
621	add_query_arg(
622	array(
623	'page' => 'jetpack-settings',
624	'error' => 'jetpack_protect_whitelist',
625	),
626	network_admin_url( 'admin.php' )
627	)
628	);
629	exit();
630	}
631
632	/*
633	* Fields
634	*
635	* auto-connect - Checkbox for global Jetpack connection
636	* sub-site-connection-override - Allow sub-site admins to (dis)reconnect with their own Jetpack account
637	*/
638	$auto_connect = 0;
639	if ( isset( $_POST['auto-connect'] ) ) {
640	$auto_connect = 1;
641	}
642
643	$sub_site_connection_override = 0;
644	if ( isset( $_POST['sub-site-connection-override'] ) ) {
645	$sub_site_connection_override = 1;
646	}
647
648	$data = array(
649	'auto-connect' => $auto_connect,
650	'sub-site-connection-override' => $sub_site_connection_override,
651	);
652
653	update_site_option( $this->settings_name, $data );
654	wp_safe_redirect(
655	add_query_arg(
656	array(
657	'page' => 'jetpack-settings',
658	'updated' => 'true',
659	),
660	network_admin_url( 'admin.php' )
661	)
662	);
663	exit();
664	}
665
666	/**
667	* A hook handler for adding admin pages and subpages.
668	*/
669	public function wrap_render_network_admin_settings_page() {
670	Jetpack_Admin_Page::wrap_ui( array( $this, 'render_network_admin_settings_page' ) );
671	}
672
673	/**
674	* A hook rendering the admin settings page.
675	*/
676	public function render_network_admin_settings_page() {
677	$this->network_admin_page_header();
678	$options = wp_parse_args( get_site_option( $this->settings_name ), $this->setting_defaults );
679
680	$modules = array();
681	$module_slugs = Jetpack::get_available_modules();
682	foreach ( $module_slugs as $slug ) {
683	$module = Jetpack::get_module( $slug );
684	$module['module'] = $slug;
685	$modules[] = $module;
686	}
687
688	usort( $modules, array( 'Jetpack', 'sort_modules' ) );
689
690	if ( ! isset( $options['modules'] ) ) {
691	$options['modules'] = $modules;
692	}
693
694	$data = array(
695	'modules' => $modules,
696	'options' => $options,
697	'jetpack_protect_whitelist' => jetpack_protect_format_whitelist(),
698	);
699
700	Jetpack::init()->load_view( 'admin/network-settings.php', $data );
701	}
702
703	/**
704	* Updates a site wide option
705	*
706	* @since 2.9
707	*
708	* @param string $key option name.
709	* @param mixed $value option value.
710	*
711	* @return boolean
712	**/
713	public function update_option( $key, $value ) {
714	$options = get_site_option( $this->settings_name, $this->setting_defaults );
715	$options[ $key ] = $value;
716
717	return update_site_option( $this->settings_name, $options );
718	}
719
720	/**
721	* Retrieves a site wide option
722	*
723	* @since 2.9
724	*
725	* @param string $name - Name of the option in the database.
726	**/
727	public function get_option( $name ) {
728	$options = get_site_option( $this->settings_name, $this->setting_defaults );
729	$options = wp_parse_args( $options, $this->setting_defaults );
730
731	if ( ! isset( $options[ $name ] ) ) {
732	$options[ $name ] = null;
733	}
734
735	return $options[ $name ];
736	}
737	}
738