WordPress 4.2
[autoinstalls/wordpress.git] / wp-includes / ms-deprecated.php
index 9b910b72e0aa3371cbcab3831898e069ccb0858f..beae326fe141b090d157332caeae6dec44e37f5d 100644 (file)
  * Deprecated functions come here to die.
  */
 
+/**
+ * Get the "dashboard blog", the blog where users without a blog edit their profile data.
+ * Dashboard blog functionality was removed in WordPress 3.1, replaced by the user admin.
+ *
+ * @since MU
+ * @deprecated 3.1.0
+ * @see get_blog_details()
+ * @return int
+ */
+function get_dashboard_blog() {
+    _deprecated_function( __FUNCTION__, '3.1' );
+    if ( $blog = get_site_option( 'dashboard_blog' ) )
+        return get_blog_details( $blog );
+
+    return get_blog_details( $GLOBALS['current_site']->blog_id );
+}
+
 /**
  * @since MU
  * @deprecated 3.0.0
@@ -49,7 +66,7 @@ function is_site_admin( $user_login = '' ) {
                        return false;
        } else {
                $user = get_user_by( 'login', $user_login );
-               if ( empty( $user->ID ) )
+               if ( ! $user->exists() )
                        return false;
                $user_id = $user->ID;
        }
@@ -69,7 +86,7 @@ function graceful_fail( $message ) {
        $message = apply_filters( 'graceful_fail', $message );
        $message_template = apply_filters( 'graceful_fail_template',
 '<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml"><head profile="http://gmpg.org/xfn/11">
+<html xmlns="http://www.w3.org/1999/xhtml"><head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <title>Error!</title>
 <style type="text/css">
@@ -144,25 +161,26 @@ function validate_email( $email, $check_domain = true) {
  * @deprecated No alternative available. For performance reasons this function is not recommended.
  */
 function get_blog_list( $start = 0, $num = 10, $deprecated = '' ) {
-       _deprecated_function( __FUNCTION__, '3.0' );
+       _deprecated_function( __FUNCTION__, '3.0', 'wp_get_sites()' );
 
        global $wpdb;
        $blogs = $wpdb->get_results( $wpdb->prepare("SELECT blog_id, domain, path FROM $wpdb->blogs WHERE site_id = %d AND public = '1' AND archived = '0' AND mature = '0' AND spam = '0' AND deleted = '0' ORDER BY registered DESC", $wpdb->siteid), ARRAY_A );
 
+       $blog_list = array();
        foreach ( (array) $blogs as $details ) {
                $blog_list[ $details['blog_id'] ] = $details;
                $blog_list[ $details['blog_id'] ]['postcount'] = $wpdb->get_var( "SELECT COUNT(ID) FROM " . $wpdb->get_blog_prefix( $details['blog_id'] ). "posts WHERE post_status='publish' AND post_type='post'" );
        }
-       unset( $blogs );
-       $blogs = $blog_list;
 
-       if ( false == is_array( $blogs ) )
+       if ( ! $blog_list ) {
                return array();
+       }
 
-       if ( $num == 'all' )
-               return array_slice( $blogs, $start, count( $blogs ) );
-       else
-               return array_slice( $blogs, $start, $num );
+       if ( $num == 'all' ) {
+               return array_slice( $blog_list, $start, count( $blog_list ) );
+       } else {
+               return array_slice( $blog_list, $start, $num );
+       }
 }
 
 /**
@@ -176,15 +194,18 @@ function get_most_active_blogs( $num = 10, $display = true ) {
        $blogs = get_blog_list( 0, 'all', false ); // $blog_id -> $details
        if ( is_array( $blogs ) ) {
                reset( $blogs );
+               $most_active = array();
+               $blog_list = array();
                foreach ( (array) $blogs as $key => $details ) {
                        $most_active[ $details['blog_id'] ] = $details['postcount'];
                        $blog_list[ $details['blog_id'] ] = $details; // array_slice() removes keys!!
                }
                arsort( $most_active );
                reset( $most_active );
-               foreach ( (array) $most_active as $key => $details )
+               $t = array();
+               foreach ( (array) $most_active as $key => $details ) {
                        $t[ $key ] = $blog_list[ $key ];
-
+               }
                unset( $most_active );
                $most_active = $t;
        }
@@ -215,7 +236,6 @@ function get_most_active_blogs( $num = 10, $display = true ) {
  * @since MU
  * @deprecated 3.3.0
  * @deprecated Use wp_redirect()
- * @uses wpmu_admin_redirect_add_updated_param()
  *
  * @param string $url
  */
@@ -271,4 +291,59 @@ function wpmu_admin_redirect_add_updated_param( $url = '' ) {
        return $url;
 }
 
-?>
\ No newline at end of file
+/**
+ * Get a numeric user ID from either an email address or a login.
+ *
+ * A numeric string is considered to be an existing user ID
+ * and is simply returned as such.
+ *
+ * @since MU
+ * @deprecated 3.6.0
+ * @deprecated Use get_user_by()
+ *
+ * @param string $string Either an email address or a login.
+ * @return int
+ */
+function get_user_id_from_string( $string ) {
+       _deprecated_function( __FUNCTION__, '3.6', 'get_user_by()' );
+
+       if ( is_email( $string ) )
+               $user = get_user_by( 'email', $string );
+       elseif ( is_numeric( $string ) )
+               return $string;
+       else
+               $user = get_user_by( 'login', $string );
+
+       if ( $user )
+               return $user->ID;
+       return 0;
+}
+
+/**
+ * Get a full blog URL, given a domain and a path.
+ *
+ * @since MU
+ * @deprecated 3.7.0
+ *
+ * @param string $domain
+ * @param string $path
+ * @return string
+ */
+function get_blogaddress_by_domain( $domain, $path ) {
+       _deprecated_function( __FUNCTION__, '3.7' );
+
+       if ( is_subdomain_install() ) {
+               $url = "http://" . $domain.$path;
+       } else {
+               if ( $domain != $_SERVER['HTTP_HOST'] ) {
+                       $blogname = substr( $domain, 0, strpos( $domain, '.' ) );
+                       $url = 'http://' . substr( $domain, strpos( $domain, '.' ) + 1 ) . $path;
+                       // we're not installing the main blog
+                       if ( $blogname != 'www.' )
+                               $url .= $blogname . '/';
+               } else { // main blog
+                       $url = 'http://' . $domain . $path;
+               }
+       }
+       return esc_url_raw( $url );
+}
\ No newline at end of file