On this page
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 )
This function has been deprecated. Use get_bookmarks() instead.
Gets the links associated with category $cat_name.
Description
See also
Parameters
$cat_namestring Optional-
The category name to use. If no match is found, uses all.
Default'noname'.Default:
"noname" $beforestring Optional-
The HTML to output before the link.
Default:
'' $afterstring Optional-
The HTML to output after the link. Default
<br />.Default:
'<br />' $betweenstring Optional-
The HTML to output between the link/image and its description.
Not used if no image or $show_images is true. Default ' '.Default:
" " $show_imagesbool Optional-
Whether to show images (if defined).
Default:
true $orderbystring Optional-
The order to output the links. E.g.
'id','name','url','description','rating', or'owner'. Default'id'.
If you start the name with an underscore, the order will be reversed.
Specifying'rand'as the order will return links in a random order.Default:
'id' $show_descriptionbool Optional-
Whether to show the description if show_images=false/not defined.
Default:
true $show_ratingbool Optional-
Show rating stars/chars.
Default:
false $limitint Optional-
Limit to X entries. If not specified, all entries are shown.
Default:
-1 $show_updatedint Optional-
Whether to show last updated timestamp. Default 0.
Source
File: wp-includes/deprecated.php. View all references
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__, '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);
}
Related
Uses
| Uses | Description |
|---|---|
| get_links() wp-includes/deprecated.php | Gets the links associated with category by ID. |
| get_term_by() wp-includes/taxonomy.php | Gets all term data from database by term field and data. |
| _deprecated_function() wp-includes/functions.php | Marks a function as deprecated and inform when it has been used. |
Used By
| Used By | Description |
|---|---|
| get_linksbyname_withrating() wp-includes/deprecated.php | Gets the links associated with category ‘cat_name’ and display rating stars/chars. |
Changelog
| Version | Description |
|---|---|
| 2.1.0 | Use get_bookmarks() |
| 0.71 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_linksbyname