diff --git a/src/wp-admin/edit-link-form.php b/src/wp-admin/edit-link-form.php index 33e14da3fda4f..8fdc95e2556b9 100644 --- a/src/wp-admin/edit-link-form.php +++ b/src/wp-admin/edit-link-form.php @@ -11,6 +11,8 @@ exit; } +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + if ( ! empty( $link_id ) ) { /* translators: %s: URL to Links screen. */ $heading = sprintf( __( 'Links / Edit Link' ), 'link-manager.php' ); diff --git a/src/wp-admin/includes/bookmark.php b/src/wp-admin/includes/bookmark.php index c64bac144c588..05bc61ce403f3 100644 --- a/src/wp-admin/includes/bookmark.php +++ b/src/wp-admin/includes/bookmark.php @@ -10,10 +10,13 @@ * Adds a link using values provided in $_POST. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @return int The link ID on success. The value 0 on failure. */ function add_link() { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + return edit_link(); } @@ -21,11 +24,14 @@ function add_link() { * Updates or inserts a link using values provided in $_POST. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int $link_id Optional. ID of the link to edit. Default 0. * @return int The link ID on success. The value 0 on failure. */ function edit_link( $link_id = 0 ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + if ( ! current_user_can( 'manage_links' ) ) { wp_die( '

' . __( 'You need a higher level of permission.' ) . '

' . @@ -54,10 +60,13 @@ function edit_link( $link_id = 0 ) { * Retrieves the default link for editing. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @return stdClass Default link object. */ function get_default_link_to_edit() { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $link = new stdClass(); if ( isset( $_GET['linkurl'] ) ) { $link->link_url = esc_url( wp_unslash( $_GET['linkurl'] ) ); @@ -80,6 +89,7 @@ function get_default_link_to_edit() { * Deletes a specified link from the database. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @global wpdb $wpdb WordPress database abstraction object. * @@ -87,6 +97,8 @@ function get_default_link_to_edit() { * @return true Always true. */ function wp_delete_link( $link_id ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + global $wpdb; /** * Fires before a link is deleted. @@ -119,11 +131,14 @@ function wp_delete_link( $link_id ) { * Retrieves the link category IDs associated with the link specified. * * @since 2.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int $link_id Link ID to look up. * @return int[] The IDs of the requested link's categories. */ function wp_get_link_cats( $link_id = 0 ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $cats = wp_get_object_terms( $link_id, 'link_category', array( 'fields' => 'ids' ) ); return array_unique( $cats ); } @@ -132,11 +147,14 @@ function wp_get_link_cats( $link_id = 0 ) { * Retrieves link data based on its ID. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int|stdClass $link Link ID or object to retrieve. * @return object Link object for editing. */ function get_link_to_edit( $link ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + return get_bookmark( $link, OBJECT, 'edit' ); } @@ -147,6 +165,7 @@ function get_link_to_edit( $link ) { * and finally saves the link. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @global wpdb $wpdb WordPress database abstraction object. * @@ -172,6 +191,8 @@ function get_link_to_edit( $link ) { * @return int|WP_Error The link ID on success. The value 0 or WP_Error on failure. */ function wp_insert_link( $linkdata, $wp_error = false ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + global $wpdb; $defaults = array( @@ -271,11 +292,14 @@ function wp_insert_link( $linkdata, $wp_error = false ) { * Updates link with the specified link categories. * * @since 2.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int $link_id ID of the link to update. * @param int[] $link_categories Array of link category IDs to add the link to. */ function wp_set_link_cats( $link_id = 0, $link_categories = array() ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + // If $link_categories isn't already an array, make it one: if ( ! is_array( $link_categories ) || 0 === count( $link_categories ) ) { $link_categories = array( get_option( 'default_link_category' ) ); @@ -293,11 +317,14 @@ function wp_set_link_cats( $link_id = 0, $link_categories = array() ) { * Updates a link in the database. * * @since 2.0.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param array $linkdata Link data to update. See wp_insert_link() for accepted arguments. * @return int The updated link ID on success. The value 0 on failure. */ function wp_update_link( $linkdata ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $link_id = (int) $linkdata['link_id']; $link = get_bookmark( $link_id, ARRAY_A ); diff --git a/src/wp-admin/includes/class-wp-links-list-table.php b/src/wp-admin/includes/class-wp-links-list-table.php index ae1f50175c35b..2b1d57f6123a5 100644 --- a/src/wp-admin/includes/class-wp-links-list-table.php +++ b/src/wp-admin/includes/class-wp-links-list-table.php @@ -20,12 +20,15 @@ class WP_Links_List_Table extends WP_List_Table { * Constructor. * * @since 3.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @see WP_List_Table::__construct() for more information on default arguments. * * @param array $args An associative array of arguments. */ public function __construct( $args = array() ) { + _deprecated_class( __CLASS__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + parent::__construct( array( 'plural' => 'bookmarks', diff --git a/src/wp-admin/includes/template.php b/src/wp-admin/includes/template.php index 418bfd7def697..bbb32dc28acf9 100644 --- a/src/wp-admin/includes/template.php +++ b/src/wp-admin/includes/template.php @@ -261,10 +261,13 @@ function wp_popular_terms_checklist( $taxonomy, $default_term = 0, $number = 10, * Outputs a link category checklist element. * * @since 2.5.1 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int $link_id Optional. The link ID. Default 0. */ function wp_link_category_checklist( $link_id = 0 ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $default = 1; $checked_categories = array(); diff --git a/src/wp-admin/link-add.php b/src/wp-admin/link-add.php index c99630990cfbe..b9c4c6d1800b8 100644 --- a/src/wp-admin/link-add.php +++ b/src/wp-admin/link-add.php @@ -9,6 +9,8 @@ /** Load WordPress Administration Bootstrap */ require_once __DIR__ . '/admin.php'; +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + if ( ! current_user_can( 'manage_links' ) ) { wp_die( __( 'Sorry, you are not allowed to add links to this site.' ) ); } diff --git a/src/wp-admin/link-manager.php b/src/wp-admin/link-manager.php index 2748bf8a2a56c..70c282da66bec 100644 --- a/src/wp-admin/link-manager.php +++ b/src/wp-admin/link-manager.php @@ -8,6 +8,9 @@ /** Load WordPress Administration Bootstrap */ require_once __DIR__ . '/admin.php'; + +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + if ( ! current_user_can( 'manage_links' ) ) { wp_die( __( 'Sorry, you are not allowed to edit the links for this site.' ) ); } diff --git a/src/wp-admin/link-parse-opml.php b/src/wp-admin/link-parse-opml.php index 6e35780b37957..6009962c25cad 100644 --- a/src/wp-admin/link-parse-opml.php +++ b/src/wp-admin/link-parse-opml.php @@ -11,6 +11,8 @@ exit; } +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + /** * @global string $opml */ diff --git a/src/wp-admin/link.php b/src/wp-admin/link.php index 36a023a9c877e..f53c4025d7d52 100644 --- a/src/wp-admin/link.php +++ b/src/wp-admin/link.php @@ -12,6 +12,8 @@ /** Load WordPress Administration Bootstrap */ require_once __DIR__ . '/admin.php'; +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + $action = ! empty( $_REQUEST['action'] ) ? sanitize_text_field( $_REQUEST['action'] ) : ''; $cat_id = ! empty( $_REQUEST['cat_id'] ) ? absint( $_REQUEST['cat_id'] ) : 0; $link_id = ! empty( $_REQUEST['link_id'] ) ? absint( $_REQUEST['link_id'] ) : 0; diff --git a/src/wp-includes/bookmark-template.php b/src/wp-includes/bookmark-template.php index 893494a7e92cd..816485741cc46 100644 --- a/src/wp-includes/bookmark-template.php +++ b/src/wp-includes/bookmark-template.php @@ -165,6 +165,7 @@ function _walk_bookmarks( $bookmarks, $args = '' ) { * display for only the 'title_li' string and only if 'title_li' is not empty. * * @since 2.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @see _walk_bookmarks() * @@ -209,6 +210,8 @@ function _walk_bookmarks( $bookmarks, $args = '' ) { * @return void|string Void if 'echo' argument is true, HTML list of bookmarks if 'echo' is false. */ function wp_list_bookmarks( $args = '' ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $defaults = array( 'orderby' => 'name', 'order' => 'ASC', diff --git a/src/wp-includes/bookmark.php b/src/wp-includes/bookmark.php index 9e44d781909ed..19b6a54bb50b3 100644 --- a/src/wp-includes/bookmark.php +++ b/src/wp-includes/bookmark.php @@ -10,6 +10,7 @@ * Retrieves bookmark data. * * @since 2.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @global object $link Current link object. * @global wpdb $wpdb WordPress database abstraction object. @@ -22,6 +23,8 @@ * @return array|object|null Type returned depends on $output value. */ function get_bookmark( $bookmark, $output = OBJECT, $filter = 'raw' ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + global $wpdb; if ( empty( $bookmark ) ) { @@ -69,6 +72,7 @@ function get_bookmark( $bookmark, $output = OBJECT, $filter = 'raw' ) { * Retrieves single bookmark data item or field. * * @since 2.3.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param string $field The name of the data field to return. * @param int $bookmark The bookmark ID to get field. @@ -76,6 +80,8 @@ function get_bookmark( $bookmark, $output = OBJECT, $filter = 'raw' ) { * @return string|WP_Error */ function get_bookmark_field( $field, $bookmark, $context = 'display' ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $bookmark = (int) $bookmark; $bookmark = get_bookmark( $bookmark ); @@ -102,6 +108,7 @@ function get_bookmark_field( $field, $bookmark, $context = 'display' ) { * results will be stored to the cache. * * @since 2.1.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @global wpdb $wpdb WordPress database abstraction object. * @@ -135,6 +142,8 @@ function get_bookmark_field( $field, $bookmark, $context = 'display' ) { * @return object[] List of bookmark row objects. */ function get_bookmarks( $args = '' ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + global $wpdb; $defaults = array( @@ -327,12 +336,15 @@ function get_bookmarks( $args = '' ) { * Sanitizes all bookmark fields. * * @since 2.3.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param stdClass|array $bookmark Bookmark row. * @param string $context Optional. How to filter the fields. Default 'display'. * @return stdClass|array Same type as $bookmark but with fields sanitized. */ function sanitize_bookmark( $bookmark, $context = 'display' ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $fields = array( 'link_id', 'link_url', @@ -389,6 +401,7 @@ function sanitize_bookmark( $bookmark, $context = 'display' ) { * and is passed the `$value`, `$bookmark_id`, and `$context`, respectively. * * @since 2.3.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param string $field The bookmark field. * @param mixed $value The bookmark field value. @@ -398,6 +411,8 @@ function sanitize_bookmark( $bookmark, $context = 'display' ) { * @return mixed The filtered value. */ function sanitize_bookmark_field( $field, $value, $bookmark_id, $context ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $int_fields = array( 'link_id', 'link_rating' ); if ( in_array( $field, $int_fields, true ) ) { $value = (int) $value; @@ -462,10 +477,13 @@ function sanitize_bookmark_field( $field, $value, $bookmark_id, $context ) { * Deletes the bookmark cache. * * @since 2.7.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int $bookmark_id Bookmark ID. */ function clean_bookmark_cache( $bookmark_id ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + wp_cache_delete( $bookmark_id, 'bookmark' ); wp_cache_delete( 'get_bookmarks', 'bookmark' ); clean_object_term_cache( $bookmark_id, 'link' ); diff --git a/src/wp-includes/link-template.php b/src/wp-includes/link-template.php index b50328793857e..fbdb5e6c0ad60 100644 --- a/src/wp-includes/link-template.php +++ b/src/wp-includes/link-template.php @@ -1673,11 +1673,14 @@ function edit_comment_link( $text = null, $before = '', $after = '' ) { * Displays the edit bookmark link. * * @since 2.7.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param int|stdClass $link Optional. Bookmark ID. Default is the ID of the current bookmark. * @return string|null The edit bookmark link URL. */ function get_edit_bookmark_link( $link = 0 ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $link = get_bookmark( $link ); if ( ! current_user_can( 'manage_links' ) ) { @@ -1701,6 +1704,7 @@ function get_edit_bookmark_link( $link = 0 ) { * Displays the edit bookmark link anchor content. * * @since 2.7.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. * * @param string $link Optional. Anchor text. If empty, default is 'Edit This'. Default empty. * @param string $before Optional. Display before edit link. Default empty. @@ -1708,6 +1712,8 @@ function get_edit_bookmark_link( $link = 0 ) { * @param int $bookmark Optional. Bookmark ID. Default is the current bookmark. */ function edit_bookmark_link( $link = '', $before = '', $after = '', $bookmark = null ) { + _deprecated_function( __FUNCTION__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $bookmark = get_bookmark( $bookmark ); if ( ! current_user_can( 'manage_links' ) ) { diff --git a/src/wp-includes/widgets/class-wp-widget-links.php b/src/wp-includes/widgets/class-wp-widget-links.php index 6e9c3e569437d..1d70856790d52 100644 --- a/src/wp-includes/widgets/class-wp-widget-links.php +++ b/src/wp-includes/widgets/class-wp-widget-links.php @@ -20,8 +20,11 @@ class WP_Widget_Links extends WP_Widget { * Sets up a new Links widget instance. * * @since 2.8.0 + * @deprecated 7.2.0 Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead. */ public function __construct() { + _deprecated_class( __CLASS__, '7.2.0', 'the WP Links plugin (https://github.com/georgestephanis/wp-links)' ); + $widget_ops = array( 'description' => __( 'Your blogroll' ), 'customize_selective_refresh' => true, diff --git a/src/wp-links-opml.php b/src/wp-links-opml.php index 51ef95bd1ac8f..2d69741233731 100644 --- a/src/wp-links-opml.php +++ b/src/wp-links-opml.php @@ -14,6 +14,8 @@ require_once __DIR__ . '/wp-load.php'; +_deprecated_file( basename( __FILE__ ), '7.2.0', '', __( 'The Link Manager is deprecated. Use the WP Links plugin (https://github.com/georgestephanis/wp-links) instead.' ) ); + header( 'Content-Type: text/xml; charset=' . get_option( 'blog_charset' ), true ); $link_cat = ''; if ( ! empty( $_GET['link_cat'] ) ) {