~canonical-sysadmins/wordpress/4.7.2

« back to all changes in this revision

Viewing changes to wp-includes/deprecated.php

  • Committer: Barry Price
  • Date: 2016-08-17 04:50:12 UTC
  • mfrom: (1.1.18 upstream)
  • Revision ID: barry.price@canonical.com-20160817045012-qfui81zhqnqv2ba9
Merge WP4.6 from upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
61
61
function start_wp() {
62
62
        global $wp_query;
63
63
 
64
 
        _deprecated_function( __FUNCTION__, '1.5', __('new WordPress Loop') );
 
64
        _deprecated_function( __FUNCTION__, '1.5.0', __('new WordPress Loop') );
65
65
 
66
66
        // Since the old style loop is being used, advance the query iterator here.
67
67
        $wp_query->next_post();
134
134
 */
135
135
function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {
136
136
 
137
 
        _deprecated_function( __FUNCTION__, '2.0', 'previous_post_link()' );
 
137
        _deprecated_function( __FUNCTION__, '2.0.0', 'previous_post_link()' );
138
138
 
139
139
        if ( empty($in_same_cat) || 'no' == $in_same_cat )
140
140
                $in_same_cat = false;
169
169
 * @param string $excluded_categories
170
170
 */
171
171
function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='') {
172
 
        _deprecated_function( __FUNCTION__, '2.0', 'next_post_link()' );
 
172
        _deprecated_function( __FUNCTION__, '2.0.0', 'next_post_link()' );
173
173
 
174
174
        if ( empty($in_same_cat) || 'no' == $in_same_cat )
175
175
                $in_same_cat = false;
202
202
 * @return bool
203
203
 */
204
204
function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {
205
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
205
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
206
206
 
207
207
        $author_data = get_userdata($user_id);
208
208
        return ($author_data->user_level > 1);
221
221
 * @return bool
222
222
 */
223
223
function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
224
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
224
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
225
225
 
226
226
        $author_data = get_userdata($user_id);
227
227
        return ($author_data->user_level >= 1);
240
240
 * @return bool
241
241
 */
242
242
function user_can_edit_post($user_id, $post_id, $blog_id = 1) {
243
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
243
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
244
244
 
245
245
        $author_data = get_userdata($user_id);
246
246
        $post = get_post($post_id);
268
268
 * @return bool
269
269
 */
270
270
function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
271
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
271
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
272
272
 
273
273
        // right now if one can edit, one can delete
274
274
        return user_can_edit_post($user_id, $post_id, $blog_id);
287
287
 * @return bool
288
288
 */
289
289
function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {
290
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
290
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
291
291
 
292
292
        $author_data = get_userdata($user_id);
293
293
        return (($author_data->user_level > 4) && user_can_create_post($user_id, $blog_id, $category_id));
306
306
 * @return bool returns true if $user_id can edit $post_id's date
307
307
 */
308
308
function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {
309
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
309
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
310
310
 
311
311
        $author_data = get_userdata($user_id);
312
312
        return (($author_data->user_level > 4) && user_can_edit_post($user_id, $post_id, $blog_id));
325
325
 * @return bool returns true if $user_id can edit $post_id's comments
326
326
 */
327
327
function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
328
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
328
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
329
329
 
330
330
        // right now if one can edit a post, one can edit comments made on it
331
331
        return user_can_edit_post($user_id, $post_id, $blog_id);
344
344
 * @return bool returns true if $user_id can delete $post_id's comments
345
345
 */
346
346
function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
347
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
347
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
348
348
 
349
349
        // right now if one can edit comments, one can delete comments
350
350
        return user_can_edit_post_comments($user_id, $post_id, $blog_id);
362
362
 * @return bool
363
363
 */
364
364
function user_can_edit_user($user_id, $other_user) {
365
 
        _deprecated_function( __FUNCTION__, '2.0', 'current_user_can()' );
 
365
        _deprecated_function( __FUNCTION__, '2.0.0', 'current_user_can()' );
366
366
 
367
367
        $user  = get_userdata($user_id);
368
368
        $other = get_userdata($other_user);
395
395
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
396
396
                                                 $show_description = true, $show_rating = false,
397
397
                                                 $limit = -1, $show_updated = 0) {
398
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
398
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
399
399
 
400
400
        $cat_id = -1;
401
401
        $cat = get_term_by('name', $cat_name, 'link_category');
417
417
 * @return string|null
418
418
 */
419
419
function wp_get_linksbyname($category, $args = '') {
420
 
        _deprecated_function(__FUNCTION__, '2.1', 'wp_list_bookmarks()');
 
420
        _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_bookmarks()');
421
421
 
422
422
        $defaults = array(
423
423
                'after' => '<br />',
455
455
 * @return array
456
456
 */
457
457
function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
458
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
458
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
459
459
 
460
460
        $cat_id = -1;
461
461
        $cat = get_term_by('name', $cat_name, 'link_category');
506
506
 * @return array
507
507
 */
508
508
function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
509
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
509
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
510
510
 
511
511
        $links = get_bookmarks( array( 'category' => $category, 'orderby' => $orderby, 'limit' => $limit ) ) ;
512
512
 
539
539
 */
540
540
function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
541
541
                                                                        $show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
542
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
542
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
543
543
 
544
544
        get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
545
545
}
566
566
 */
567
567
function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
568
568
                                                          $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
569
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
569
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
570
570
 
571
571
        get_links($category, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
572
572
}
581
581
 * @return int Only returns 0.
582
582
 */
583
583
function get_autotoggle($id = 0) {
584
 
        _deprecated_function( __FUNCTION__, '2.1' );
 
584
        _deprecated_function( __FUNCTION__, '2.1.0' );
585
585
        return 0;
586
586
}
587
587
 
615
615
function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
616
616
                                   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
617
617
                                   $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
618
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
 
618
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' );
619
619
 
620
620
        $query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
621
621
                'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
633
633
 * @return false|null|string
634
634
 */
635
635
function wp_list_cats($args = '') {
636
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );
 
636
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' );
637
637
 
638
638
        $r = wp_parse_args( $args );
639
639
 
677
677
function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',
678
678
                $show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,
679
679
                $selected = 0, $exclude = 0) {
680
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_dropdown_categories()' );
 
680
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_dropdown_categories()' );
681
681
 
682
682
        $show_option_all = '';
683
683
        if ( $optionall )
709
709
 * @return null|string
710
710
 */
711
711
function list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '') {
712
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_list_authors()' );
 
712
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_authors()' );
713
713
 
714
714
        $args = compact('optioncount', 'exclude_admin', 'show_fullname', 'hide_empty', 'feed', 'feed_image');
715
715
        return wp_list_authors($args);
727
727
 * @return array
728
728
 */
729
729
function wp_get_post_cats($blogid = '1', $post_ID = 0) {
730
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_get_post_categories()' );
 
730
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_post_categories()' );
731
731
        return wp_get_post_categories($post_ID);
732
732
}
733
733
 
745
745
 * @return bool|mixed
746
746
 */
747
747
function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array()) {
748
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_set_post_categories()' );
 
748
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_set_post_categories()' );
749
749
        return wp_set_post_categories($post_ID, $post_categories);
750
750
}
751
751
 
765
765
 * @return string|null
766
766
 */
767
767
function get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false) {
768
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_get_archives()' );
 
768
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_get_archives()' );
769
769
        $args = compact('type', 'limit', 'format', 'before', 'after', 'show_post_count');
770
770
        return wp_get_archives($args);
771
771
}
783
783
 * @return string|null
784
784
 */
785
785
function get_author_link($echo, $author_id, $author_nicename = '') {
786
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_author_posts_url()' );
 
786
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_author_posts_url()' );
787
787
 
788
788
        $link = get_author_posts_url($author_id, $author_nicename);
789
789
 
810
810
 */
811
811
function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
812
812
                                        $pagelink='%', $more_file='') {
813
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_link_pages()' );
 
813
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_link_pages()' );
814
814
 
815
815
        $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
816
816
        return wp_link_pages($args);
827
827
 * @return string
828
828
 */
829
829
function get_settings($option) {
830
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_option()' );
 
830
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_option()' );
831
831
 
832
832
        return get_option($option);
833
833
}
840
840
 * @see the_permalink()
841
841
 */
842
842
function permalink_link() {
843
 
        _deprecated_function( __FUNCTION__, '1.2', 'the_permalink()' );
 
843
        _deprecated_function( __FUNCTION__, '1.2.0', 'the_permalink()' );
844
844
        the_permalink();
845
845
}
846
846
 
854
854
 * @param string $deprecated
855
855
 */
856
856
function permalink_single_rss($deprecated = '') {
857
 
        _deprecated_function( __FUNCTION__, '2.3', 'the_permalink_rss()' );
 
857
        _deprecated_function( __FUNCTION__, '2.3.0', 'the_permalink_rss()' );
858
858
        the_permalink_rss();
859
859
}
860
860
 
869
869
 * @return null|string
870
870
 */
871
871
function wp_get_links($args = '') {
872
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
 
872
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' );
873
873
 
874
874
        if ( strpos( $args, '=' ) === false ) {
875
875
                $cat_id = $args;
923
923
 */
924
924
function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
925
925
                        $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
926
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmarks()' );
 
926
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
927
927
 
928
928
        $order = 'ASC';
929
929
        if ( substr($orderby, 0, 1) == '_' ) {
1015
1015
 * @param string $order Sort link categories by 'name' or 'id'
1016
1016
 */
1017
1017
function get_links_list($order = 'name') {
1018
 
        _deprecated_function( __FUNCTION__, '2.1', 'wp_list_bookmarks()' );
 
1018
        _deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_bookmarks()' );
1019
1019
 
1020
1020
        $order = strtolower($order);
1021
1021
 
1060
1060
 * @param bool $count the number of links in the db
1061
1061
 */
1062
1062
function links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true) {
1063
 
        _deprecated_function( __FUNCTION__, '2.1' );
 
1063
        _deprecated_function( __FUNCTION__, '2.1.0' );
1064
1064
}
1065
1065
 
1066
1066
/**
1074
1074
 * @return mixed Value of the 'link_rating' field, false otherwise.
1075
1075
 */
1076
1076
function get_linkrating( $link ) {
1077
 
        _deprecated_function( __FUNCTION__, '2.1', 'sanitize_bookmark_field()' );
 
1077
        _deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' );
1078
1078
        return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
1079
1079
}
1080
1080
 
1089
1089
 * @return string
1090
1090
 */
1091
1091
function get_linkcatname($id = 0) {
1092
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_category()' );
 
1092
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_category()' );
1093
1093
 
1094
1094
        $id = (int) $id;
1095
1095
 
1117
1117
 * @param string $link_text
1118
1118
 */
1119
1119
function comments_rss_link($link_text = 'Comments RSS') {
1120
 
        _deprecated_function( __FUNCTION__, '2.5', 'post_comments_feed_link()' );
 
1120
        _deprecated_function( __FUNCTION__, '2.5.0', 'post_comments_feed_link()' );
1121
1121
        post_comments_feed_link($link_text);
1122
1122
}
1123
1123
 
1133
1133
 * @return string
1134
1134
 */
1135
1135
function get_category_rss_link($echo = false, $cat_ID = 1) {
1136
 
        _deprecated_function( __FUNCTION__, '2.5', 'get_category_feed_link()' );
 
1136
        _deprecated_function( __FUNCTION__, '2.5.0', 'get_category_feed_link()' );
1137
1137
 
1138
1138
        $link = get_category_feed_link($cat_ID, 'rss2');
1139
1139
 
1154
1154
 * @return string
1155
1155
 */
1156
1156
function get_author_rss_link($echo = false, $author_id = 1) {
1157
 
        _deprecated_function( __FUNCTION__, '2.5', 'get_author_feed_link()' );
 
1157
        _deprecated_function( __FUNCTION__, '2.5.0', 'get_author_feed_link()' );
1158
1158
 
1159
1159
        $link = get_author_feed_link($author_id);
1160
1160
        if ( $echo )
1172
1172
 * @return string
1173
1173
 */
1174
1174
function comments_rss() {
1175
 
        _deprecated_function( __FUNCTION__, '2.2', 'get_post_comments_feed_link()' );
 
1175
        _deprecated_function( __FUNCTION__, '2.2.0', 'get_post_comments_feed_link()' );
1176
1176
        return esc_url( get_post_comments_feed_link() );
1177
1177
}
1178
1178
 
1189
1189
 * @return int The new user's ID.
1190
1190
 */
1191
1191
function create_user($username, $password, $email) {
1192
 
        _deprecated_function( __FUNCTION__, '2.0', 'wp_create_user()' );
 
1192
        _deprecated_function( __FUNCTION__, '2.0.0', 'wp_create_user()' );
1193
1193
        return wp_create_user($username, $password, $email);
1194
1194
}
1195
1195
 
1199
1199
 * @deprecated 2.5.0
1200
1200
 */
1201
1201
function gzip_compression() {
1202
 
        _deprecated_function( __FUNCTION__, '2.5' );
 
1202
        _deprecated_function( __FUNCTION__, '2.5.0' );
1203
1203
        return false;
1204
1204
}
1205
1205
 
1216
1216
 * @return array The comment data
1217
1217
 */
1218
1218
function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = false ) {
1219
 
        _deprecated_function( __FUNCTION__, '2.7', 'get_comment()' );
 
1219
        _deprecated_function( __FUNCTION__, '2.7.0', 'get_comment()' );
1220
1220
        return get_comment($comment_ID, ARRAY_A);
1221
1221
}
1222
1222
 
1231
1231
 * @return string category name
1232
1232
 */
1233
1233
function get_catname( $cat_ID ) {
1234
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_cat_name()' );
 
1234
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_cat_name()' );
1235
1235
        return get_cat_name( $cat_ID );
1236
1236
}
1237
1237
 
1249
1249
 * @return string
1250
1250
 */
1251
1251
function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {
1252
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_term_children()' );
 
1252
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_term_children()' );
1253
1253
        if ( 0 == $id )
1254
1254
                return '';
1255
1255
 
1284
1284
 * @return object List of all of the category IDs.
1285
1285
 */
1286
1286
function get_all_category_ids() {
1287
 
        _deprecated_function( __FUNCTION__, '4.0', 'get_terms()' );
 
1287
        _deprecated_function( __FUNCTION__, '4.0.0', 'get_terms()' );
1288
1288
 
1289
1289
        if ( ! $cat_ids = wp_cache_get( 'all_category_ids', 'category' ) ) {
1290
1290
                $cat_ids = get_terms( 'category', array('fields' => 'ids', 'get' => 'all') );
1304
1304
 * @return string The author's description.
1305
1305
 */
1306
1306
function get_the_author_description() {
1307
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'description\')' );
 
1307
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'description\')' );
1308
1308
        return get_the_author_meta('description');
1309
1309
}
1310
1310
 
1316
1316
 * @see the_author_meta()
1317
1317
 */
1318
1318
function the_author_description() {
1319
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'description\')' );
 
1319
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'description\')' );
1320
1320
        the_author_meta('description');
1321
1321
}
1322
1322
 
1330
1330
 * @return string The author's login name (username).
1331
1331
 */
1332
1332
function get_the_author_login() {
1333
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'login\')' );
 
1333
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'login\')' );
1334
1334
        return get_the_author_meta('login');
1335
1335
}
1336
1336
 
1342
1342
 * @see the_author_meta()
1343
1343
 */
1344
1344
function the_author_login() {
1345
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'login\')' );
 
1345
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'login\')' );
1346
1346
        the_author_meta('login');
1347
1347
}
1348
1348
 
1356
1356
 * @return string The author's first name.
1357
1357
 */
1358
1358
function get_the_author_firstname() {
1359
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'first_name\')' );
 
1359
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'first_name\')' );
1360
1360
        return get_the_author_meta('first_name');
1361
1361
}
1362
1362
 
1368
1368
 * @see the_author_meta()
1369
1369
 */
1370
1370
function the_author_firstname() {
1371
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'first_name\')' );
 
1371
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'first_name\')' );
1372
1372
        the_author_meta('first_name');
1373
1373
}
1374
1374
 
1382
1382
 * @return string The author's last name.
1383
1383
 */
1384
1384
function get_the_author_lastname() {
1385
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'last_name\')' );
 
1385
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'last_name\')' );
1386
1386
        return get_the_author_meta('last_name');
1387
1387
}
1388
1388
 
1394
1394
 * @see the_author_meta()
1395
1395
 */
1396
1396
function the_author_lastname() {
1397
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'last_name\')' );
 
1397
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'last_name\')' );
1398
1398
        the_author_meta('last_name');
