]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/network/settings.php
WordPress 3.8
[autoinstalls/wordpress.git] / wp-admin / network / settings.php
index b3a0f897f4d1579df039cba2e5b076de7b0120c3..8fe2ad90787ffeb658a48946fc84af4804f9338a 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>' .
@@ -40,7 +39,8 @@ get_current_screen()->set_help_sidebar(
 );
 
 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,18 +84,15 @@ 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">
                <?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>
+                               <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>
 
@@ -99,8 +100,9 @@ if ( isset( $_GET['updated'] ) ) {
                                <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 ); ?>
+                                       <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>
@@ -117,10 +119,12 @@ 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>
 
@@ -146,8 +150,9 @@ if ( isset( $_GET['updated'] ) ) {
                                <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>
 
@@ -158,8 +163,9 @@ if ( isset( $_GET['updated'] ) ) {
                                        $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>
 
@@ -168,8 +174,9 @@ if ( isset( $_GET['updated'] ) ) {
                                <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>
 
@@ -181,61 +188,68 @@ if ( isset( $_GET['updated'] ) ) {
                                <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">
                                <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">
                                <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">
                                <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">
                                <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">
                                <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">
                                <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>
@@ -286,6 +300,21 @@ if ( isset( $_GET['updated'] ) ) {
                                <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 +324,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' ); ?>