]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/network/settings.php
WordPress 4.0-scripts
[autoinstalls/wordpress.git] / wp-admin / network / settings.php
index b3a0f897f4d1579df039cba2e5b076de7b0120c3..6349e8cdd0c9c920f43755705d400be34108809b 100644 (file)
@@ -8,7 +8,7 @@
  */
 
 /** Load WordPress Administration Bootstrap */
-require_once( './admin.php' );
+require_once( dirname( __FILE__ ) . '/admin.php' );
 
 if ( ! is_multisite() )
        wp_die( __( 'Multisite support is not enabled.' ) );
@@ -25,7 +25,6 @@ get_current_screen()->add_help_tab( array(
                'content' =>
                        '<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&#8217;s options.') . '</p>' .
                        '<p>' . __('Operational settings has fields for the network&#8217;s name and admin email.') . '</p>' .
-                       '<p>' . __('Dashboard Site is an option to give a site to users who do not have a site on the system. Their default role is Subscriber, but that default can be changed. The Admin Notice Feed can provide a notice on all dashboards of the latest post via RSS or Atom, or provide no such notice if left blank.') . '</p>' .
                        '<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>' .
                        '<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&#8127;s put in the first post, page, comment, comment author, and comment URL.') . '</p>' .
                        '<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>' .
