get_linksbyname

函数


get_linksbyname ( $cat_name = "noname", $before = '', $after = '
', $between = " ", $show_images = true, $orderby = 'id', $show_description = true, $show_rating = false, $limit = -1, $show_updated = 0 )
参数
  • (string)
    $cat_name
    Optional. The category name to use. If no match is found, uses all. Default ‘noname’.
    Required:
    Default: “noname”
  • (string)
    $before
    Optional. The HTML to output before the link. Default empty.
    Required:
    Default: (empty)
  • (string)
    $after
    Optional. The HTML to output after the link. Default ‘
    ‘.
    Required:
    Default:
  • (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 ‘ ‘.
    Required:
    Default: ” ”
  • (bool)
    $show_images
    Optional. Whether to show images (if defined). Default true.
    Required:
    Default: true
  • (string)
    $orderby
    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.
    Required:
    Default: ‘id’
  • (bool)
    $show_description
    Optional. Whether to show the description if show_images=false/not defined. Default true.
    Required:
    Default: true
  • (bool)
    $show_rating
    Optional. Show rating stars/chars. Default false.
    Required:
    Default: false
  • (int)
    $limit
    Optional. Limit to X entries. If not specified, all entries are shown. Default -1.
    Required:
    Default: -1
  • (int)
    $show_updated
    Optional. Whether to show last updated timestamp. Default 0.
    Required:
相关
  • get_bookmarks()
定义位置
  • wp-includes/deprecated.php
    , line 400
引入
0.71
弃用
2.1.0

Gets the links associated with category $cat_name.

function get_linksbyname($cat_name = "noname", $before = '', $after = '
', $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); }