wpseek.com
A WordPress-centric search engine for devs and theme authors



get_linksbyname › WordPress Function

Since0.71
Deprecated2.1.0
› 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 )
Parameters: (10)
  • (string) $cat_name Optional. The category name to use. If no match is found, uses all. Default &#039;noname&#039;.
    Required: No
    Default: "noname"
  • (string) $before Optional. The HTML to output before the link. Default empty.
    Required: No
    Default: (empty)
  • (string) $after Optional. The HTML to output after the link. Default &#039;&lt;br /&gt;&#039;.
    Required: No
    Default: '<br />'
  • (string) $between Optional. The HTML to output between the link/image and its description. Not used if no image or $show_images is true. Default &#039; &#039;.
    Required: No
    Default: " "
  • (bool) $show_images Optional. Whether to show images (if defined). Default true.
    Required: No
    Default: true
  • (string) $orderby Optional. The order to output the links. E.g. &#039;id&#039;, &#039;name&#039;, &#039;url&#039;, &#039;description&#039;, &#039;rating&#039;, or &#039;owner&#039;. Default &#039;id&#039;. If you start the name with an underscore, the order will be reversed. Specifying &#039;rand&#039; as the order will return links in a random order.
    Required: No
    Default: 'id'
  • (bool) $show_description Optional. Whether to show the description if show_images=false/not defined. Default true.
    Required: No
    Default: true
  • (bool) $show_rating Optional. Show rating stars/chars. Default false.
    Required: No
    Default: false
  • (int) $limit Optional. Limit to X entries. If not specified, all entries are shown. Default -1.
    Required: No
    Default: -1
  • (int) $show_updated Optional. Whether to show last updated timestamp. Default 0.
    Required: No
    Default: —
See:
Defined at:
Codex:

Gets the links associated with category $cat_name.



Related Functions: wp_get_linksbyname, get_linkobjectsbyname, get_linkcatname, get_links, get_linksbyname_withrating

Source 

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);
}