1399
1399
}
1400
1400
 
1408
1408
 * @return string The author's nickname.
1409
1409
 */
1410
1410
function get_the_author_nickname() {
1411
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'nickname\')' );
 
1411
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'nickname\')' );
1412
1412
        return get_the_author_meta('nickname');
1413
1413
}
1414
1414
 
1420
1420
 * @see the_author_meta()
1421
1421
 */
1422
1422
function the_author_nickname() {
1423
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'nickname\')' );
 
1423
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'nickname\')' );
1424
1424
        the_author_meta('nickname');
1425
1425
}
1426
1426
 
1434
1434
 * @return string The author's username.
1435
1435
 */
1436
1436
function get_the_author_email() {
1437
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'email\')' );
 
1437
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'email\')' );
1438
1438
        return get_the_author_meta('email');
1439
1439
}
1440
1440
 
1446
1446
 * @see the_author_meta()
1447
1447
 */
1448
1448
function the_author_email() {
1449
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'email\')' );
 
1449
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'email\')' );
1450
1450
        the_author_meta('email');
1451
1451
}
1452
1452
 
1460
1460
 * @return string The author's ICQ number.
1461
1461
 */
1462
1462
function get_the_author_icq() {
1463
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'icq\')' );
 
1463
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'icq\')' );
1464
1464
        return get_the_author_meta('icq');
