| [ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Multisite network settings administration panel. 4 * 5 * @package WordPress 6 * @subpackage Multisite 7 * @since 3.0.0 8 */ 9 10 /** Load WordPress Administration Bootstrap */ 11 require_once __DIR__ . '/admin.php'; 12 13 /** WordPress Translation Installation API */ 14 require_once ABSPATH . 'wp-admin/includes/translation-install.php'; 15 16 if ( ! current_user_can( 'manage_network_options' ) ) { 17 wp_die( __( 'Sorry, you are not allowed to access this page.' ), 403 ); 18 } 19 20 // Used in the HTML title tag. 21 $title = __( 'Network Settings' ); 22 $parent_file = 'settings.php'; 23 24 // Handle network admin email change requests. 25 if ( ! empty( $_GET['network_admin_hash'] ) ) { 26 $new_admin_details = get_site_option( 'network_admin_hash' ); 27 $redirect = 'settings.php?updated=false'; 28 if ( is_array( $new_admin_details ) && hash_equals( $new_admin_details['hash'], $_GET['network_admin_hash'] ) && ! empty( $new_admin_details['newemail'] ) ) { 29 update_site_option( 'admin_email', $new_admin_details['newemail'] ); 30 delete_site_option( 'network_admin_hash' ); 31 delete_site_option( 'new_admin_email' ); 32 $redirect = 'settings.php?updated=true'; 33 } 34 wp_redirect( network_admin_url( $redirect ) ); 35 exit; 36 } elseif ( ! empty( $_GET['dismiss'] ) && 'new_network_admin_email' === $_GET['dismiss'] ) { 37 check_admin_referer( 'dismiss_new_network_admin_email' ); 38 delete_site_option( 'network_admin_hash' ); 39 delete_site_option( 'new_admin_email' ); 40 wp_redirect( network_admin_url( 'settings.php?updated=true' ) ); 41 exit; 42 } 43 44 add_action( 'admin_head', 'network_settings_add_js' ); 45 46 get_current_screen()->add_help_tab( 47 array( 48 'id' => 'overview', 49 'title' => __( 'Overview' ), 50 'content' => 51 '<p>' . __( 'This screen sets and changes options for the network as a whole. The first site is the main site in the network and network options are pulled from that original site’s options.' ) . '</p>' . 52 '<p>' . __( 'Operational settings has fields for the network’s name and admin email.' ) . '</p>' . 53 '<p>' . __( 'Registration settings can disable/enable public signups. If you let others sign up for a site, install spam plugins. Spaces, not commas, should separate names banned as sites for this network.' ) . '</p>' . 54 '<p>' . __( 'New site settings are defaults applied when a new site is created in the network. These include welcome email for when a new site or user account is registered, and what᾿s put in the first post, page, comment, comment author, and comment URL.' ) . '</p>' . 55 '<p>' . __( 'Upload settings control the size of the uploaded files and the amount of available upload space for each site. You can change the default value for specific sites when you edit a particular site. Allowed file types are also listed (space separated only).' ) . '</p>' . 56 '<p>' . __( 'You can set the language, and WordPress will automatically download and install the translation files (available if your filesystem is writable).' ) . '</p>' . 57 '<p>' . __( 'Menu setting enables/disables the plugin menus from appearing for non super admins, so that only super admins, not site admins, have access to activate plugins.' ) . '</p>' . 58 '<p>' . __( 'Super admins can no longer be added on the Options screen. You must now go to the list of existing users on Network Admin > Users and click on Username or the Edit action link below that name. This goes to an Edit User page where you can check a box to grant super admin privileges.' ) . '</p>', 59 ) 60 ); 61 62 get_current_screen()->set_help_sidebar( 63 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' . 64 '<p>' . __( '<a href="https://developer.wordpress.org/advanced-administration/multisite/admin/settings/">Documentation on Network Settings</a>' ) . '</p>' . 65 '<p>' . __( '<a href="https://wordpress.org/support/forums/">Support forums</a>' ) . '</p>' 66 ); 67 68 if ( $_POST ) { 69 /** This action is documented in wp-admin/network/edit.php */ 70 do_action( 'wpmuadminedit' ); 71 72 check_admin_referer( 'siteoptions' ); 73 74 $checked_options = array( 75 'menu_items' => array(), 76 'registrationnotification' => 'no', 77 'upload_space_check_disabled' => 1, 78 'add_new_users' => 0, 79 ); 80 foreach ( $checked_options as $option_name => $option_unchecked_value ) { 81 if ( ! isset( $_POST[ $option_name ] ) ) { 82 $_POST[ $option_name ] = $option_unchecked_value; 83 } 84 } 85 86 $options = array( 87 'registrationnotification', 88 'registration', 89 'add_new_users', 90 'menu_items', 91 'upload_space_check_disabled', 92 'blog_upload_space', 93 'upload_filetypes', 94 'site_name', 95 'first_post', 96 'first_page', 97 'first_comment', 98 'first_comment_url', 99 'first_comment_author', 100 'welcome_email', 101 'welcome_user_email', 102 'fileupload_maxk', 103 'illegal_names', 104 'limited_email_domains', 105 'banned_email_domains', 106 'WPLANG', 107 'new_admin_email', 108 'first_comment_email', 109 ); 110 111 // Handle translation installation. 112 if ( ! empty( $_POST['WPLANG'] ) && current_user_can( 'install_languages' ) && wp_can_install_language_pack() ) { 113 $language = wp_download_language_pack( $_POST['WPLANG'] ); 114 if ( $language ) { 115 $_POST['WPLANG'] = $language; 116 } 117 } 118 119 foreach ( $options as $option_name ) { 120 if ( ! isset( $_POST[ $option_name ] ) ) { 121 continue; 122 } 123 $value = wp_unslash( $_POST[ $option_name ] ); 124 update_site_option( $option_name, $value ); 125 } 126 127 /** 128 * Fires after the network options are updated. 129 * 130 * @since MU (3.0.0) 131 */ 132 do_action( 'update_wpmu_options' ); 133 134 wp_redirect( add_query_arg( 'updated', 'true', network_admin_url( 'settings.php' ) ) ); 135 exit; 136 } 137 138 require_once ABSPATH . 'wp-admin/admin-header.php'; 139 140 if ( isset( $_GET['updated'] ) ) { 141 wp_admin_notice( 142 __( 'Settings saved.' ), 143 array( 144 'type' => 'success', 145 'dismissible' => true, 146 'id' => 'message', 147 ) 148 ); 149 } 150 ?> 151 152 <div class="wrap"> 153 <h1><?php echo esc_html( $title ); ?></h1> 154 <form method="post" action="settings.php" novalidate="novalidate"> 155 <?php wp_nonce_field( 'siteoptions' ); ?> 156 <h2><?php _e( 'Operational Settings' ); ?></h2> 157 <table class="form-table" role="presentation"> 158 <tr> 159 <th scope="row"><label for="site_name"><?php _e( 'Network Title' ); ?></label></th> 160 <td> 161 <input name="site_name" type="text" id="site_name" class="regular-text" value="<?php echo esc_attr( get_network()->site_name ); ?>" /> 162 </td> 163 </tr> 164 165 <tr> 166 <th scope="row"><label for="admin_email"><?php _e( 'Network Admin Email' ); ?></label></th> 167 <td> 168 <input name="new_admin_email" type="email" id="admin_email" aria-describedby="admin-email-desc" class="regular-text" value="<?php echo esc_attr( get_site_option( 'admin_email' ) ); ?>" /> 169 <p class="description" id="admin-email-desc"> 170 <?php _e( 'This address is used for admin purposes. If you change this, an email will be sent to your new address to confirm it. <strong>The new address will not become active until confirmed.</strong>' ); ?> 171 </p> 172 <?php 173 $new_admin_email = get_site_option( 'new_admin_email' ); 174 if ( $new_admin_email && get_site_option( 'admin_email' ) !== $new_admin_email ) : 175 $notice_message = sprintf( 176 /* translators: %s: New network admin email. */ 177 __( 'There is a pending change of the network admin email to %s.' ), 178 '<code>' . esc_html( $new_admin_email ) . '</code>' 179 ); 180 181 $notice_message .= sprintf( 182 ' <a href="%1$s">%2$s</a>', 183 esc_url( wp_nonce_url( network_admin_url( 'settings.php?dismiss=new_network_admin_email' ), 'dismiss_new_network_admin_email' ) ), 184 __( 'Cancel' ) 185 ); 186 187 wp_admin_notice( 188 $notice_message, 189 array( 190 'type' => 'warning', 191 'dismissible' => true, 192 'additional_classes' => array( 'inline' ), 193 ) 194 ); 195 endif; 196 ?> 197 </td> 198 </tr> 199 </table> 200 <h2><?php _e( 'Registration Settings' ); ?></h2> 201 <table class="form-table" role="presentation"> 202 <?php $new_registrations_settings_title = __( 'Allow new registrations' ); ?> 203 <tr> 204 <th scope="row"><?php echo $new_registrations_settings_title; ?></th> 205 <?php 206 if ( ! get_site_option( 'registration' ) ) { 207 update_site_option( 'registration', 'none' ); 208 } 209 $reg = get_site_option( 'registration' ); 210 ?> 211 <td> 212 <fieldset> 213 <legend class="screen-reader-text"><?php echo $new_registrations_settings_title; ?></legend> 214 <label><input name="registration" type="radio" id="registration1" value="none"<?php checked( $reg, 'none' ); ?> /> <?php _e( 'Registration is disabled' ); ?></label><br /> 215 <label><input name="registration" type="radio" id="registration2" value="user"<?php checked( $reg, 'user' ); ?> /> <?php _e( 'User accounts may be registered' ); ?></label><br /> 216 <label><input name="registration" type="radio" id="registration3" value="blog"<?php checked( $reg, 'blog' ); ?> /> <?php _e( 'Logged in users may register new sites' ); ?></label><br /> 217 <label><input name="registration" type="radio" id="registration4" value="all"<?php checked( $reg, 'all' ); ?> /> <?php _e( 'Both sites and user accounts can be registered' ); ?></label> 218 <?php 219 if ( is_subdomain_install() ) { 220 echo '<p class="description">'; 221 printf( 222 /* translators: 1: NOBLOGREDIRECT, 2: wp-config.php */ 223 __( 'If registration is disabled, please set %1$s in %2$s to a URL you will redirect visitors to if they visit a non-existent site.' ), 224 '<code>NOBLOGREDIRECT</code>', 225 '<code>wp-config.php</code>' 226 ); 227 echo '</p>'; 228 } 229 ?> 230 </fieldset> 231 </td> 232 </tr> 233 234 <tr> 235 <th scope="row"><?php _e( 'Registration notification' ); ?></th> 236 <?php 237 if ( ! get_site_option( 'registrationnotification' ) ) { 238 update_site_option( 'registrationnotification', 'yes' ); 239 } 240 ?> 241 <td> 242 <label><input name="registrationnotification" type="checkbox" id="registrationnotification" value="yes"<?php checked( get_site_option( 'registrationnotification' ), 'yes' ); ?> /> <?php _e( 'Send the network admin an email notification every time someone registers a site or user account' ); ?></label> 243 </td> 244 </tr> 245 246 <tr id="addnewusers"> 247 <th scope="row"><?php _e( 'Add Users' ); ?></th> 248 <td> 249 <label><input name="add_new_users" type="checkbox" id="add_new_users" value="1"<?php checked( get_site_option( 'add_new_users' ) ); ?> /> <?php _e( 'Allow site administrators to add new users to their site via the "Users → Add User" page' ); ?></label> 250 </td> 251 </tr> 252 253 <tr> 254 <th scope="row"><label for="illegal_names"><?php _e( 'Banned Names' ); ?></label></th> 255 <td> 256 <?php 257 $illegal_names = get_site_option( 'illegal_names' ); 258 259 if ( empty( $illegal_names ) ) { 260 $illegal_names = ''; 261 } elseif ( is_array( $illegal_names ) ) { 262 $illegal_names = implode( ' ', $illegal_names ); 263 } 264 ?> 265 <input name="illegal_names" type="text" id="illegal_names" aria-describedby="illegal-names-desc" class="large-text" value="<?php echo esc_attr( $illegal_names ); ?>" size="45" /> 266 <p class="description" id="illegal-names-desc"> 267 <?php _e( 'Users are not allowed to register these sites. Separate names by spaces.' ); ?> 268 </p> 269 </td> 270 </tr> 271 272 <tr> 273 <th scope="row"><label for="limited_email_domains"><?php _e( 'Limited Email Registrations' ); ?></label></th> 274 <td> 275 <?php 276 $limited_email_domains = get_site_option( 'limited_email_domains' ); 277 278 if ( empty( $limited_email_domains ) ) { 279 $limited_email_domains = ''; 280 } else { 281 // Convert from an input field. Back-compat for WPMU < 1.0. 282 $limited_email_domains = str_replace( ' ', "\n", $limited_email_domains ); 283 284 if ( is_array( $limited_email_domains ) ) { 285 $limited_email_domains = implode( "\n", $limited_email_domains ); 286 } 287 } 288 ?> 289 <textarea name="limited_email_domains" id="limited_email_domains" aria-describedby="limited-email-domains-desc" cols="45" rows="5"> 290 <?php echo esc_textarea( $limited_email_domains ); ?></textarea> 291 <p class="description" id="limited-email-domains-desc"> 292 <?php _e( 'If you want to limit site registrations to certain domains. One domain per line.' ); ?> 293 </p> 294 </td> 295 </tr> 296 297 <tr> 298 <th scope="row"><label for="banned_email_domains"><?php _e( 'Banned Email Domains' ); ?></label></th> 299 <td> 300 <?php 301 $banned_email_domains = get_site_option( 'banned_email_domains' ); 302 303 if ( empty( $banned_email_domains ) ) { 304 $banned_email_domains = ''; 305 } elseif ( is_array( $banned_email_domains ) ) { 306 $banned_email_domains = implode( "\n", $banned_email_domains ); 307 } 308 ?> 309 <textarea name="banned_email_domains" id="banned_email_domains" aria-describedby="banned-email-domains-desc" cols="45" rows="5"> 310 <?php echo esc_textarea( $banned_email_domains ); ?></textarea> 311 <p class="description" id="banned-email-domains-desc"> 312 <?php _e( 'If you want to ban domains from site registrations. One domain per line.' ); ?> 313 </p> 314 </td> 315 </tr> 316 317 </table> 318 <h2><?php _e( 'New Site Settings' ); ?></h2> 319 <table class="form-table" role="presentation"> 320 321 <tr> 322 <th scope="row"><label for="welcome_email"><?php _e( 'Welcome Email' ); ?></label></th> 323 <td> 324 <textarea name="welcome_email" id="welcome_email" aria-describedby="welcome-email-desc" rows="5" cols="45" class="large-text"> 325 <?php echo esc_textarea( get_site_option( 'welcome_email' ) ); ?></textarea> 326 <p class="description" id="welcome-email-desc"> 327 <?php _e( 'The welcome email sent to new site owners.' ); ?> 328 </p> 329 </td> 330 </tr> 331 <tr> 332 <th scope="row"><label for="welcome_user_email"><?php _e( 'Welcome User Email' ); ?></label></th> 333 <td> 334 <textarea name="welcome_user_email" id="welcome_user_email" aria-describedby="welcome-user-email-desc" rows="5" cols="45" class="large-text"> 335 <?php echo esc_textarea( get_site_option( 'welcome_user_email' ) ); ?></textarea> 336 <p class="description" id="welcome-user-email-desc"> 337 <?php _e( 'The welcome email sent to new users.' ); ?> 338 </p> 339 </td> 340 </tr> 341 <tr> 342 <th scope="row"><label for="first_post"><?php _e( 'First Post' ); ?></label></th> 343 <td> 344 <textarea name="first_post" id="first_post" aria-describedby="first-post-desc" rows="5" cols="45" class="large-text"> 345 <?php echo esc_textarea( get_site_option( 'first_post' ) ); ?></textarea> 346 <p class="description" id="first-post-desc"> 347 <?php _e( 'The first post on a new site.' ); ?> 348 </p> 349 </td> 350 </tr> 351 <tr> 352 <th scope="row"><label for="first_page"><?php _e( 'First Page' ); ?></label></th> 353 <td> 354 <textarea name="first_page" id="first_page" aria-describedby="first-page-desc" rows="5" cols="45" class="large-text"> 355 <?php echo esc_textarea( get_site_option( 'first_page' ) ); ?></textarea> 356 <p class="description" id="first-page-desc"> 357 <?php _e( 'The first page on a new site.' ); ?> 358 </p> 359 </td> 360 </tr> 361 <tr> 362 <th scope="row"><label for="first_comment"><?php _e( 'First Comment' ); ?></label></th> 363 <td> 364 <textarea name="first_comment" id="first_comment" aria-describedby="first-comment-desc" rows="5" cols="45" class="large-text"> 365 <?php echo esc_textarea( get_site_option( 'first_comment' ) ); ?></textarea> 366 <p class="description" id="first-comment-desc"> 367 <?php _e( 'The first comment on a new site.' ); ?> 368 </p> 369 </td> 370 </tr> 371 <tr> 372 <th scope="row"><label for="first_comment_author"><?php _e( 'First Comment Author' ); ?></label></th> 373 <td> 374 <input type="text" size="40" name="first_comment_author" id="first_comment_author" aria-describedby="first-comment-author-desc" value="<?php echo esc_attr( get_site_option( 'first_comment_author' ) ); ?>" /> 375 <p class="description" id="first-comment-author-desc"> 376 <?php _e( 'The author of the first comment on a new site.' ); ?> 377 </p> 378 </td> 379 </tr> 380 <tr> 381 <th scope="row"><label for="first_comment_email"><?php _e( 'First Comment Email' ); ?></label></th> 382 <td> 383 <input type="text" size="40" name="first_comment_email" id="first_comment_email" aria-describedby="first-comment-email-desc" value="<?php echo esc_attr( get_site_option( 'first_comment_email' ) ); ?>" /> 384 <p class="description" id="first-comment-email-desc"> 385 <?php _e( 'The email address of the first comment author on a new site.' ); ?> 386 </p> 387 </td> 388 </tr> 389 <tr> 390 <th scope="row"><label for="first_comment_url"><?php _e( 'First Comment URL' ); ?></label></th> 391 <td> 392 <input type="text" size="40" name="first_comment_url" id="first_comment_url" aria-describedby="first-comment-url-desc" value="<?php echo esc_attr( get_site_option( 'first_comment_url' ) ); ?>" /> 393 <p class="description" id="first-comment-url-desc"> 394 <?php _e( 'The URL for the first comment on a new site.' ); ?> 395 </p> 396 </td> 397 </tr> 398 </table> 399 <h2><?php _e( 'Upload Settings' ); ?></h2> 400 <table class="form-table" role="presentation"> 401 <tr> 402 <th scope="row"><?php _e( 'Site upload space' ); ?></th> 403 <td> 404 <label><input type="checkbox" id="upload_space_check_disabled" name="upload_space_check_disabled" value="0"<?php checked( (bool) get_site_option( 'upload_space_check_disabled' ), false ); ?> /> 405 <?php 406 printf( 407 /* translators: %s: Number of megabytes to limit uploads to. */ 408 __( 'Limit total size of files uploaded to %s MB' ), 409 '</label><label><input name="blog_upload_space" type="number" min="0" style="width: 100px" id="blog_upload_space" aria-describedby="blog-upload-space-desc" value="' . esc_attr( get_site_option( 'blog_upload_space', 100 ) ) . '" />' 410 ); 411 ?> 412 </label><br /> 413 <p class="screen-reader-text" id="blog-upload-space-desc"> 414 <?php 415 /* translators: Hidden accessibility text. */ 416 _e( 'Size in megabytes' ); 417 ?> 418 </p> 419 </td> 420 </tr> 421 422 <tr> 423 <th scope="row"><label for="upload_filetypes"><?php _e( 'Upload file types' ); ?></label></th> 424 <td> 425 <input name="upload_filetypes" type="text" id="upload_filetypes" aria-describedby="upload-filetypes-desc" class="large-text" value="<?php echo esc_attr( get_site_option( 'upload_filetypes', 'jpg jpeg png gif' ) ); ?>" size="45" /> 426 <p class="description" id="upload-filetypes-desc"> 427 <?php _e( 'Allowed file types. Separate types by spaces.' ); ?> 428 </p> 429 </td> 430 </tr> 431 432 <tr> 433 <th scope="row"><label for="fileupload_maxk"><?php _e( 'Max upload file size' ); ?></label></th> 434 <td> 435 <?php 436 printf( 437 /* translators: %s: File size in kilobytes. */ 438 __( '%s KB' ), 439 '<input name="fileupload_maxk" type="number" min="0" style="width: 100px" id="fileupload_maxk" aria-describedby="fileupload-maxk-desc" value="' . esc_attr( get_site_option( 'fileupload_maxk', 300 ) ) . '" />' 440 ); 441 ?> 442 <p class="screen-reader-text" id="fileupload-maxk-desc"> 443 <?php 444 /* translators: Hidden accessibility text. */ 445 _e( 'Size in kilobytes' ); 446 ?> 447 </p> 448 </td> 449 </tr> 450 </table> 451 452 <?php 453 $languages = get_available_languages(); 454 $translations = wp_get_available_translations(); 455 if ( ! empty( $languages ) || ! empty( $translations ) ) { 456 ?> 457 <h2><?php _e( 'Language Settings' ); ?></h2> 458 <table class="form-table" role="presentation"> 459 <tr> 460 <th><label for="WPLANG"><?php _e( 'Default Language' ); ?><span class="dashicons dashicons-translation" aria-hidden="true"></span></label></th> 461 <td> 462 <?php 463 $lang = get_site_option( 'WPLANG' ); 464 if ( ! in_array( $lang, $languages, true ) ) { 465 $lang = ''; 466 } 467 468 wp_dropdown_languages( 469 array( 470 'name' => 'WPLANG', 471 'id' => 'WPLANG', 472 'selected' => $lang, 473 'languages' => $languages, 474 'translations' => $translations, 475 'show_available_translations' => current_user_can( 'install_languages' ) && wp_can_install_language_pack(), 476 ) 477 ); 478 ?> 479 </td> 480 </tr> 481 </table> 482 <?php 483 } 484 ?> 485 486 <?php 487 $menu_perms = get_site_option( 'menu_items' ); 488 /** 489 * Filters available network-wide administration menu options. 490 * 491 * Options returned to this filter are output as individual checkboxes that, when selected, 492 * enable site administrator access to the specified administration menu in certain contexts. 493 * 494 * Adding options for specific menus here hinges on the appropriate checks and capabilities 495 * being in place in the site dashboard on the other side. For instance, when the single 496 * default option, 'plugins' is enabled, site administrators are granted access to the Plugins 497 * screen in their individual sites' dashboards. 498 * 499 * @since MU (3.0.0) 500 * 501 * @param string[] $admin_menus Associative array of the menu items available. 502 */ 503 $menu_items = apply_filters( 'mu_menu_items', array( 'plugins' => __( 'Plugins' ) ) ); 504 505 if ( $menu_items ) : 506 ?> 507 <h2><?php _e( 'Menu Settings' ); ?></h2> 508 <table id="menu" class="form-table"> 509 <?php $enable_administration_menus_title = __( 'Enable administration menus' ); ?> 510 <tr> 511 <th scope="row"><?php echo $enable_administration_menus_title; ?></th> 512 <td> 513 <?php 514 echo '<fieldset><legend class="screen-reader-text">' . $enable_administration_menus_title . '</legend>'; 515 516 foreach ( (array) $menu_items as $key => $val ) { 517 echo "<label><input type='checkbox' name='menu_items[" . $key . "]' value='1'" . ( isset( $menu_perms[ $key ] ) ? checked( $menu_perms[ $key ], '1', false ) : '' ) . ' /> ' . esc_html( $val ) . '</label><br/>'; 518 } 519 520 echo '</fieldset>'; 521 ?> 522 </td> 523 </tr> 524 </table> 525 <?php 526 endif; 527 ?> 528 529 <?php 530 /** 531 * Fires at the end of the Network Settings form, before the submit button. 532 * 533 * @since MU (3.0.0) 534 */ 535 do_action( 'wpmu_options' ); 536 ?> 537 <?php submit_button(); ?> 538 </form> 539 </div> 540 541 <?php require_once ABSPATH . 'wp-admin/admin-footer.php'; ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated : Wed Oct 22 08:20:04 2025 | Cross-referenced by PHPXref |