Wordpress 3.7
[autoinstalls/wordpress.git] / wp-includes / ms-deprecated.php
index 4c3202d7c521777967288eb67890c4cdbdc35b0d..30026a87585326be1cfea85dc89d4fe4b11ba5af 100644 (file)
  */
 
 /**
- * @since unknown
+ * 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
  * @deprecated Use wp_generate_password()
  * @see wp_generate_password()
@@ -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;
        }
@@ -68,7 +85,7 @@ function graceful_fail( $message ) {
        _deprecated_function( __FUNCTION__, '3.0', 'wp_die()' );
        $message = apply_filters( 'graceful_fail', $message );
        $message_template = apply_filters( 'graceful_fail_template',
-'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+'<!DOCTYPE html>
 <html xmlns="http://www.w3.org/1999/xhtml"><head profile="http://gmpg.org/xfn/11">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <title>Error!</title>
@@ -141,10 +158,10 @@ function validate_email( $email, $check_domain = true) {
 /**
  * @since MU
  * @deprecated 3.0.0
- * @deprecated Don't use this, really.
+ * @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', "Don't use this, really." );
+       _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 );
@@ -168,10 +185,10 @@ function get_blog_list( $start = 0, $num = 10, $deprecated = '' ) {
 /**
  * @since MU
  * @deprecated 3.0.0
- * @deprecated Don't use this, really.
+ * @deprecated No alternative available. For performance reasons this function is not recommended.
  */
 function get_most_active_blogs( $num = 10, $display = true ) {
-       _deprecated_function( __FUNCTION__, '3.0', "Don't use this, really." );
+       _deprecated_function( __FUNCTION__, '3.0' );
 
        $blogs = get_blog_list( 0, 'all', false ); // $blog_id -> $details
        if ( is_array( $blogs ) ) {
@@ -200,4 +217,131 @@ function get_most_active_blogs( $num = 10, $display = true ) {
        }
        return array_slice( $most_active, 0, $num );
 }
-?>
+
+/**
+ * Redirect a user based on $_GET or $_POST arguments.
+ *
+ * The function looks for redirect arguments in the following order:
+ * 1) $_GET['ref']
+ * 2) $_POST['ref']
+ * 3) $_SERVER['HTTP_REFERER']
+ * 4) $_GET['redirect']
+ * 5) $_POST['redirect']
+ * 6) $url
+ *
+ * @since MU
+ * @deprecated 3.3.0
+ * @deprecated Use wp_redirect()
+ * @uses wpmu_admin_redirect_add_updated_param()
+ *
+ * @param string $url
+ */
+function wpmu_admin_do_redirect( $url = '' ) {
+       _deprecated_function( __FUNCTION__, '3.3' );
+
+       $ref = '';
+       if ( isset( $_GET['ref'] ) )
+               $ref = $_GET['ref'];
+       if ( isset( $_POST['ref'] ) )
+               $ref = $_POST['ref'];
+
+       if ( $ref ) {
+               $ref = wpmu_admin_redirect_add_updated_param( $ref );
+               wp_redirect( $ref );
+               exit();
+       }
+       if ( empty( $_SERVER['HTTP_REFERER'] ) == false ) {
+               wp_redirect( $_SERVER['HTTP_REFERER'] );
+               exit();
+       }
+
+       $url = wpmu_admin_redirect_add_updated_param( $url );
+       if ( isset( $_GET['redirect'] ) ) {
+               if ( substr( $_GET['redirect'], 0, 2 ) == 's_' )
+                       $url .= '&action=blogs&s='. esc_html( substr( $_GET['redirect'], 2 ) );
+       } elseif ( isset( $_POST['redirect'] ) ) {
+               $url = wpmu_admin_redirect_add_updated_param( $_POST['redirect'] );
+       }
+       wp_redirect( $url );
+       exit();
+}
+
+/**
+ * Adds an 'updated=true' argument to a URL.
+ *
+ * @since MU
+ * @deprecated 3.3.0
+ * @deprecated Use add_query_arg()
+ *
+ * @param string $url
+ * @return string
+ */
+function wpmu_admin_redirect_add_updated_param( $url = '' ) {
+       _deprecated_function( __FUNCTION__, '3.3' );
+
+       if ( strpos( $url, 'updated=true' ) === false ) {
+               if ( strpos( $url, '?' ) === false )
+                       return $url . '?updated=true';
+               else
+                       return $url . '&updated=true';
+       }
+       return $url;
+}
+
+/**
+ * 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()
+ * @uses 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 );
+}