1465
1465
}
1466
1466
 
1472
1472
 * @see the_author_meta()
1473
1473
 */
1474
1474
function the_author_icq() {
1475
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'icq\')' );
 
1475
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'icq\')' );
1476
1476
        the_author_meta('icq');
1477
1477
}
1478
1478
 
1486
1486
 * @return string The author's Yahoo! IM name.
1487
1487
 */
1488
1488
function get_the_author_yim() {
1489
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'yim\')' );
 
1489
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'yim\')' );
1490
1490
        return get_the_author_meta('yim');
1491
1491
}
1492
1492
 
1498
1498
 * @see the_author_meta()
1499
1499
 */
1500
1500
function the_author_yim() {
1501
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'yim\')' );
 
1501
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'yim\')' );
1502
1502
        the_author_meta('yim');
1503
1503
}
1504
1504
 
1512
1512
 * @return string The author's MSN address.
1513
1513
 */
1514
1514
function get_the_author_msn() {
1515
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'msn\')' );
 
1515
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'msn\')' );
1516
1516
        return get_the_author_meta('msn');
1517
1517
}
1518
1518
 
1524
1524
 * @see the_author_meta()
1525
1525
 */
1526
1526
function the_author_msn() {
1527
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'msn\')' );
 
1527
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'msn\')' );
1528
1528
        the_author_meta('msn');
1529
1529
}
1530
1530
 
1538
1538
 * @return string The author's AIM address.
1539
1539
 */
1540
1540
function get_the_author_aim() {
1541
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'aim\')' );
 
1541
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'aim\')' );
1542
1542
        return get_the_author_meta('aim');
1543
1543
}
1544
1544
 
1550
1550
 * @see the_author_meta()
1551
1551
 */
1552
1552
function the_author_aim() {
1553
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'aim\')' );
 
1553
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'aim\')' );
1554
1554
        the_author_meta('aim');
1555
1555
}
1556
1556
 
1565
1565
 * @return string The author's display name.
1566
1566
 */
1567
1567
function get_author_name( $auth_id = false ) {
1568
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'display_name\')' );
 
1568
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'display_name\')' );
1569
1569
        return get_the_author_meta('display_name', $auth_id);
1570
1570
}
1571
1571
 
1579
1579
 * @return string The URL to the author's page.
1580
1580
 */
1581
1581
function get_the_author_url() {
1582
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'url\')' );
 
1582
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'url\')' );
1583
1583
        return get_the_author_meta('url');
1584
1584
}
1585
1585
 
1591
1591
 * @see the_author_meta()
1592
1592
 */
1593
1593
function the_author_url() {
1594
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'url\')' );
 
1594
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'url\')' );
1595
1595
        the_author_meta('url');
1596
1596
}
1597
1597
 
1605
1605
 * @return string|int The author's ID.
1606
1606
 */
1607
1607
function get_the_author_ID() {
1608
 
        _deprecated_function( __FUNCTION__, '2.8', 'get_the_author_meta(\'ID\')' );
 
1608
        _deprecated_function( __FUNCTION__, '2.8.0', 'get_the_author_meta(\'ID\')' );
1609
1609
        return get_the_author_meta('ID');
1610
1610
}
1611
1611
 
1617
1617
 * @see the_author_meta()
1618
1618
 */
1619
1619
function the_author_ID() {
1620
 
        _deprecated_function( __FUNCTION__, '2.8', 'the_author_meta(\'ID\')' );
 
1620
        _deprecated_function( __FUNCTION__, '2.8.0', 'the_author_meta(\'ID\')' );
1621
1621
        the_author_meta('ID');
1622
1622
}
1623
1623
 
1650
1650
 * @param int $encode_html Optional. How to encode the content.
1651
1651
 */
1652
1652
function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
1653
 
        _deprecated_function( __FUNCTION__, '2.9', 'the_content_feed' );
 
1653
        _deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed' );
1654
1654
        $content = get_the_content($more_link_text, $stripteaser);
1655
1655
        $content = apply_filters('the_content_rss', $content);
1656
1656
        if ( $cut && !$encode_html )
1696
1696
 * @return string HTML stripped out of content with links at the bottom.
1697
1697
 */