@@ -36,11 +35,12 @@ get_current_screen()->add_help_tab( array(
 get_current_screen()->set_help_sidebar(
        '<p><strong>' . __('For more information:') . '</strong></p>' .
        '<p>' . __('<a href="http://codex.wordpress.org/Network_Admin_Settings_Screen" target="_blank">Documentation on Network Settings</a>') . '</p>' .
-       '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
+       '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
 );
 
 if ( $_POST ) {
-       do_action( 'wpmuadminedit' , '' );
+       /** This action is documented in wp-admin/network/edit.php */
+       do_action( 'wpmuadminedit' );
 
        check_admin_referer( 'siteoptions' );
 
@@ -61,18 +61,22 @@ if ( $_POST ) {
        foreach ( $options as $option_name ) {
                if ( ! isset($_POST[$option_name]) )
                        continue;
-               $value = stripslashes_deep( $_POST[$option_name] );
+               $value = wp_unslash( $_POST[$option_name] );
                update_site_option( $option_name, $value );
        }
 
-       // Update more options here
+       /**
+        * Fires after the network options are updated.
+        *
+        * @since MU
+        */
        do_action( 'update_wpmu_options' );
 
        wp_redirect( add_query_arg( 'updated', 'true', network_admin_url( 'settings.php' ) ) );
        exit();
 }
 
-include( '../admin-header.php' );
+include( ABSPATH . 'wp-admin/admin-header.php' );
 
 if ( isset( $_GET['updated'] ) ) {
        ?><div id="message" class="updated"><p><?php _e( 'Options saved.' ) ?></p></div><?php
@@ -80,33 +84,31 @@ if ( isset( $_GET['updated'] ) ) {
 ?>
 
 <div class="wrap">
-       <?php screen_icon('options-general'); ?>
        <h2><?php echo esc_html( $title ); ?></h2>
-       <form method="post" action="settings.php">
+       <form method="post" action="settings.php" novalidate="novalidate">
                <?php wp_nonce_field( 'siteoptions' ); ?>
                <h3><?php _e( 'Operational Settings' ); ?></h3>
                <table class="form-table">
-                       <tr valign="top">
-                               <th scope="row"><label for="site_name"><?php _e( 'Network Name' ) ?></label></th>
+                       <tr>
+                               <th scope="row"><label for="site_name"><?php _e( 'Network Title' ) ?></label></th>
                                <td>
                                        <input name="site_name" type="text" id="site_name" class="regular-text" value="<?php echo esc_attr( $current_site->site_name ) ?>" />
-                                       <br />
-                                       <?php _e( 'What you would like to call this network.' ) ?>
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="admin_email"><?php _e( 'Network Admin Email' ) ?></label></th>
                                <td>
-                                       <input name="admin_email" type="text" id="admin_email" class="regular-text" value="<?php echo esc_attr( get_site_option('admin_email') ) ?>" />
-                                       <br />
-                                       <?php printf( __( 'Registration and support emails will come from this address. An address such as <code>support@%s</code> is recommended.' ), $current_site->domain ); ?>
+                                       <input name="admin_email" type="email" id="admin_email" class="regular-text" value="<?php echo esc_attr( get_site_option( 'admin_email' ) ) ?>" />
+                                       <p class="description">
+                                               <?php _e( 'This email address will receive notifications. Registration and support emails will also come from this address.' ); ?>
+                                       </p>
                                </td>
                        </tr>
                </table>
                <h3><?php _e( 'Registration Settings' ); ?></h3>
                <table class="form-table">
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><?php _e( 'Allow new registrations' ) ?></th>
                                <?php
                                if ( !get_site_option( 'registration' ) )
@@ -117,14 +119,16 @@ if ( isset( $_GET['updated'] ) ) {
                                        <label><input name="registration" type="radio" id="registration1" value="none"<?php checked( $reg, 'none') ?> /> <?php _e( 'Registration is disabled.' ); ?></label><br />
                                        <label><input name="registration" type="radio" id="registration2" value="user"<?php checked( $reg, 'user') ?> /> <?php _e( 'User accounts may be registered.' ); ?></label><br />
                                        <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 />
-                                       <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><br />
-                                       <?php if ( is_subdomain_install() )
+                                       <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>
+                                       <p class="description">
+                                               <?php if ( is_subdomain_install() )
                                                _e( 'If registration is disabled, please set <code>NOBLOGREDIRECT</code> in <code>wp-config.php</code> to a URL you will redirect visitors to if they visit a non-existent site.' );
                                        ?>
+                                       </p>
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><?php _e( 'Registration notification' ) ?></th>
                                <?php
                                if ( !get_site_option( 'registrationnotification' ) )
@@ -135,41 +139,44 @@ if ( isset( $_GET['updated'] ) ) {
                                </td>
                        </tr>
 
-                       <tr valign="top" id="addnewusers">
+                       <tr id="addnewusers">
                                <th scope="row"><?php _e( 'Add New Users' ) ?></th>
                                <td>
                                        <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 &rarr; Add New" page.' ); ?></label>
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="illegal_names"><?php _e( 'Banned Names' ) ?></label></th>
                                <td>
                                        <input name="illegal_names" type="text" id="illegal_names" class="large-text" value="<?php echo esc_attr( implode( " ", (array) get_site_option( 'illegal_names' ) ) ); ?>" size="45" />
-                                       <br />
-                                       <?php _e( 'Users are not allowed to register these sites. Separate names by spaces.' ) ?>
+                                       <p class="description">
+                                               <?php _e( 'Users are not allowed to register these sites. Separate names by spaces.' ) ?>
+                                       </p>
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="limited_email_domains"><?php _e( 'Limited Email Registrations' ) ?></label></th>
                                <td>
                                        <?php $limited_email_domains = get_site_option( 'limited_email_domains' );
                                        $limited_email_domains = str_replace( ' ', "\n", $limited_email_domains ); ?>
                                        <textarea name="limited_email_domains" id="limited_email_domains" cols="45" rows="5">
 <?php echo esc_textarea( $limited_email_domains == '' ? '' : implode( "\n", (array) $limited_email_domains ) ); ?></textarea>
-                                       <br />
-                                       <?php _e( 'If you want to limit site registrations to certain domains. One domain per line.' ) ?>
+                                       <p class="description">
+                                               <?php _e( 'If you want to limit site registrations to certain domains. One domain per line.' ) ?>
+                                       </p>
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="banned_email_domains"><?php _e('Banned Email Domains') ?></label></th>
                                <td>
                                        <textarea name="banned_email_domains" id="banned_email_domains" cols="45" rows="5">
 <?php echo esc_textarea( get_site_option( 'banned_email_domains' ) == '' ? '' : implode( "\n", (array) get_site_option( 'banned_email_domains' ) ) ); ?></textarea>
-                                       <br />
-                                       <?php _e( 'If you want to ban domains from site registrations. One domain per line.' ) ?>
+                                       <p class="description">
+                                               <?php _e( 'If you want to ban domains from site registrations. One domain per line.' ) ?>
+                                       </p>
                                </td>
                        </tr>
 
@@ -177,115 +184,146 @@ if ( isset( $_GET['updated'] ) ) {
                <h3><?php _e('New Site Settings'); ?></h3>
                <table class="form-table">
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="welcome_email"><?php _e( 'Welcome Email' ) ?></label></th>
                                <td>
                                        <textarea name="welcome_email" id="welcome_email" rows="5" cols="45" class="large-text">
-<?php echo esc_textarea( stripslashes( get_site_option( 'welcome_email' ) ) ) ?></textarea>
-                                       <br />
-                                       <?php _e( 'The welcome email sent to new site owners.' ) ?>
+<?php echo esc_textarea( get_site_option( 'welcome_email' ) ) ?></textarea>
+                                       <p class="description">
+                                               <?php _e( 'The welcome email sent to new site owners.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="welcome_user_email"><?php _e( 'Welcome User Email' ) ?></label></th>
                                <td>
                                        <textarea name="welcome_user_email" id="welcome_user_email" rows="5" cols="45" class="large-text">
-<?php echo esc_textarea( stripslashes( get_site_option( 'welcome_user_email' ) ) ) ?></textarea>
-                                       <br />
-                                       <?php _e( 'The welcome email sent to new users.' ) ?>
+<?php echo esc_textarea( get_site_option( 'welcome_user_email' ) ) ?></textarea>
+                                       <p class="description">
+                                               <?php _e( 'The welcome email sent to new users.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="first_post"><?php _e( 'First Post' ) ?></label></th>
                                <td>
                                        <textarea name="first_post" id="first_post" rows="5" cols="45" class="large-text">
-<?php echo esc_textarea( stripslashes( get_site_option( 'first_post' ) ) ) ?></textarea>
-                                       <br />
-                                       <?php _e( 'The first post on a new site.' ) ?>
+<?php echo esc_textarea( get_site_option( 'first_post' ) ) ?></textarea>
+                                       <p class="description">
+                                               <?php _e( 'The first post on a new site.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="first_page"><?php _e( 'First Page' ) ?></label></th>
                                <td>
                                        <textarea name="first_page" id="first_page" rows="5" cols="45" class="large-text">
-<?php echo esc_textarea( stripslashes( get_site_option('first_page') ) ) ?></textarea>
-                                       <br />
-                                       <?php _e( 'The first page on a new site.' ) ?>
+<?php echo esc_textarea( get_site_option( 'first_page' ) ) ?></textarea>
+                                       <p class="description">
+                                               <?php _e( 'The first page on a new site.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="first_comment"><?php _e( 'First Comment' ) ?></label></th>
                                <td>
                                        <textarea name="first_comment" id="first_comment" rows="5" cols="45" class="large-text">
-<?php echo esc_textarea( stripslashes( get_site_option('first_comment') ) ) ?></textarea>
-                                       <br />
-                                       <?php _e( 'The first comment on a new site.' ) ?>
+<?php echo esc_textarea( get_site_option( 'first_comment' ) ) ?></textarea>
+                                       <p class="description">
+                                               <?php _e( 'The first comment on a new site.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="first_comment_author"><?php _e( 'First Comment Author' ) ?></label></th>
                                <td>
                                        <input type="text" size="40" name="first_comment_author" id="first_comment_author" value="<?php echo get_site_option('first_comment_author') ?>" />
-                                       <br />
-                                       <?php _e( 'The author of the first comment on a new site.' ) ?>
+                                       <p class="description">
+                                               <?php _e( 'The author of the first comment on a new site.' ) ?>
+                                       </p>
                                </td>
                        </tr>
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="first_comment_url"><?php _e( 'First Comment URL' ) ?></label></th>
                                <td>
                                        <input type="text" size="40" name="first_comment_url" id="first_comment_url" value="<?php echo esc_attr( get_site_option( 'first_comment_url' ) ) ?>" />
-                                       <br />
-                                       <?php _e( 'The URL for the first comment on a new site.' ) ?>
+                                       <p class="description">
+                                               <?php _e( 'The URL for the first comment on a new site.' ) ?>
+                                       </p>
                                </td>
                        </tr>
                </table>
                <h3><?php _e( 'Upload Settings' ); ?></h3>
                <table class="form-table">
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><?php _e( 'Site upload space' ) ?></th>
                                <td>
                                <label><input type="checkbox" id="upload_space_check_disabled" name="upload_space_check_disabled" value="0"<?php checked( get_site_option( 'upload_space_check_disabled' ), 0 ) ?>/> <?php printf( __( 'Limit total size of files uploaded to %s MB' ), '</label><label><input name="blog_upload_space" type="number" min="0" style="width: 100px" id="blog_upload_space" value="' . esc_attr( get_site_option('blog_upload_space', 100) ) . '" />' ); ?></label><br />
                                </td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="upload_filetypes"><?php _e( 'Upload file types' ) ?></label></th>
                                <td><input name="upload_filetypes" type="text" id="upload_filetypes" class="large-text" value="<?php echo esc_attr( get_site_option('upload_filetypes', 'jpg jpeg png gif') ) ?>" size="45" /></td>
                        </tr>
 
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><label for="fileupload_maxk"><?php _e( 'Max upload file size' ) ?></label></th>
                                <td><?php printf( _x( '%s KB', 'File size in kilobytes' ), '<input name="fileupload_maxk" type="number" min="0" style="width: 100px" id="fileupload_maxk" value="' . esc_attr( get_site_option( 'fileupload_maxk', 300 ) ) . '" />' ); ?></td>
                        </tr>
                </table>
 
-<?php
+               <?php
                $languages = get_available_languages();
                if ( ! empty( $languages ) ) {
-                       $lang = get_site_option( 'WPLANG' );
-?>
-               <h3><?php _e( 'Language Settings' ); ?></h3>
-               <table class="form-table">
-                               <tr valign="top">
+                       ?>
+                       <h3><?php _e( 'Language Settings' ); ?></h3>
+                       <table class="form-table">
+                               <tr>
                                        <th><label for="WPLANG"><?php _e( 'Default Language' ); ?></label></th>
                                        <td>
-                                               <select name="WPLANG" id="WPLANG">
-                                                       <?php mu_dropdown_languages( $languages, get_site_option( 'WPLANG' ) ); ?>
-                                               </select>
+                                               <?php
+                                               $lang = get_site_option( 'WPLANG' );
+                                               if ( ! in_array( $lang, $languages ) ) {
+                                                       $lang = '';
+                                               }
+
+                                               wp_dropdown_languages( array(
+                                                       'name'      => 'WPLANG',
+                                                       'id'        => 'WPLANG',
+                                                       'selected'  => $lang,
+                                                       'languages' => $languages,
+                                               ) );
+                                               ?>
                                        </td>
                                </tr>
-               </table>
-<?php
-               } // languages
-?>
+                       </table>
+                       <?php
+               }
+               ?>
 
                <h3><?php _e( 'Menu Settings' ); ?></h3>
                <table id="menu" class="form-table">
-                       <tr valign="top">
+                       <tr>
                                <th scope="row"><?php _e( 'Enable administration menus' ); ?></th>
                                <td>
                        <?php
                        $menu_perms = get_site_option( 'menu_items' );
+                       /**
+                        * Filter available network-wide administration menu options.
+                        *
+                        * Options returned to this filter are output as individual checkboxes that, when selected,
+                        * enable site administrator access to the specified administration menu in certain contexts.
+                        *
+                        * Adding options for specific menus here hinges on the appropriate checks and capabilities
+                        * being in place in the site dashboard on the other side. For instance, when the single
+                        * default option, 'plugins' is enabled, site administrators are granted access to the Plugins
+                        * screen in their individual sites' dashboards.
+                        *
+                        * @since MU
+                        *
+                        * @param array $admin_menus The menu items available.
+                        */
                        $menu_items = apply_filters( 'mu_menu_items', array( 'plugins' => __( 'Plugins' ) ) );
                        foreach ( (array) $menu_items as $key => $val ) {
                                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/>";
@@ -295,10 +333,15 @@ if ( isset( $_GET['updated'] ) ) {
                        </tr>
                </table>
 
-               <?php do_action( 'wpmu_options' ); // Add more options here ?>
-
+               <?php
+               /**
+                * Fires at the end of the Network Settings form, before the submit button.
+                *
+                * @since MU
+                */
+               do_action( 'wpmu_options' ); ?>
                <?php submit_button(); ?>
        </form>
 </div>
 
-<?php include( '../admin-footer.php' ); ?>
+<?php include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>