WordPress:Template Tags/wp get linksbyname

---

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists.

---

描述

显示与命名后的链接类别相关的链接。这个标签使用了你在链接管理器中规定的设置。归于在标签的参数内控制你的链接的格式和显示方式，请看看get_linksbyname()。

取代

wp_list_bookmarks().

用法

%%% <?php wp_get_linksbyname('category','arguments'); ?> %%%

例子

默认用法

默认情况下，标签显示：

• 如果没有特别规定，将显示所有类别

• 显示所有类别链接

• 在链接item后面放置一个行分隔符

• 在图像和链接之间放置一个空格（如果包含了图像的话）

• 如果有链接图像的话，显示链接图像

• 根据ID分类的列表

• 显示链接描述

• 不显示等级级别

• 不列出限制，显示所有链接

• 不显示更新的时间

<?php wp_get_linksbyname(); ?>

在称为"最喜爱"的链接类别中，列出所有链接。

<?php wp_get_linksbyname('Favorites') ?>

在链接类别友情链接中列出所有链接，根据链接名称给链接分类，不显示描述，而且显示最后更新的时间。

<?php wp_get_linksbyname('Blogroll','orderby=name&show_description=0&show_updated=1') ?>

参数

类别

category

(string) 将要显示的链接的类别的名称。没有默认设置。

参数

before

(string) 每个链接之前放置的文本。没有默认设置。

after

(string) 每个链接之后放置的文本。默认为'<br />'。

between

(string)每个链接/图像和各自的描述之间放置的文本。默认为' '(空格)。

show_images

(boolean) 链接的图像是否应该显示。

• 1 (True - default)
• 0 (False)

orderby

(string) Value to sort links on. Valid options:

• 'id' (default)
• 'url'
• 'name'
• 'target'
• 'category'
• 'description'
• 'owner' - 通过链接管理器添加链接的用户。
• 'rating'
• 'updated'
• 'rel' - 链接关系 (XFN).
• 'notes'
• 'rss'
• 'length' - 链接名的长度，从最短到最长不等。

将以上的任何选项加上一个下滑线的前缀(例如: '_id')以相反的顺序给链接分类。

• 'rand' -以任意的顺序显示链接。

show_description

(boolean)显示描述。如果show_images是FALSE，或者没有定义一个图像的时候，是有效的。

• 1 (True - default)
• 0 (False)

show_rating

(boolean) 等级级别stars/字符是否应该显示。

• 1 (True)
• 0 (False - default)

limit

(integer) 最多可以显示的链接的数目。默认为-1 (所有链接)。

show_updated

(boolean) 是否应该显示最后一次更新的时间。

• 1 (True)
• 0 (False - default)

echo

(boolean) 显示链接列表(1-正确的)或者将列表返回用于PHP中(0-错误的)。默认为1。

• 1 (True - default)
• 0 (False)