Wordpress 3.0.6
[autoinstalls/wordpress.git] / wp-admin / includes / deprecated.php
1 <?php
2 /**
3  * Deprecated admin functions from past WordPress versions. You shouldn't use these
4  * functions and look for the alternatives instead. The functions will be removed
5  * in a later version.
6  *
7  * @package WordPress
8  * @subpackage Deprecated
9  */
10
11 /*
12  * Deprecated functions come here to die.
13  */
14
15 /**
16  * @since 2.1
17  * @deprecated 2.1
18  * @deprecated Use wp_tiny_mce().
19  * @see wp_tiny_mce()
20  */
21 function tinymce_include() {
22         _deprecated_function( __FUNCTION__, '2.1', 'wp_tiny_mce()' );
23
24         wp_tiny_mce();
25 }
26
27 /**
28  * Unused Admin function.
29  *
30  * @since 2.0
31  * @deprecated 2.5
32  *
33  */
34 function documentation_link() {
35         _deprecated_function( __FUNCTION__, '2.5', '' );
36         return;
37 }
38
39 /**
40  * Calculates the new dimentions for a downsampled image.
41  *
42  * @since 2.0.0
43  * @deprecated 3.0.0
44  * @deprecated Use wp_constrain_dimensions()
45  *
46  * @param int $width Current width of the image
47  * @param int $height Current height of the image
48  * @param int $wmax Maximum wanted width
49  * @param int $hmax Maximum wanted height
50  * @return mixed Array(height,width) of shrunk dimensions.
51  */
52 function wp_shrink_dimensions( $width, $height, $wmax = 128, $hmax = 96 ) {
53         _deprecated_function( __FUNCTION__, '3.0', 'wp_constrain_dimensions()' );
54         return wp_constrain_dimensions( $width, $height, $wmax, $hmax );
55 }
56
57 /**
58  * {@internal Missing Short Description}}
59  *
60  * @since unknown
61  * @deprecated unknown
62  * @deprecated Use wp_category_checklist()
63  * @see wp_category_checklist()
64  *
65  * @param unknown_type $default
66  * @param unknown_type $parent
67  * @param unknown_type $popular_ids
68  */
69 function dropdown_categories( $default = 0, $parent = 0, $popular_ids = array() ) {
70         _deprecated_function( __FUNCTION__, '0.0', 'wp_category_checklist()' );
71         global $post_ID;
72         wp_category_checklist( $post_ID );
73 }
74
75 /**
76  * {@internal Missing Short Description}}
77  *
78  * @since unknown
79  * @deprecated unknown
80  * @deprecated Use wp_link_category_checklist()
81  * @see wp_link_category_checklist()
82  *
83  * @param unknown_type $default
84  */
85 function dropdown_link_categories( $default = 0 ) {
86         _deprecated_function( __FUNCTION__, '0.0', 'wp_link_category_checklist()' );
87         global $link_id;
88         wp_link_category_checklist( $link_id );
89 }
90
91 /**
92  * {@internal Missing Short Description}}
93  *
94  * @since unknown
95  * @deprecated 3.0.0
96  * @deprecated Use wp_dropdown_categories()
97  * @see wp_dropdown_categories()
98  *
99  * @param unknown_type $currentcat
100  * @param unknown_type $currentparent
101  * @param unknown_type $parent
102  * @param unknown_type $level
103  * @param unknown_type $categories
104  * @return unknown
105  */
106 function wp_dropdown_cats( $currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0 ) {
107         _deprecated_function( __FUNCTION__, '3.0', 'wp_dropdown_categories()' );
108         if (!$categories )
109                 $categories = get_categories( array('hide_empty' => 0) );
110
111         if ( $categories ) {
112                 foreach ( $categories as $category ) {
113                         if ( $currentcat != $category->term_id && $parent == $category->parent) {
114                                 $pad = str_repeat( '&#8211; ', $level );
115                                 $category->name = esc_html( $category->name );
116                                 echo "\n\t<option value='$category->term_id'";
117                                 if ( $currentparent == $category->term_id )
118                                         echo " selected='selected'";
119                                 echo ">$pad$category->name</option>";
120                                 wp_dropdown_cats( $currentcat, $currentparent, $category->term_id, $level +1, $categories );
121                         }
122                 }
123         } else {
124                 return false;
125         }
126 }
127
128 /**
129  * Register a setting and its sanitization callback
130  *
131  * @since 2.7.0
132  * @deprecated 3.0.0
133  * @deprecated Use register_setting()
134  * @see register_setting()
135  *
136  * @param string $option_group A settings group name.  Should correspond to a whitelisted option key name.
137  *      Default whitelisted option key names include "general," "discussion," and "reading," among others.
138  * @param string $option_name The name of an option to sanitize and save.
139  * @param unknown_type $sanitize_callback A callback function that sanitizes the option's value.
140  * @return unknown
141  */
142 function add_option_update_handler( $option_group, $option_name, $sanitize_callback = '' ) {
143         _deprecated_function( __FUNCTION__, '3.0', 'register_setting()' );
144         return register_setting( $option_group, $option_name, $sanitize_callback );
145 }
146
147 /**
148  * Unregister a setting
149  *
150  * @since 2.7.0
151  * @deprecated 3.0.0
152  * @deprecated Use unregister_setting()
153  * @see unregister_setting()
154  *
155  * @param unknown_type $option_group
156  * @param unknown_type $option_name
157  * @param unknown_type $sanitize_callback
158  * @return unknown
159  */
160 function remove_option_update_handler( $option_group, $option_name, $sanitize_callback = '' ) {
161         _deprecated_function( __FUNCTION__, '3.0', 'unregister_setting()' );
162         return unregister_setting( $option_group, $option_name, $sanitize_callback );
163 }
164
165 /**
166  * Determines the language to use for CodePress syntax highlighting.
167  *
168  * @since 2.8.0
169  * @deprecated 3.0.0
170  *
171  * @param string $filename
172 **/
173 function codepress_get_lang( $filename ) {
174         _deprecated_function( __FUNCTION__, '3.0' );
175         return;
176 }
177
178 /**
179  * Adds Javascript required to make CodePress work on the theme/plugin editors.
180  *
181  * @since 2.8.0
182  * @deprecated 3.0.0
183 **/
184 function codepress_footer_js() {
185         _deprecated_function( __FUNCTION__, '3.0' );
186         return;
187 }
188
189 /**
190  * Determine whether to use CodePress.
191  *
192  * @since 2.8
193  * @deprecated 3.0.0
194 **/
195 function use_codepress() {
196         _deprecated_function( __FUNCTION__, '3.0' );
197         return;
198 }
199
200 ?>