WordPress:Template Tags/get linksbyname

Description

---

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.

---

描述

Like wp_get_linksbyname(), this tag displays links from the WordPress:Links Manager, but allows the user to control how they are displayed by tag parameters, rather than through the WordPress admin interface (useful when displaying links on more than one template).

像wp_get_linksbyname()一样，这个标签显示来自链接管理器中的链接，但是允许用户通过标签参数控制链接的显示方式，而不是通过WordPress管理界面（在几个模板上显示链接的时候，有用），控制链接的显示方式。

取代

wp_list_bookmarks().

wp_list_bookmarks().

用法

%%% <?php get_linksbyname('cat_name', 'before', 'after', 'between', show_images, 'orderby', show_description, show_rating, limit, show_updated); ?> %%%

%%% <?php get_linksbyname('cat_name', 'before', 'after', 'between', show_images, 'orderby', show_description, show_rating, limit, show_updated); ?> %%%

例子

默认用法

By default, the tag shows:

默认情况下，标签显示：

• All categories if none are specified
• 如果没有特别规定，将显示所有类别
• All category links are shown

• 显示所有类别链接

• Puts a line break after the link item

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

• Puts a space between the image and link (if one is included)

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

• Shows link images if available

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

• List sorted by ID

• 根据ID分类的列表

• Shows the link description

• 显示链接描述

• Does not show the rating

• 不显示等级级别

• With no limit listed, it shows all links

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

• Does not show the updated timestamp

• 不显示更新的时间

<?php get_linksbyname(); ?>

<?php get_linksbyname(); ?>

根据名称分类的特别类别

Displays links for link category "Friends" in an unordered list with descriptions on the next line, sorts by link name.

在一个无序的列表上显示链接类别为"朋友"的链接，并且在下一行中显示描述，根据链接名称分类。

<ul>
<?php get_linksbyname('Friends', '<li>', '</li>', '<br />', FALSE, 
'name', TRUE); ?>
</ul>

<ul>

<?php get_linksbyname('Friends', '<li>', '</li>', '<br />', FALSE, 
'name', TRUE); ?>
</ul>

拥有图像和等级级别，没有描述

Displays all links one per line without descriptions, uses images for links, sorts by link name, and shows ratings.

显示所有的链接，每行显示一个链接，为链接使用图像，根据链接名分类，显示链接级别。

<?php get_linksbyname('', '', '<br />', '', TRUE, 'name', FALSE, TRUE); ?>

<?php get_linksbyname('', '', '<br />', '', TRUE, 'name', FALSE, TRUE); ?>

作为一个定义列表，图像和描述分别在不同的标签中

Displays all links in a Definition List, places linked images in the <dt>, descriptions in the <dd>, and sorts by rating but doesn't show it.

在一个定义列表中显示所有的链接，将链接进的图像放到<dt&gt；描述放到<dd&gt；，同时根据链接级别分类，但是不显示链接级别。

<dl>
  <?php get_linksbyname('Portfolio', '<dt>',
       '</dd>','</dt><dd>', TRUE, 'rating',
       TRUE, FALSE, -1, FALSE); ?> 
</dl>

<dl>

  <?php get_linksbyname('Portfolio', '<dt>',
       '</dd>','</dt><dd>', TRUE, 'rating',
       TRUE, FALSE, -1, FALSE); ?> 
</dl>

To see examples of styling this markup in a fluid/elastic, multi-column layout with backgrounds and hover effects, please see Manipulating Definition Lists for Fun and Profit.

要看看在一个流畅的/易变的布局，拥有悬浮效果背景，设置这个markup的例子，请看看有趣而实用地操作定义列表。

参数

cat_name

(string) The name of the link category whose links will be displayed. If none is specified, all links are shown. Defaults to 'noname' (all links).

cat_name

(string)将要显示链接的链接类别名称。如果没有任何特别的规定，将会显示所有链接。默认为'没有名称' (所有链接)。

before

(string) Text to place before each link. There is no default.

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

after

(string) Text to place after each link. Defaults to '<br />'.

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

between

(string) Text to place between each link/image and its description. Defaults to ' ' (space).

之间

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

show_images

(boolean) Should images for links be shown (TRUE) or not (FALSE). Defaults to TRUE.

；显示_图像：(boolean)链接的图像应该显示(正确的)还是不应该显示(错误的)。默认为正确的。

orderby

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

顺序

(string)给链接分类的参数。默认为'id'有效的选项：

• 'id'
• 'url'
• 'name'
• 'target'
• 'category'
• 'description'
• 'owner' - User who added link through Links Manager.
• 'rating'
• 'updated'
• 'rel' - Link relationship (XFN).
• 'notes'
• 'rss'
• 'length' - The length of the link name, shortest to longest.

• 'id'
• 'url'
• '名称'
• '目标'
• '类别'
• '描述'
• '所有者' - 通过链接管理器添加链接的用户。
• '等级级别'
• '更新的'
• 'rel' - 链接关系 (XFN).
• '注意'
• 'rss'
• '长度' - 链接名的长度，从最短到最长不等。

Prefixing any of the above options with an underscore (ex: '_id') sorts links in reverse order.

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

• 'rand' - Display links in random order.

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

show_description

(boolean) Display the description (TRUE) or not (FALSE). Valid if show_images is FALSE or an image is not defined. Defaults to TRUE.

show_description

(boolean)描述应该显示(正确的)还是不应该显示(错误的)。当show_images是错误的，或者没有定义一个图像的时候，是有效的。默认正确的。

show_rating

(boolean) Should rating stars/characters be displayed (TRUE) or not (FALSE). Defaults to FALSE.

show_rating

(boolean)等级级别stars/字符是否应该显示(正确的) 或者不应该显示(错误的)。默认为错误的。

limit

(integer) Maximum number of links to display. Defaults to -1 (all links).

；限制：(整数)显示最多的链接的数目。默认为-1 (所有链接)。

show_updated

(boolean) Should the last updated timestamp be displayed (TRUE) or not (FALSE). Defaults to FALSE.

show_updated

(boolean)是否应该显示最后一次更新的时间(正确的)或者不应该显示 (错误的)。默认为错误的。

相关的

How to pass parameters to tags with PHP function-style parameters

Go to Template Tag index