This function has been deprecated. Use get_bookmarks() instead.
get_linksbyname( string $cat_name = "noname", string $before = '', string $after = '<br>', string $between = " ", bool $show_images = true, string $orderby = 'id', bool $show_description = true, bool $show_rating = false, int $limit = -1, int $show_updated )
Gets the links associated with category $cat_name.
Description
See also
Parameters
- $cat_name
-
(Optional) The category name to use. If no match is found, uses all.<br> Default 'noname'.
Default value: "noname"
- $before
-
(Optional) The HTML to output before the link.
Default value: ''
- $after
-
(Optional) The HTML to output after the link. Default
<br>
.Default value: '<br>'
- $between
-
(Optional) The HTML to output between the link/image and its description.<br> Not used if no image or $show_images is true. Default ' '.
Default value: " "
- $show_images
-
(Optional) Whether to show images (if defined).
Default value: true
- $orderby
-
(Optional) The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. Default 'id'.<br> If you start the name with an underscore, the order will be reversed.<br> Specifying 'rand' as the order will return links in a random order.
Default value: 'id'
- $show_description
-
(Optional) Whether to show the description if show_images=false/not defined.<br>
Default value: true
- $show_rating
-
(Optional) Show rating stars/chars.
Default value: false
- $limit
-
(Optional) Limit to X entries. If not specified, all entries are shown.<br>
Default value: -1
- $show_updated
-
(Optional) Whether to show last updated timestamp. Default 0.
Source
File: wp-includes/deprecated.php
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
$show_description = true, $show_rating = false,
$limit = -1, $show_updated = 0) {
_deprecated_function( __FUNCTION__, 'WP-2.1.0', 'get_bookmarks()' );
$cat_id = -1;
$cat = get_term_by('name', $cat_name, 'link_category');
if ( $cat )
$cat_id = $cat->term_id;
get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated);
}
Changelog
Version | Description |
---|---|
2.1.0 | Use get_bookmarks() |
0.71 | Introduced. This function has been deprecated. Use get_bookmarks() instead. |