]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/ms.php
WordPress 4.7
[autoinstalls/wordpress.git] / wp-admin / includes / ms.php
index 6e8fb07ea3d28948e8a717800097c197b0562819..0edc308382b61ecbd10ee622df4d4c7a2e622973 100644 (file)
@@ -29,10 +29,12 @@ function check_upload_size( $file ) {
 
        $file_size = filesize( $file['tmp_name'] );
        if ( $space_left < $file_size ) {
+               /* translators: 1: Required disk space in kilobytes */
                $file['error'] = sprintf( __( 'Not enough space to upload. %1$s KB needed.' ), number_format( ( $file_size - $space_left ) / KB_IN_BYTES ) );
        }
 
        if ( $file_size > ( KB_IN_BYTES * get_site_option( 'fileupload_maxk', 1500 ) ) ) {
+               /* translators: 1: Maximum allowed file size in kilobytes */
                $file['error'] = sprintf( __( 'This file is too big. Files must be less than %1$s KB in size.' ), get_site_option( 'fileupload_maxk', 1500 ) );
        }
 
@@ -40,7 +42,7 @@ function check_upload_size( $file ) {
                $file['error'] = __( 'You have used your space quota. Please delete files before uploading.' );
        }
 
-       if ( $file['error'] != '0' && ! isset( $_POST['html-upload'] ) && ( ! defined( 'DOING_AJAX' ) || ! DOING_AJAX ) ) {
+       if ( $file['error'] != '0' && ! isset( $_POST['html-upload'] ) && ! wp_doing_ajax() ) {
                wp_die( $file['error'] . ' <a href="javascript:history.go(-1)">' . __( 'Back' ) . '</a>' );
        }
 
@@ -66,7 +68,7 @@ function wpmu_delete_blog( $blog_id, $drop = false ) {
                switch_to_blog( $blog_id );
        }
 
-       $blog = get_blog_details( $blog_id );
+       $blog = get_site( $blog_id );
        /**
         * Fires before a site is deleted.
         *
@@ -88,7 +90,7 @@ function wpmu_delete_blog( $blog_id, $drop = false ) {
 
        update_blog_status( $blog_id, 'deleted', 1 );
 
-       $current_site = get_current_site();
+       $current_network = get_network();
 
        // If a full blog object is not available, do not destroy anything.
        if ( $drop && ! $blog ) {
@@ -96,7 +98,7 @@ function wpmu_delete_blog( $blog_id, $drop = false ) {
        }
 
        // Don't destroy the initial, main, or root blog.
-       if ( $drop && ( 1 == $blog_id || is_main_site( $blog_id ) || ( $blog->path == $current_site->path && $blog->domain == $current_site->domain ) ) ) {
+       if ( $drop && ( 1 == $blog_id || is_main_site( $blog_id ) || ( $blog->path == $current_network->path && $blog->domain == $current_network->domain ) ) ) {
                $drop = false;
        }
 
@@ -112,7 +114,7 @@ function wpmu_delete_blog( $blog_id, $drop = false ) {
 
                $tables = $wpdb->tables( 'blog' );
                /**
-                * Filter the tables to drop when the site is deleted.
+                * Filters the tables to drop when the site is deleted.
                 *
                 * @since MU
                 *
@@ -128,7 +130,7 @@ function wpmu_delete_blog( $blog_id, $drop = false ) {
                $wpdb->delete( $wpdb->blogs, array( 'blog_id' => $blog_id ) );
 
                /**
-                * Filter the upload base directory to delete when the site is deleted.
+                * Filters the upload base directory to delete when the site is deleted.
                 *
                 * @since MU
                 *
@@ -272,6 +274,8 @@ function update_option_new_admin_email( $old_value, $value ) {
        );
        update_option( 'adminhash', $new_admin_email );
 
+       $switched_locale = switch_to_locale( get_user_locale() );
+
        /* translators: Do not translate USERNAME, ADMIN_URL, EMAIL, SITENAME, SITEURL: those are placeholders. */
        $email_text = __( 'Howdy ###USERNAME###,
 
@@ -291,7 +295,7 @@ All at ###SITENAME###
 ###SITEURL###' );
 
        /**
-        * Filter the email text sent when the site admin email is changed.
+        * Filters the email text sent when the site admin email is changed.
         *
         * The following strings have a special meaning and will get replaced dynamically:
         * ###USERNAME###  The current user's username.
@@ -315,6 +319,10 @@ All at ###SITENAME###
        $content = str_replace( '###SITEURL###', network_home_url(), $content );
 
        wp_mail( $value, sprintf( __( '[%s] New Admin Email Address' ), wp_specialchars_decode( get_option( 'blogname' ) ) ), $content );
+
+       if ( $switched_locale ) {
+               restore_previous_locale();
+       }
 }
 
 /**
@@ -353,6 +361,8 @@ function send_confirmation_on_profile_email() {
                );
                update_user_meta( $current_user->ID, '_new_email', $new_user_email );
 
+               $switched_locale = switch_to_locale( get_user_locale() );
+
                /* translators: Do not translate USERNAME, ADMIN_URL, EMAIL, SITENAME, SITEURL: those are placeholders. */
                $email_text = __( 'Howdy ###USERNAME###,
 
@@ -371,7 +381,7 @@ All at ###SITENAME###
 ###SITEURL###' );
 
                /**
-                * Filter the email text sent when a user changes emails.
+                * Filters the email text sent when a user changes emails.
                 *
                 * The following strings have a special meaning and will get replaced dynamically:
                 * ###USERNAME###  The current user's username.
@@ -388,13 +398,17 @@ All at ###SITENAME###
                $content = apply_filters( 'new_user_email_content', $email_text, $new_user_email );
 
                $content = str_replace( '###USERNAME###', $current_user->user_login, $content );
-               $content = str_replace( '###ADMIN_URL###', esc_url( admin_url( 'profile.php?newuseremail='.$hash ) ), $content );
+               $content = str_replace( '###ADMIN_URL###', esc_url( self_admin_url( 'profile.php?newuseremail=' . $hash ) ), $content );
                $content = str_replace( '###EMAIL###', $_POST['email'], $content);
                $content = str_replace( '###SITENAME###', get_site_option( 'site_name' ), $content );
                $content = str_replace( '###SITEURL###', network_home_url(), $content );
 
                wp_mail( $_POST['email'], sprintf( __( '[%s] New Email Address' ), wp_specialchars_decode( get_option( 'blogname' ) ) ), $content );
                $_POST['email'] = $current_user->user_email;
+
+               if ( $switched_locale ) {
+                       restore_previous_locale();
+               }
        }
 }
 
@@ -462,7 +476,10 @@ function display_space_usage() {
                $space .= __( 'MB' );
        }
        ?>
-       <strong><?php printf( __( 'Used: %1$s%% of %2$s' ), number_format( $percent_used ), $space ); ?></strong>
+       <strong><?php
+               /* translators: Storage space that's been used. 1: Percentage of used space, 2: Total space allowed in megabytes or gigabytes */
+               printf( __( 'Used: %1$s%% of %2$s' ), number_format( $percent_used ), $space );
+       ?></strong>
        <?php
 }
 
@@ -528,7 +545,7 @@ function update_user_status( $id, $pref, $value, $deprecated = null ) {
        global $wpdb;
 
        if ( null !== $deprecated )
-               _deprecated_argument( __FUNCTION__, '3.1' );
+               _deprecated_argument( __FUNCTION__, '3.0.2' );
 
        $wpdb->update( $wpdb->users, array( sanitize_key( $pref ) => $value ), array( 'ID' => $id ) );
 
@@ -604,7 +621,7 @@ function format_code_lang( $code = '' ) {
                've' => 'Venda', 'vi' => 'Vietnamese', 'vo' => 'Volapük', 'cy' => 'Welsh','wa' => 'Walloon','wo' => 'Wolof', 'xh' => 'Xhosa', 'yi' => 'Yiddish', 'yo' => 'Yoruba', 'za' => 'Zhuang; Chuang', 'zu' => 'Zulu' );
 
        /**
-        * Filter the language codes.
+        * Filters the language codes.
         *
         * @since MU
         *
@@ -621,10 +638,10 @@ function format_code_lang( $code = '' ) {
  * @since 3.0.0
  *
  * @param object $term     The term.
- * @param string $taxonomy The taxonomy for $term. Should be 'category' or 'post_tag', as these are
+ * @param string $taxonomy The taxonomy for `$term`. Should be 'category' or 'post_tag', as these are
  *                         the only taxonomies which are processed by this function; anything else
  *                         will be returned untouched.
- * @return object|array Returns `$term`, after filtering the 'slug' field with {@see sanitize_title()}
+ * @return object|array Returns `$term`, after filtering the 'slug' field with sanitize_title()
  *                      if $taxonomy is 'category' or 'post_tag'.
  */
 function sync_category_tag_slugs( $term, $taxonomy ) {
@@ -730,7 +747,7 @@ function mu_dropdown_languages( $lang_files = array(), $current = '' ) {
        uksort( $output, 'strnatcasecmp' );
 
        /**
-        * Filter the languages available in the dropdown.
+        * Filters the languages available in the dropdown.
         *
         * @since MU
         *
@@ -851,102 +868,6 @@ function choose_primary_blog() {
        <?php
 }
 
-/**
- * Grants Super Admin privileges.
- *
- * @since 3.0.0
- *
- * @global array $super_admins
- *
- * @param int $user_id ID of the user to be granted Super Admin privileges.
- * @return bool True on success, false on failure. This can fail when the user is
- *              already a super admin or when the `$super_admins` global is defined.
- */
-function grant_super_admin( $user_id ) {
-       // If global super_admins override is defined, there is nothing to do here.
-       if ( isset( $GLOBALS['super_admins'] ) ) {
-               return false;
-       }
-
-       /**
-        * Fires before the user is granted Super Admin privileges.
-        *
-        * @since 3.0.0
-        *
-        * @param int $user_id ID of the user that is about to be granted Super Admin privileges.
-        */
-       do_action( 'grant_super_admin', $user_id );
-
-       // Directly fetch site_admins instead of using get_super_admins()
-       $super_admins = get_site_option( 'site_admins', array( 'admin' ) );
-
-       $user = get_userdata( $user_id );
-       if ( $user && ! in_array( $user->user_login, $super_admins ) ) {
-               $super_admins[] = $user->user_login;
-               update_site_option( 'site_admins' , $super_admins );
-
-               /**
-                * Fires after the user is granted Super Admin privileges.
-                *
-                * @since 3.0.0
-                *
-                * @param int $user_id ID of the user that was granted Super Admin privileges.
-                */
-               do_action( 'granted_super_admin', $user_id );
-               return true;
-       }
-       return false;
-}
-
-/**
- * Revokes Super Admin privileges.
- *
- * @since 3.0.0
- *
- * @global array $super_admins
- *
- * @param int $user_id ID of the user Super Admin privileges to be revoked from.
- * @return bool True on success, false on failure. This can fail when the user's email
- *              is the network admin email or when the `$super_admins` global is defined.
- */
-function revoke_super_admin( $user_id ) {
-       // If global super_admins override is defined, there is nothing to do here.
-       if ( isset( $GLOBALS['super_admins'] ) ) {
-               return false;
-       }
-
-       /**
-        * Fires before the user's Super Admin privileges are revoked.
-        *
-        * @since 3.0.0
-        *
-        * @param int $user_id ID of the user Super Admin privileges are being revoked from.
-        */
-       do_action( 'revoke_super_admin', $user_id );
-
-       // Directly fetch site_admins instead of using get_super_admins()
-       $super_admins = get_site_option( 'site_admins', array( 'admin' ) );
-
-       $user = get_userdata( $user_id );
-       if ( $user && 0 !== strcasecmp( $user->user_email, get_site_option( 'admin_email' ) ) ) {
-               if ( false !== ( $key = array_search( $user->user_login, $super_admins ) ) ) {
-                       unset( $super_admins[$key] );
-                       update_site_option( 'site_admins', $super_admins );
-
-                       /**
-                        * Fires after the user's Super Admin privileges are revoked.
-                        *
-                        * @since 3.0.0
-                        *
-                        * @param int $user_id ID of the user Super Admin privileges were revoked from.
-                        */
-                       do_action( 'revoked_super_admin', $user_id );
-                       return true;
-               }
-       }
-       return false;
-}
-
 /**
  * Whether or not we can edit this network from this page.
  *
@@ -969,7 +890,7 @@ function can_edit_network( $site_id ) {
                $result = false;
 
        /**
-        * Filter whether this network can be edited from this page.
+        * Filters whether this network can be edited from this page.
         *
         * @since 3.1.0
         *
@@ -1124,3 +1045,86 @@ jQuery(document).ready( function($) {
 </script>
 <?php
 }
+
+/**
+ * Outputs the HTML for a network's "Edit Site" tabular interface.
+ *
+ * @since 4.6.0
+ *
+ * @param $args {
+ *     Optional. Array or string of Query parameters. Default empty array.
+ *
+ *     @type int    $blog_id  The site ID. Default is the current site.
+ *     @type array  $links    The tabs to include with (label|url|cap) keys.
+ *     @type string $selected The ID of the selected link.
+ * }
+ */
+function network_edit_site_nav( $args = array() ) {
+
+       /**
+        * Filters the links that appear on site-editing network pages.
+        *
+        * Default links: 'site-info', 'site-users', 'site-themes', and 'site-settings'.
+        *
+        * @since 4.6.0
+        *
+        * @param array $links {
+        *     An array of link data representing individual network admin pages.
+        *
+        *     @type array $link_slug {
+        *         An array of information about the individual link to a page.
+        *
+        *         $type string $label Label to use for the link.
+        *         $type string $url   URL, relative to `network_admin_url()` to use for the link.
+        *         $type string $cap   Capability required to see the link.
+        *     }
+        * }
+        */
+       $links = apply_filters( 'network_edit_site_nav_links', array(
+               'site-info'     => array( 'label' => __( 'Info' ),     'url' => 'site-info.php',     'cap' => 'manage_sites' ),
+               'site-users'    => array( 'label' => __( 'Users' ),    'url' => 'site-users.php',    'cap' => 'manage_sites' ),
+               'site-themes'   => array( 'label' => __( 'Themes' ),   'url' => 'site-themes.php',   'cap' => 'manage_sites' ),
+               'site-settings' => array( 'label' => __( 'Settings' ), 'url' => 'site-settings.php', 'cap' => 'manage_sites' )
+       ) );
+
+       // Parse arguments
+       $r = wp_parse_args( $args, array(
+               'blog_id'  => isset( $_GET['blog_id'] ) ? (int) $_GET['blog_id'] : 0,
+               'links'    => $links,
+               'selected' => 'site-info',
+       ) );
+
+       // Setup the links array
+       $screen_links = array();
+
+       // Loop through tabs
+       foreach ( $r['links'] as $link_id => $link ) {
+
+               // Skip link if user can't access
+               if ( ! current_user_can( $link['cap'], $r['blog_id'] ) ) {
+                       continue;
+               }
+
+               // Link classes
+               $classes = array( 'nav-tab' );
+
+               // Selected is set by the parent OR assumed by the $pagenow global
+               if ( $r['selected'] === $link_id || $link['url'] === $GLOBALS['pagenow'] ) {
+                       $classes[] = 'nav-tab-active';
+               }
+
+               // Escape each class
+               $esc_classes = implode( ' ', $classes );
+
+               // Get the URL for this link
+               $url = add_query_arg( array( 'id' => $r['blog_id'] ), network_admin_url( $link['url'] ) );
+
+               // Add link to nav links
+               $screen_links[ $link_id ] = '<a href="' . esc_url( $url ) . '" id="' . esc_attr( $link_id ) . '" class="' . $esc_classes . '">' . esc_html( $link['label'] ) . '</a>';
+       }
+
+       // All done!
+       echo '<h2 class="nav-tab-wrapper wp-clearfix">';
+       echo implode( '', $screen_links );
+       echo '</h2>';
+}