Wordpress 3.1.1
[autoinstalls/wordpress.git] / wp-includes / ms-deprecated.php
1 <?php
2 /**
3  * Deprecated functions from WordPress MU and the multisite feature. You shouldn't
4  * use these functions and look for the alternatives instead. The functions will be
5  * removed in a later version.
6  *
7  * @package WordPress
8  * @subpackage Deprecated
9  * @since 3.0.0
10  */
11
12 /*
13  * Deprecated functions come here to die.
14  */
15
16 /**
17  * @since MU
18  * @deprecated 3.0.0
19  * @deprecated Use wp_generate_password()
20  * @see wp_generate_password()
21  */
22 function generate_random_password( $len = 8 ) {
23         _deprecated_function( __FUNCTION__, '3.0', 'wp_generate_password()' );
24         return wp_generate_password( $len );
25 }
26
27 /**
28  * Determine if user is a site admin.
29  *
30  * Plugins should use is_multisite() instead of checking if this function exists
31  * to determine if multisite is enabled.
32  *
33  * This function must reside in a file included only if is_multisite() due to
34  * legacy function_exists() checks to determine if multisite is enabled.
35  *
36  * @since MU
37  * @deprecated 3.0.0
38  * @deprecated Use is_super_admin()
39  * @see is_super_admin()
40  * @see is_multisite()
41  *
42  */
43 function is_site_admin( $user_login = '' ) {
44         _deprecated_function( __FUNCTION__, '3.0', 'is_super_admin()' );
45
46         if ( empty( $user_login ) ) {
47                 $user_id = get_current_user_id();
48                 if ( !$user_id )
49                         return false;
50         } else {
51                 $user = get_user_by( 'login', $user_login );
52                 if ( empty( $user->ID ) )
53                         return false;
54                 $user_id = $user->ID;
55         }
56
57         return is_super_admin( $user_id );
58 }
59
60 if ( !function_exists( 'graceful_fail' ) ) :
61 /**
62  * @since MU
63  * @deprecated 3.0.0
64  * @deprecated Use wp_die()
65  * @see wp_die()
66  */
67 function graceful_fail( $message ) {
68         _deprecated_function( __FUNCTION__, '3.0', 'wp_die()' );
69         $message = apply_filters( 'graceful_fail', $message );
70         $message_template = apply_filters( 'graceful_fail_template',
71 '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
72 <html xmlns="http://www.w3.org/1999/xhtml"><head profile="http://gmpg.org/xfn/11">
73 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
74 <title>Error!</title>
75 <style type="text/css">
76 img {
77         border: 0;
78 }
79 body {
80 line-height: 1.6em; font-family: Georgia, serif; width: 390px; margin: auto;
81 text-align: center;
82 }
83 .message {
84         font-size: 22px;
85         width: 350px;
86         margin: auto;
87 }
88 </style>
89 </head>
90 <body>
91 <p class="message">%s</p>
92 </body>
93 </html>' );
94         die( sprintf( $message_template, $message ) );
95 }
96 endif;
97
98 /**
99  * @since MU
100  * @deprecated 3.0.0
101  * @deprecated Use get_user_by()
102  * @see get_user_by()
103  */
104 function get_user_details( $username ) {
105         _deprecated_function( __FUNCTION__, '3.0', 'get_user_by()' );
106         return get_user_by('login', $username);
107 }
108
109 /**
110  * @since MU
111  * @deprecated 3.0.0
112  * @deprecated Use clean_post_cache()
113  * @see clean_post_cache()
114  */
115 function clear_global_post_cache( $post_id ) {
116         _deprecated_function( __FUNCTION__, '3.0', 'clean_post_cache()' );
117 }
118
119 /**
120  * @since MU
121  * @deprecated 3.0.0
122  * @deprecated Use is_main_site()
123  * @see is_main_site()
124  */
125 function is_main_blog() {
126         _deprecated_function( __FUNCTION__, '3.0', 'is_main_site()' );
127         return is_main_site();
128 }
129
130 /**
131  * @since MU
132  * @deprecated 3.0.0
133  * @deprecated Use is_email()
134  * @see is_email()
135  */
136 function validate_email( $email, $check_domain = true) {
137         _deprecated_function( __FUNCTION__, '3.0', 'is_email()' );
138         return is_email( $email, $check_domain );
139 }
140
141 /**
142  * @since MU
143  * @deprecated 3.0.0
144  * @deprecated No alternative available. For performance reasons this function is not recommended.
145  */
146 function get_blog_list( $start = 0, $num = 10, $deprecated = '' ) {
147         _deprecated_function( __FUNCTION__, '3.0' );
148
149         global $wpdb;
150         $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 );
151
152         foreach ( (array) $blogs as $details ) {
153                 $blog_list[ $details['blog_id'] ] = $details;
154                 $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'" );
155         }
156         unset( $blogs );
157         $blogs = $blog_list;
158
159         if ( false == is_array( $blogs ) )
160                 return array();
161
162         if ( $num == 'all' )
163                 return array_slice( $blogs, $start, count( $blogs ) );
164         else
165                 return array_slice( $blogs, $start, $num );
166 }
167
168 /**
169  * @since MU
170  * @deprecated 3.0.0
171  * @deprecated No alternative available. For performance reasons this function is not recommended.
172  */
173 function get_most_active_blogs( $num = 10, $display = true ) {
174         _deprecated_function( __FUNCTION__, '3.0' );
175
176         $blogs = get_blog_list( 0, 'all', false ); // $blog_id -> $details
177         if ( is_array( $blogs ) ) {
178                 reset( $blogs );
179                 foreach ( (array) $blogs as $key => $details ) {
180                         $most_active[ $details['blog_id'] ] = $details['postcount'];
181                         $blog_list[ $details['blog_id'] ] = $details; // array_slice() removes keys!!
182                 }
183                 arsort( $most_active );
184                 reset( $most_active );
185                 foreach ( (array) $most_active as $key => $details )
186                         $t[ $key ] = $blog_list[ $key ];
187
188                 unset( $most_active );
189                 $most_active = $t;
190         }
191
192         if ( $display == true ) {
193                 if ( is_array( $most_active ) ) {
194                         reset( $most_active );
195                         foreach ( (array) $most_active as $key => $details ) {
196                                 $url = esc_url('http://' . $details['domain'] . $details['path']);
197                                 echo '<li>' . $details['postcount'] . " <a href='$url'>$url</a></li>";
198                         }
199                 }
200         }
201         return array_slice( $most_active, 0, $num );
202 }
203 ?>