PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 11.7.1
Jetpack – WP Security, Backup, Speed, & Growth v11.7.1
16.2-beta 12.0.3 12.1.3 12.2.3 12.3.2 12.4.2 12.5.2 12.6.4 12.7.3 12.8.3 12.9.5 13.0.2 13.1.5 13.2.4 13.3.3 13.4.5 13.5.2 13.6.2 13.7.2 13.8.3 13.9.2 14.0.1 14.1.1 14.2.2 14.3.1 All 501 releases
jetpack / class.jetpack-network.php

class.jetpack-network.php in Jetpack – WP Security, Backup, Speed, & Growth 11.7.1, at class.jetpack-network.php

738 lines 21.3 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
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