1698
1698
function make_url_footnote( $content ) {
1699
 
        _deprecated_function( __FUNCTION__, '2.9', '' );
 
1699
        _deprecated_function( __FUNCTION__, '2.9.0', '' );
1700
1700
        preg_match_all( '/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/', $content, $matches );
1701
1701
        $links_summary = "\n";
1702
1702
        for ( $i = 0, $c = count( $matches[0] ); $i < $c; $i++ ) {
1735
1735
 * @return string Translated context string without pipe
1736
1736
 */
1737
1737
function _c( $text, $domain = 'default' ) {
1738
 
        _deprecated_function( __FUNCTION__, '2.9', '_x()' );
 
1738
        _deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
1739
1739
        return before_last_bar( translate( $text, $domain ) );
1740
1740
}
1741
1741
 
1752
1752
 * @return string Translated text
1753
1753
 */
1754
1754
function translate_with_context( $text, $domain = 'default' ) {
1755
 
        _deprecated_function( __FUNCTION__, '2.9', '_x()' );
 
1755
        _deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
1756
1756
        return before_last_bar( translate( $text, $domain ) );
1757
1757
}
1758
1758
 
1773
1773
 * @return string The translated singular or plural form.
1774
1774
 */
1775
1775
function _nc( $single, $plural, $number, $domain = 'default' ) {
1776
 
        _deprecated_function( __FUNCTION__, '2.9', '_nx()' );
 
1776
        _deprecated_function( __FUNCTION__, '2.9.0', '_nx()' );
1777
1777
        return before_last_bar( _n( $single, $plural, $number, $domain ) );
1778
1778
}
1779
1779
 
1785
1785
 * @see _n()
1786
1786
 */
1787
1787
function __ngettext() {
1788
 
        _deprecated_function( __FUNCTION__, '2.8', '_n()' );
 
1788
        _deprecated_function( __FUNCTION__, '2.8.0', '_n()' );
1789
1789
        $args = func_get_args();
1790
1790
        return call_user_func_array('_n', $args);
1791
1791
}
1798
1798
 * @see _n_noop()
1799
1799
 */
1800
1800
function __ngettext_noop() {
1801
 
        _deprecated_function( __FUNCTION__, '2.8', '_n_noop()' );
 
1801
        _deprecated_function( __FUNCTION__, '2.8.0', '_n_noop()' );
1802
1802
        $args = func_get_args();
1803
1803
        return call_user_func_array('_n_noop', $args);
1804
1804
 
1814
1814
 * @return array List of all options.
1815
1815
 */
1816
1816
function get_alloptions() {
1817
 
        _deprecated_function( __FUNCTION__, '3.0', 'wp_load_alloptions()' );
 
1817
        _deprecated_function( __FUNCTION__, '3.0.0', 'wp_load_alloptions()' );
1818
1818
        return wp_load_alloptions();
1819
1819
}
1820
1820
 
1832
1832
 * @return string
1833
1833
 */
1834
1834
function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) {
1835
 
        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_link()' );
 
1835
        _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_link()' );
1836
1836
        $id = (int) $id;
1837
1837
        $_post = get_post($id);
1838
1838
 
1860
1860
 * @return array Icon URL and full path to file, respectively.
1861
1861
 */
1862
1862
function get_attachment_icon_src( $id = 0, $fullsize = false ) {
1863
 
        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image_src()' );
 
1863
        _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image_src()' );
1864
1864
        $id = (int) $id;
1865
1865
        if ( !$post = get_post($id) )
1866
1866
                return false;
1902
1902
 * @return false|string HTML content.
1903
1903
 */
1904
1904
function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
1905
 
        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
 
1905
        _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
1906
1906
        $id = (int) $id;
1907
1907
        if ( !$post = get_post($id) )
1908
1908
                return false;
1958
1958
 * @return false|string
1959
1959
 */
1960
1960
function get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false) {
1961
 
        _deprecated_function( __FUNCTION__, '2.5', 'wp_get_attachment_image()' );
 
1961
        _deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
1962
1962
        $id = (int) $id;
1963
1963
        if ( !$post = get_post($id) )
1964
1964
                return false;
1986
1986
 * @return object|array Bookmark object or array, depending on the type specified by `$output`.
1987
1987
 */
1988
1988
function get_link( $bookmark_id, $output = OBJECT, $filter = 'raw' ) {
1989
 
        _deprecated_function( __FUNCTION__, '2.1', 'get_bookmark()' );
 
1989
        _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmark()' );
1990
1990
        return get_bookmark($bookmark_id, $output, $filter);
1991
1991
}
1992
1992
 
2002
2002
 * @return string The cleaned URL.
2003
2003
 */
2004
2004
function sanitize_url( $url, $protocols = null ) {
2005
 
        _deprecated_function( __FUNCTION__, '2.8', 'esc_url_raw()' );
 
2005
        _deprecated_function( __FUNCTION__, '2.8.0', 'esc_url_raw()' );
2006
2006
        return esc_url_raw( $url, $protocols );
2007
2007
}
2008
2008
 
2020
2020
 * @param string $url The URL to be cleaned.
2021
2021
 * @param array $protocols Optional. An array of acceptable protocols.
2022
2022
 * @param string $context Optional. How the URL will be used. Default is 'display'.
2023
 
 * @return string The cleaned $url after the 'clean_url' filter is applied.
 
2023
 * @return string The cleaned $url after the {@see 'clean_url'} filter is applied.
2024
2024
 */
2025
2025
function clean_url( $url, $protocols = null, $context = 'display' ) {
2026
2026
        if ( $context == 'db' )
2027
 
                _deprecated_function( 'clean_url( $context = \'db\' )', '3.0', 'esc_url_raw()' );
 
2027
                _deprecated_function( 'clean_url( $context = \'db\' )', '3.0.0', 'esc_url_raw()' );
2028
2028
        else
2029
 
                _deprecated_function( __FUNCTION__, '3.0', 'esc_url()' );
 
2029
                _deprecated_function( __FUNCTION__, '3.0.0', 'esc_url()' );
2030
2030
        return esc_url( $url, $protocols, $context );
2031
2031
}
2032
2032
 
2033
2033
/**
2034
2034
 * Escape single quotes, specialchar double quotes, and fix line endings.
2035
2035
 *
2036
 
 * The filter 'js_escape' is also applied by esc_js()
 
2036
 * The filter {@see 'js_escape'} is also applied by esc_js().
2037
2037
 *
2038
2038
 * @since 2.0.4
2039
2039
 * @deprecated 2.8.0 Use esc_js()
2043
2043
 * @return string Escaped text.
2044
2044
 */
2045
2045
function js_escape( $text ) {
2046
 
        _deprecated_function( __FUNCTION__, '2.8', 'esc_js()' );
 
2046
        _deprecated_function( __FUNCTION__, '2.8.0', 'esc_js()' );
2047
2047
        return esc_js( $text );
2048
2048
}
2049
2049
 
2060
2060
 * @return string Escaped `$string`.
2061
2061
 */
2062
2062
function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
2063
 
        _deprecated_function( __FUNCTION__, '2.8', 'esc_html()' );
2064
 
        if ( func_num_args() > 1 ) { // Maintain backwards compat for people passing additional args
 
2063
        _deprecated_function( __FUNCTION__, '2.8.0', 'esc_html()' );
 
2064
        if ( func_num_args() > 1 ) { // Maintain back-compat for people passing additional arguments.
2065
2065
                $args = func_get_args();
2066
2066
                return call_user_func_array( '_wp_specialchars', $args );
2067
2067
        } else {
2080
2080
 * @return string
2081
2081
 */
2082
2082
function attribute_escape( $text ) {
2083
 
        _deprecated_function( __FUNCTION__, '2.8', 'esc_attr()' );
 
2083
        _deprecated_function( __FUNCTION__, '2.8.0', 'esc_attr()' );
2084
2084
        return esc_attr( $text );
2085
2085
}
2086
2086
 
2087
2087
/**
2088
 
 * Register widget for sidebar with backwards compatibility.
 
2088
 * Register widget for sidebar with backward compatibility.
2089
2089
 *
2090
2090
 * Allows $name to be an array that accepts either three elements to grab the
2091
2091
 * first element and the third for the name or just uses the first element of
2092
2092
 * the array for the name.
2093
2093
 *
2094
 
 * Passes to {@link wp_register_sidebar_widget()} after argument list and
2095
 
 * backwards compatibility is complete.
 
2094
 * Passes to wp_register_sidebar_widget() after argument list and backward
 
2095
 * compatibility is complete.
2096
2096
 *
2097
2097
 * @since 2.2.0
2098
2098
 * @deprecated 2.8.0 Use wp_register_sidebar_widget()
2104
2104
 * @param mixed      $params ,...     Widget parameters.
2105
2105
 */
2106
2106
function register_sidebar_widget($name, $output_callback, $classname = '') {
2107
 
        _deprecated_function( __FUNCTION__, '2.8', 'wp_register_sidebar_widget()' );
 
2107
        _deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_sidebar_widget()' );
2108
2108
        // Compat
2109
2109
        if ( is_array($name) ) {
2110
2110
                if ( count($name) == 3 )
2126
2126
}
2127
2127
 
2128
2128
/**
2129
 
 * Alias of {@link wp_unregister_sidebar_widget()}.
 
2129
 * Serves as an alias of wp_unregister_sidebar_widget().
2130
2130
 *
2131
2131
 * @since 2.2.0
2132
2132
 * @deprecated 2.8.0 Use wp_unregister_sidebar_widget()
2135
2135
 * @param int|string $id Widget ID.
2136
2136
 */
2137
2137
function unregister_sidebar_widget($id) {
2138
 
        _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_sidebar_widget()' );
 
2138
        _deprecated_function( __FUNCTION__, '2.8.0', 'wp_unregister_sidebar_widget()' );
2139
2139
        return wp_unregister_sidebar_widget($id);
2140
2140
}
2141
2141
 
2159
2159
 * @param int $height Widget height.
2160
2160
 */
2161
2161
function register_widget_control($name, $control_callback, $width = '', $height = '') {
2162
 
        _deprecated_function( __FUNCTION__, '2.8', 'wp_register_widget_control()' );
 
2162
        _deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_widget_control()' );
2163
2163
        // Compat
2164
2164
        if ( is_array($name) ) {
2165
2165
                if ( count($name) == 3 )
2192
2192
 * @param int|string $id Widget ID.
2193
2193
 */
2194
2194
function unregister_widget_control($id) {
2195
 
        _deprecated_function( __FUNCTION__, '2.8', 'wp_unregister_widget_control()' );
 
2195
        _deprecated_function( __FUNCTION__, '2.8.0', 'wp_unregister_widget_control()' );
2196
2196
        return wp_unregister_widget_control($id);
2197
2197
}
2198
2198
 
2209
2209
 * @return bool True deletion completed and false if user_id is not a number.
2210
2210
 */
2211
2211
function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {
2212
 
        _deprecated_function( __FUNCTION__, '3.0', 'delete_user_meta()' );
 
2212
        _deprecated_function( __FUNCTION__, '3.0.0', 'delete_user_meta()' );
2213
2213
        global $wpdb;
2214
2214
        if ( !is_numeric( $user_id ) )
2215
2215
                return false;
2255
2255
 * @return mixed
2256
2256
 */
2257
2257
function get_usermeta( $user_id, $meta_key = '' ) {
2258
 
        _deprecated_function( __FUNCTION__, '3.0', 'get_user_meta()' );
 
2258
        _deprecated_function( __FUNCTION__, '3.0.0', 'get_user_meta()' );
2259
2259
        global $wpdb;
2260
2260
        $user_id = (int) $user_id;
2261
2261
 
2308
2308
 * @return bool True on successful update, false on failure.
2309
2309
 */
2310
2310
function update_usermeta( $user_id, $meta_key, $meta_value ) {
2311
 
        _deprecated_function( __FUNCTION__, '3.0', 'update_user_meta()' );
 
2311
        _deprecated_function( __FUNCTION__, '3.0.0', 'update_user_meta()' );
2312
2312
        global $wpdb;
2313
2313
        if ( !is_numeric( $user_id ) )
2314
2314
                return false;
2363
2363
 * @return array List of users that are part of that site ID
2364
2364
 */
2365
2365
function get_users_of_blog( $id = '' ) {
2366
 
        _deprecated_function( __FUNCTION__, '3.1', 'get_users()' );
 
2366
        _deprecated_function( __FUNCTION__, '3.1.0', 'get_users()' );
2367
2367
 
2368
2368
        global $wpdb, $blog_id;
2369
2369
        if ( empty($id) )
2383
2383
 * @param bool $add Optional, default is true. Add or remove links. Defaults to true.
2384
2384
 */
2385
2385
function automatic_feed_links( $add = true ) {
2386
 
        _deprecated_function( __FUNCTION__, '3.0', "add_theme_support( 'automatic-feed-links' )" );
 
2386
        _deprecated_function( __FUNCTION__, '3.0.0', "add_theme_support( 'automatic-feed-links' )" );
2387
2387
 
2388
2388
        if ( $add )
2389
2389
                add_theme_support( 'automatic-feed-links' );
2403
2403
 * @return string The author's field from the current author's DB object.
2404
2404
 */
2405
2405
function get_profile( $field, $user = false ) {
2406
 
        _deprecated_function( __FUNCTION__, '3.0', 'get_the_author_meta()' );
 
2406
        _deprecated_function( __FUNCTION__, '3.0.0', 'get_the_author_meta()' );
2407
2407
        if ( $user ) {
2408
2408
                $user = get_user_by( 'login', $user );
2409
2409
                $user = $user->ID;
2422
2422
 * @return int Number of posts the given user has written.
2423
2423
 */
2424
2424
function get_usernumposts( $userid ) {
2425
 
        _deprecated_function( __FUNCTION__, '3.0', 'count_user_posts()' );
 
2425
        _deprecated_function( __FUNCTION__, '3.0.0', 'count_user_posts()' );
2426
2426
        return count_user_posts( $userid );
2427
2427
}
2428
2428
 
2455
2455
 * @return string Fixed text.
2456
2456
 */
2457
2457
function funky_javascript_fix($text) {
2458
 
        _deprecated_function( __FUNCTION__, '3.0' );
 
2458
        _deprecated_function( __FUNCTION__, '3.0.0' );
2459
2459
        // Fixes for browsers' JavaScript bugs.
2460
2460
        global $is_macIE, $is_winIE;
2461
2461
 
2478
2478
 * @return bool Whether the taxonomy exists.
2479
2479
 */
2480
2480
function is_taxonomy( $taxonomy ) {
2481
 
        _deprecated_function( __FUNCTION__, '3.0', 'taxonomy_exists()' );
 
2481
        _deprecated_function( __FUNCTION__, '3.0.0', 'taxonomy_exists()' );
2482
2482
        return taxonomy_exists( $taxonomy );
2483
2483
}
2484
2484
 
2495
2495
 * @return mixed Get the term id or Term Object, if exists.
2496
2496
 */
2497
2497
function is_term( $term, $taxonomy = '', $parent = 0 ) {
2498
 
        _deprecated_function( __FUNCTION__, '3.0', 'term_exists()' );
 
2498
        _deprecated_function( __FUNCTION__, '3.0.0', 'term_exists()' );
2499
2499
        return term_exists( $term, $taxonomy, $parent );
2500
2500
}
2501
2501
 
2512
2512
 * @return bool
2513
2513
 */
2514
2514
function is_plugin_page() {
2515
 
        _deprecated_function( __FUNCTION__, '3.1'  );
 
2515
        _deprecated_function( __FUNCTION__, '3.1.0'  );
2516
2516
 
2517
2517
        global $plugin_page;
2518
2518
 
2535
2535
 * @return bool Always return True
2536
2536
 */
2537
2537
function update_category_cache() {
2538
 
        _deprecated_function( __FUNCTION__, '3.1'  );
 
2538
        _deprecated_function( __FUNCTION__, '3.1.0'  );
2539
2539
 
2540
2540
        return true;
2541
2541
}
2549
2549
 * @return bool
2550
2550
 */
2551
2551
function wp_timezone_supported() {
2552
 
        _deprecated_function( __FUNCTION__, '3.2' );
 
2552
        _deprecated_function( __FUNCTION__, '3.2.0' );
2553
2553
 
2554
2554
        return true;
2555
2555
}
2569
2569
 * @param bool   $extended      Optional. Unused.
2570
2570
 */
2571
2571
function the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2, $extended = true) {
2572
 
        _deprecated_function( __FUNCTION__, '3.3', 'wp_editor()' );
 
2572
        _deprecated_function( __FUNCTION__, '3.3.0', 'wp_editor()' );
2573
2573
 
2574
2574
        wp_editor( $content, $id, array( 'media_buttons' => $media_buttons ) );
2575
2575
}
2584
2584
 * @return array of arrays. The array is indexed by user_id, containing $metavalues object arrays.
2585
2585
 */
2586
2586
function get_user_metavalues($ids) {
2587
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2587
        _deprecated_function( __FUNCTION__, '3.3.0' );
2588
2588
 
2589
2589
        $objects = array();
2590
2590
 
2618
2618
 * @return object|array The now sanitized User Object or Array (will be the same type as $user)
2619
2619
 */
2620
2620
function sanitize_user_object($user, $context = 'display') {
2621
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2621
        _deprecated_function( __FUNCTION__, '3.3.0' );
2622
2622
 
2623
2623
        if ( is_object($user) ) {
2624
2624
                if ( !isset($user->ID) )
2657
2657
 * @return string
2658
2658
 */
2659
2659
function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) {
2660
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2660
        _deprecated_function( __FUNCTION__, '3.3.0' );
2661
2661
 
2662
2662
        $posts = get_boundary_post($in_same_cat, $excluded_categories, $start);
2663
2663
        // If there is no post stop.
2695
2695
 * @param string $excluded_categories Optional. Excluded categories IDs.
2696
2696
 */
2697
2697
function start_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {
2698
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2698
        _deprecated_function( __FUNCTION__, '3.3.0' );
2699
2699
 
2700
2700
        echo get_boundary_post_rel_link($title, $in_same_cat, $excluded_categories, true);
2701
2701
}
2709
2709
 * @return string
2710
2710
 */
2711
2711
function get_index_rel_link() {
2712
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2712
        _deprecated_function( __FUNCTION__, '3.3.0' );
2713
2713
 
2714
2714
        $link = "<link rel='index' title='" . esc_attr( get_bloginfo( 'name', 'display' ) ) . "' href='" . esc_url( user_trailingslashit( get_bloginfo( 'url', 'display' ) ) ) . "' />\n";
2715
2715
        return apply_filters( "index_rel_link", $link );
2722
2722
 * @deprecated 3.3.0
2723
2723
 */
2724
2724
function index_rel_link() {
2725
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2725
        _deprecated_function( __FUNCTION__, '3.3.0' );
2726
2726
 
2727
2727
        echo get_index_rel_link();
2728
2728
}
2737
2737
 * @return string
2738
2738
 */
2739
2739
function get_parent_post_rel_link( $title = '%title' ) {
2740
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2740
        _deprecated_function( __FUNCTION__, '3.3.0' );
2741
2741
 
2742
2742
        if ( ! empty( $GLOBALS['post'] ) && ! empty( $GLOBALS['post']->post_parent ) )
2743
2743
                $post = get_post($GLOBALS['post']->post_parent);
2767
2767
 * @param string $title Optional. Link title format. Default '%title'.
2768
2768
 */
2769
2769
function parent_post_rel_link( $title = '%title' ) {
2770
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2770
        _deprecated_function( __FUNCTION__, '3.3.0' );
2771
2771
 
2772
2772
        echo get_parent_post_rel_link($title);
2773
2773
}
2781
2781
 * @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance.
2782
2782
 */
2783
2783
function wp_admin_bar_dashboard_view_site_menu( $wp_admin_bar ) {
2784
 
        _deprecated_function( __FUNCTION__, '3.3' );
 
2784
        _deprecated_function( __FUNCTION__, '3.3.0' );
2785
2785
 
2786
2786
        $user_id = get_current_user_id();
2787
2787
 
2806
2806
 * @return bool True if the current users belong to $blog_id, false if not.
2807
2807
 */
2808
2808
function is_blog_user( $blog_id = 0 ) {
2809
 
        _deprecated_function( __FUNCTION__, '3.3', 'is_user_member_of_blog()' );
 
2809
        _deprecated_function( __FUNCTION__, '3.3.0', 'is_user_member_of_blog()' );
2810
2810
 
2811
2811
        return is_user_member_of_blog( get_current_user_id(), $blog_id );
2812
2812
}
2818
2818
 * @deprecated 3.4.0 Use error_log()
2819
2819
 * @see error_log()
2820
2820
 *
2821
 
 * @link http://www.php.net/manual/en/function.error-log.php
 
2821
 * @link https://secure.php.net/manual/en/function.error-log.php
2822
2822
 *
2823
2823
 * @param string $filename File name.
2824
2824
 * @param string $mode     Type of access you required to the stream.
2836
2836
 * @deprecated 3.4.0 Use error_log()
2837
2837
 * @see error_log()
2838
2838
 *
2839
 
 * @link http://www.php.net/manual/en/function.error-log.php
 
2839
 * @link https://secure.php.net/manual/en/function.error-log.php
2840
2840
 *
2841
2841
 * @param mixed  $fp     Unused.
2842
2842
 * @param string $string Message to log.
2854
2854
 * @deprecated 3.4.0 Use error_log()
2855
2855
 * @see error_log()
2856
2856
 *
2857
 
 * @link http://www.php.net/manual/en/function.error-log.php
 
2857
 * @link https://secure.php.net/manual/en/function.error-log.php
2858
2858
 *
2859
2859
 * @param mixed $fp Unused.
2860
2860
 */
2876
2876
 * @return array Theme list with theme data.
2877
2877
 */
2878
2878
function get_themes() {
2879
 
        _deprecated_function( __FUNCTION__, '3.4', 'wp_get_themes()' );
 
2879
        _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_themes()' );
2880
2880
 
2881
2881
        global $wp_themes;
2882
2882
        if ( isset( $wp_themes ) )
2907
2907
 * @return array|null Null, if theme name does not exist. Theme data, if exists.
2908
2908
 */
2909
2909
function get_theme( $theme ) {
2910
 
        _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme( $stylesheet )' );
 
2910
        _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme( $stylesheet )' );
2911
2911
 
2912
2912
        $themes = get_themes();
2913
2913
        if ( is_array( $themes ) && array_key_exists( $theme, $themes ) )
2925
2925
 * @return string
2926
2926
 */
2927
2927
function get_current_theme() {
2928
 
        _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme()' );
 
2928
        _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme()' );
2929
2929
 
2930
2930
        if ( $theme = get_option( 'current_theme' ) )
2931
2931
                return $theme;
2946
2946
 * @return string The pre block without paragraph/line-break conversion.
2947
2947
 */
2948
2948
function clean_pre($matches) {
2949
 
        _deprecated_function( __FUNCTION__, '3.4' );
 
2949
        _deprecated_function( __FUNCTION__, '3.4.0' );
2950
2950
 
2951
2951
        if ( is_array($matches) )
2952
2952
                $text = $matches[1] . $matches[2] . "</pre>";
2968
2968
 * @deprecated 3.4.0 Use add_theme_support()
2969
2969
 * @see add_theme_support()
2970
2970
 *
2971
 
 * @param callable $wp_head_callback Call on 'wp_head' action.
 
2971
 * @param callable $wp_head_callback Call on the {@see 'wp_head'} action.
2972
2972
 * @param callable $admin_head_callback Call on custom header administration screen.
2973
2973
 * @param callable $admin_preview_callback Output a custom header image div on the custom header administration screen. Optional.
2974
2974
 */
2975
2975
function add_custom_image_header( $wp_head_callback, $admin_head_callback, $admin_preview_callback = '' ) {
2976
 
        _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support( \'custom-header\', $args )' );
 
2976
        _deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-header\', $args )' );
2977
2977
        $args = array(
2978
2978
                'wp-head-callback'    => $wp_head_callback,
2979
2979
                'admin-head-callback' => $admin_head_callback,
2993
2993
 * @return null|bool Whether support was removed.
2994
2994
 */
2995
2995
function remove_custom_image_header() {
2996
 
        _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-header\' )' );
 
2996
        _deprecated_function( __FUNCTION__, '3.4.0', 'remove_theme_support( \'custom-header\' )' );
2997
2997
        return remove_theme_support( 'custom-header' );
2998
2998
}
2999
2999
 
3004
3004
 * @deprecated 3.4.0 Use add_theme_support()
3005
3005
 * @see add_theme_support()
3006
3006
 *
3007
 
 * @param callable $wp_head_callback Call on 'wp_head' action.
 
3007
 * @param callable $wp_head_callback Call on the {@see 'wp_head'} action.
3008
3008
 * @param callable $admin_head_callback Call on custom background administration screen.
3009
3009
 * @param callable $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional.
3010
3010
 */
3011
3011
function add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' ) {
3012
 
        _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support( \'custom-background\', $args )' );
 
3012
        _deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-background\', $args )' );
3013
3013
        $args = array();
3014
3014
        if ( $wp_head_callback )
3015
3015
                $args['wp-head-callback'] = $wp_head_callback;
3030
3030
 * @return null|bool Whether support was removed.
3031
3031
 */
3032
3032
function remove_custom_background() {
3033
 
        _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support( \'custom-background\' )' );
 
3033
        _deprecated_function( __FUNCTION__, '3.4.0', 'remove_theme_support( \'custom-background\' )' );
3034
3034
        return remove_theme_support( 'custom-background' );
3035
3035
}
3036
3036
 
3045
3045
 * @return array Theme data.
3046
3046
 */
3047
3047
function get_theme_data( $theme_file ) {
3048
 
        _deprecated_function( __FUNCTION__, '3.4', 'wp_get_theme()' );
 
3048
        _deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme()' );
3049
3049
        $theme = new WP_Theme( basename( dirname( $theme_file ) ), dirname( dirname( $theme_file ) ) );
3050
3050
 
3051
3051
        $theme_data = array(
3082
3082
 * @param array $pages list of page objects
3083
3083
 */
3084
3084
function update_page_cache( &$pages ) {
3085
 
        _deprecated_function( __FUNCTION__, '3.4', 'update_post_cache()' );
 
3085
        _deprecated_function( __FUNCTION__, '3.4.0', 'update_post_cache()' );
3086
3086
 
3087
3087
        update_post_cache( $pages );
3088
3088
}
3100
3100
 * @param int $id Page ID to clean
3101
3101
 */
3102
3102
function clean_page_cache( $id ) {
3103
 
        _deprecated_function( __FUNCTION__, '3.4', 'clean_post_cache()' );
 
3103
        _deprecated_function( __FUNCTION__, '3.4.0', 'clean_post_cache()' );
3104
3104
 
3105
3105
        clean_post_cache( $id );
3106
3106
}
3132
3132
 * @param int $post_id An optional post ID.
3133
3133
 */
3134
3134
function sticky_class( $post_id = null ) {
3135
 
        _deprecated_function( __FUNCTION__, '3.5', 'post_class()' );
 
3135
        _deprecated_function( __FUNCTION__, '3.5.0', 'post_class()' );
3136
3136
        if ( is_sticky( $post_id ) )
3137
3137
                echo ' sticky';
3138
3138
}
3150
3150
 * @param WP_Post &$post Post object, passed by reference (unused).
3151
3151
 */
3152
3152
function _get_post_ancestors( &$post ) {
3153
 
        _deprecated_function( __FUNCTION__, '3.5' );
 
3153
        _deprecated_function( __FUNCTION__, '3.5.0' );
3154
3154
}
3155
3155
 
3156
3156
/**
3164
3164
 * @return resource The resulting image resource on success, Error string on failure.
3165
3165
 */
3166
3166
function wp_load_image( $file ) {
3167
 
        _deprecated_function( __FUNCTION__, '3.5', 'wp_get_image_editor()' );
 
3167
        _deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );
3168
3168
 
3169
3169
        if ( is_numeric( $file ) )
3170
3170
                $file = get_attached_file( $file );
3175
3175
        if ( ! function_exists('imagecreatefromstring') )
3176
3176
                return __('The GD image library is not installed.');
3177
3177
 
3178
 
        // Set artificially high because GD uses uncompressed images in memory
3179
 
        @ini_set( 'memory_limit', apply_filters( 'image_memory_limit', WP_MAX_MEMORY_LIMIT ) );
 
3178
        // Set artificially high because GD uses uncompressed images in memory.
 
3179
        wp_raise_memory_limit( 'image' );
 
3180
 
3180
3181
        $image = imagecreatefromstring( file_get_contents( $file ) );
3181
3182
 
3182
3183
        if ( !is_resource( $image ) )
3210
3211
 * @return mixed WP_Error on failure. String with new destination path.
3211
3212
 */
3212
3213
function image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $dest_path = null, $jpeg_quality = 90 ) {
3213
 
        _deprecated_function( __FUNCTION__, '3.5', 'wp_get_image_editor()' );
 
3214
        _deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );
3214
3215
 
3215
3216
        $editor = wp_get_image_editor( $file );
3216
3217
        if ( is_wp_error( $editor ) )
3245
3246
 * @return WP_Post|null Post object or array holding post contents and information
3246
3247
 */
3247
3248
function wp_get_single_post( $postid = 0, $mode = OBJECT ) {
3248
 
        _deprecated_function( __FUNCTION__, '3.5', 'get_post()' );
 
3249
        _deprecated_function( __FUNCTION__, '3.5.0', 'get_post()' );
3249
3250
        return get_post( $postid, $mode );
3250
3251
}
3251
3252
 
3261
3262
 * @return bool False if does not authenticate, true if username and password authenticates.
3262
3263
 */
3263
3264
function user_pass_ok($user_login, $user_pass) {
3264
 
        _deprecated_function( __FUNCTION__, '3.5', 'wp_authenticate()' );
 
3265
        _deprecated_function( __FUNCTION__, '3.5.0', 'wp_authenticate()' );
3265
3266
        $user = wp_authenticate( $user_login, $user_pass );
3266
3267
        if ( is_wp_error( $user ) )
3267
3268
                return false;
3288
3289
 * @return bool
3289
3290
 */
3290
3291
function gd_edit_image_support($mime_type) {
3291
 
        _deprecated_function( __FUNCTION__, '3.5', 'wp_image_editor_supports()' );
 
3292
        _deprecated_function( __FUNCTION__, '3.5.0', 'wp_image_editor_supports()' );
3292
3293
 
3293
3294
        if ( function_exists('imagetypes') ) {
3294
3295
                switch( $mime_type ) {
3323
3324
 * @return string A shorthand byte value.
3324
3325
 */
3325
3326
function wp_convert_bytes_to_hr( $bytes ) {
3326
 
        _deprecated_function( __FUNCTION__, '3.6', 'size_format()' );
 
3327
        _deprecated_function( __FUNCTION__, '3.6.0', 'size_format()' );
3327
3328
 
3328
 
        $units = array( 0 => 'B', 1 => 'kB', 2 => 'MB', 3 => 'GB', 4 => 'TB' );
 
3329
        $units = array( 0 => 'B', 1 => 'KB', 2 => 'MB', 3 => 'GB', 4 => 'TB' );
3329
3330
        $log   = log( $bytes, KB_IN_BYTES );
3330
3331
        $power = (int) $log;
3331
3332
        $size  = pow( KB_IN_BYTES, $log - $power );
3351
3352
 * @return string Trimmed search terms.
3352
3353
 */
3353
3354
function _search_terms_tidy( $t ) {
3354
 
        _deprecated_function( __FUNCTION__, '3.7' );
 
3355
        _deprecated_function( __FUNCTION__, '3.7.0' );
3355
3356
        return trim( $t, "\"'\n\r " );
3356
3357
}
3357
3358
 
3368
3369
 */
3369
3370
function rich_edit_exists() {
3370
3371
        global $wp_rich_edit_exists;
3371
 
        _deprecated_function( __FUNCTION__, '3.9' );
 
3372
        _deprecated_function( __FUNCTION__, '3.9.0' );
3372
3373
 
3373
3374
        if ( ! isset( $wp_rich_edit_exists ) )
3374
3375
                $wp_rich_edit_exists = file_exists( ABSPATH . WPINC . '/js/tinymce/tinymce.js' );
3402
3403
 * @return string The very same text.
3403
3404
 */
3404
3405
function format_to_post( $content ) {
3405
 
        _deprecated_function( __FUNCTION__, '3.9' );
 
3406
        _deprecated_function( __FUNCTION__, '3.9.0' );
3406
3407
        return $content;
3407
3408
}
3408
3409
 
3417
3418
 * @return string text, safe for inclusion in LIKE query.
3418
3419
 */
3419
3420
function like_escape($text) {
3420
 
        _deprecated_function( __FUNCTION__, '4.0', 'wpdb::esc_like()' );
 
3421
        _deprecated_function( __FUNCTION__, '4.0.0', 'wpdb::esc_like()' );
3421
3422
        return str_replace( array( "%", "_" ), array( "\\%", "\\_" ), $text );
3422
3423
}
3423
3424
 
3434
3435
 * @return bool Whether SSL access is available.
3435
3436
 */
3436
3437
function url_is_accessable_via_ssl( $url ) {
3437
 
        _deprecated_function( __FUNCTION__, '4.0' );
 
3438
        _deprecated_function( __FUNCTION__, '4.0.0' );
3438
3439
 
3439
3440
        $response = wp_remote_get( set_url_scheme( $url, 'https' ) );
3440
3441
 
3458
3459
 * @deprecated 4.3.0
3459
3460
 */
3460
3461
function preview_theme() {
3461
 
        _deprecated_function( __FUNCTION__, '4.3' );
 
3462
        _deprecated_function( __FUNCTION__, '4.3.0' );
3462
3463
}
3463
3464
 
3464
3465
/**
3471
3472
 * @return string
3472
3473
 */
3473
3474
function _preview_theme_template_filter() {
3474
 
        _deprecated_function( __FUNCTION__, '4.3' );
 
3475
        _deprecated_function( __FUNCTION__, '4.3.0' );
3475
3476
        return '';
3476
3477
}
3477
3478
 
3485
3486
 * @return string
3486
3487
 */
3487
3488
function _preview_theme_stylesheet_filter() {
3488
 
        _deprecated_function( __FUNCTION__, '4.3' );
 
3489
        _deprecated_function( __FUNCTION__, '4.3.0' );
3489
3490
        return '';
3490
3491
}
3491
3492
 
3500
3501
 * @return string
3501
3502
 */
3502
3503
function preview_theme_ob_filter( $content ) {
3503
 
        _deprecated_function( __FUNCTION__, '4.3' );
 
3504
        _deprecated_function( __FUNCTION__, '4.3.0' );
3504
3505
        return $content;
3505
3506
}
3506
3507
 
3517
3518
 * @return string
3518
3519
 */
3519
3520
function preview_theme_ob_filter_callback( $matches ) {
3520
 
        _deprecated_function( __FUNCTION__, '4.3' );
 
3521
        _deprecated_function( __FUNCTION__, '4.3.0' );
3521
3522
        return '';
3522
3523
}
3523
3524
 
3524
3525
/**
3525
3526
 * Formats text for the rich text editor.
3526
3527
 *
3527
 
 * The filter 'richedit_pre' is applied here. If $text is empty the filter will
 
3528
 * The {@see 'richedit_pre'} filter is applied here. If $text is empty the filter will
3528
3529
 * be applied to an empty string.
3529
3530
 *
3530
3531
 * @since 2.0.0
3534
3535
 * @return string The formatted text after filter is applied.
3535
3536
 */
3536
3537
function wp_richedit_pre($text) {
3537
 
        _deprecated_function( __FUNCTION__, '4.3', 'format_for_editor()' );
 
3538
        _deprecated_function( __FUNCTION__, '4.3.0', 'format_for_editor()' );
3538
3539
 
3539
3540
        if ( empty( $text ) ) {
3540
3541
                /**
3541
 
                 * Filter text returned for the rich text editor.
 
3542
                 * Filters text returned for the rich text editor.
3542
3543
                 *
3543
3544
                 * This filter is first evaluated, and the value returned, if an empty string
3544
3545
                 * is passed to wp_richedit_pre(). If an empty string is passed, it results
3567
3568
 * Formats text for the HTML editor.
3568
3569
 *
3569
3570
 * Unless $output is empty it will pass through htmlspecialchars before the
3570
 
 * 'htmledit_pre' filter is applied.
 
3571
 * {@see 'htmledit_pre'} filter is applied.
3571
3572
 *
3572
3573
 * @since 2.5.0
3573
3574
 * @deprecated 4.3.0 Use format_for_editor()
3577
3578
 * @return string Formatted text after filter applied.
3578
3579
 */
3579
3580
function wp_htmledit_pre($output) {
3580
 
        _deprecated_function( __FUNCTION__, '4.3', 'format_for_editor()' );
 
3581
        _deprecated_function( __FUNCTION__, '4.3.0', 'format_for_editor()' );
3581
3582
 
3582
3583
        if ( !empty($output) )
3583
3584
                $output = htmlspecialchars($output, ENT_NOQUOTES, get_option( 'blog_charset' ) ); // convert only < > &
3584
3585
 
3585
3586
        /**
3586
 
         * Filter the text before it is formatted for the HTML editor.
 
3587
         * Filters the text before it is formatted for the HTML editor.
3587
3588
         *
3588
3589
         * @since 2.5.0
3589
3590
         * @deprecated 4.3.0
3604
3605
 * @return string|false
3605
3606
 */
3606
3607
function post_permalink( $post_id = 0 ) {
3607
 
        _deprecated_function( __FUNCTION__, '4.4', 'get_permalink()' );
 
3608
        _deprecated_function( __FUNCTION__, '4.4.0', 'get_permalink()' );
3608
3609
 
3609
3610
        return get_permalink( $post_id );
3610
3611
}
3626
3627
 * @return bool|string False on failure and string of headers if HEAD request.
3627
3628
 */
3628
3629
function wp_get_http( $url, $file_path = false, $red = 1 ) {
3629
 
        _deprecated_function( __FUNCTION__, '4.4', 'WP_Http' );
 
3630
        _deprecated_function( __FUNCTION__, '4.4.0', 'WP_Http' );
3630
3631
 
3631
3632
        @set_time_limit( 60 );
3632
3633
 
3680
3681
 * @return bool True if forced, false if not forced.
3681
3682
 */
3682
3683
function force_ssl_login( $force = null ) {
3683
 
        _deprecated_function( __FUNCTION__, '4.4', 'force_ssl_admin()' );
 
3684
        _deprecated_function( __FUNCTION__, '4.4.0', 'force_ssl_admin()' );
3684
3685
        return force_ssl_admin( $force );
3685
3686
}
3686
3687
 
3693
3694
 * @return string Full path to comments popup template file.
3694
3695
 */
3695
3696
function get_comments_popup_template() {
3696
 
        _deprecated_function( __FUNCTION__, '4.5' );
 
3697
        _deprecated_function( __FUNCTION__, '4.5.0' );
3697
3698
 
3698
3699
        return '';
3699
3700
}
3707
3708
 * @return bool
3708
3709
 */
3709
3710
function is_comments_popup() {
3710
 
        _deprecated_function( __FUNCTION__, '4.5' );
 
3711
        _deprecated_function( __FUNCTION__, '4.5.0' );
3711
3712
 
3712
3713
        return false;
3713
3714
}
3719
3720
 * @deprecated 4.5.0
3720
3721
 */
3721
3722
function comments_popup_script() {
3722
 
        _deprecated_function( __FUNCTION__, '4.5' );
 
3723
        _deprecated_function( __FUNCTION__, '4.5.0' );
3723
3724
}
3724
3725
 
3725
3726
/**
3732
3733
 * @return string Content that has filtered links.
3733
3734
 */
3734
3735
function popuplinks( $text ) {
3735
 
        _deprecated_function( __FUNCTION__, '4.5' );
 
3736
        _deprecated_function( __FUNCTION__, '4.5.0' );
3736
3737
        $text = preg_replace('/<a (.+?)>/i', "<a $1 target='_blank' rel='external'>", $text);
3737
3738
        return $text;
3738
3739
}
3739
3740
 
3740
3741
/**
3741
 
 * Returns the base URL of the uploads directory.
3742
 
 * Note: this function will be removed in 4.6.
3743
 
 *
3744
 
 * @ignore
3745
 
 * @since 4.4.0
3746
 
 * @access private
3747
 
 * @deprecated 4.5.0 Use wp_get_upload_dir()
3748
 
 * @see wp_get_upload_dir()
3749
 
 *
3750
 
 * @return string The base URL.
 
3742
 * The Google Video embed handler callback.
 
3743
 *
 
3744
 * Deprecated function that previously assisted in turning Google Video URLs
 
3745
 * into embeds but that service has since been shut down.
 
3746
 *
 
3747
 * @since 2.9.0
 
3748
 * @deprecated 4.6.0
 
3749
 *
 
3750
 * @return string An empty string.
3751
3751
 */
3752
 
function _wp_upload_dir_baseurl() {
3753
 
        _deprecated_function( __FUNCTION__, '4.5', 'wp_get_upload_dir()' );
3754
 
        $upload_dir = wp_get_upload_dir();
3755
 
        return $upload_dir['baseurl'];
 
3752
function wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr ) {
 
3753
        _deprecated_function( __FUNCTION__, '4.6.0' );
 
3754
 
 
3755
        return '';
3756
3756
}