WordPress:Template Tags/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.
描述[ ]
像wp_get_linksbyname()一样，这个标签显示来自链接管理器中的链接，但是允许用户通过标签参数控制链接的显示方式，而不是通过WordPress管理界面（在几个模板上显示链接的时候，有用），控制链接的显示方式。
取代[ ]
用法[ ]
%%% <?php get_linksbyname('cat_name', 'before', 'after', 'between', show_images, 'orderby', show_description, show_rating, limit, show_updated); ?> %%%
例子[ ]
默认用法[ ]
默认情况下，标签显示：
- 如果没有特别规定，将显示所有类别
- 显示所有类别链接
- 在链接item后面放置一个行分隔符
- 在图像和链接之间放置一个空格（如果包含了图像的话）
- 如果有链接图像的话，显示链接图像
- 根据ID分类的列表
- 显示链接描述
- 不显示等级级别
- 不列出限制，显示所有链接
- 不显示更新的时间
<?php get_linksbyname(); ?>
根据名称分类的特别类别[ ]
在一个无序的列表上显示链接类别为"朋友"的链接，并且在下一行中显示描述，根据链接名称分类。
<ul>
<?php get_linksbyname('Friends', '<li>', '</li>', '<br />', FALSE,
'name', TRUE); ?>
</ul>
拥有图像和等级级别，没有描述[ ]
显示所有的链接，每行显示一个链接，为链接使用图像，根据链接名分类，显示链接级别。
<?php get_linksbyname('', '', '<br />', '', TRUE, 'name', FALSE, TRUE); ?>
作为一个定义列表，图像和描述分别在不同的标签中[ ]
在一个定义列表中显示所有的链接，将链接进的图像放到<dt>；描述放到<dd>；，同时根据链接级别分类，但是不显示链接级别。
<dl>
<?php get_linksbyname('Portfolio', '<dt>',
'</dd>','</dt><dd>', TRUE, 'rating',
TRUE, FALSE, -1, FALSE); ?>
</dl>
要看看在一个流畅的/易变的布局，拥有悬浮效果背景，设置这个markup的例子，请看看有趣而实用地操作定义列表。
参数[ ]
- cat_name
- (string) 将要显示链接的链接类别名称。如果没有任何特别的规定，将会显示所有链接。默认为'没有名称' (所有链接)。
- before
- (string) 每个链接之前放置的文本。没有默认设置。
- after
- (string)每个链接之后放置的文本。默认为'<br />'。
- between
- (string) 每个链接/图像和各自的描述之间放置的文本。默认为' '(空格)。
- show_images
- (boolean) 链接的图像应该显示(TRUE)还是不应该显示(FALSE)。默认为正确的。
- orderby
- (string) 给链接分类的参数。默认为'id'有效的选项：
- 'id'
- 'url'
- 'name'
- 'target'
- 'category'
- 'description'
- 'owner' - 通过链接管理器添加链接的用户。
- 'rating'
- 'updated'
- 'rel' - 链接关系 (XFN).
- 'notes'
- 'rss'
- 'length' -链接名的长度，从最短到最长不等。
- 将以上的任何选项加上一个下滑线的前缀(例如: '_id')以相反的顺序给链接分类。
- 'rand' - 以任意的顺序显示链接。
- show_description
- (boolean)描述应该显示(TRUE)还是不应该显示(FALSE)。当show_images是FALSE，或者没有定义一个图像的时候，是有效的。默认TRUE。
- show_rating
- (boolean) 等级级别stars/字符是否应该显示(TRUE) 或者不应该显示(FALSE)。默认为FALSE。
- limit
- (integer) 显示最多的链接的数目。默认为-1 (所有链接)。
- show_updated
- (boolean) 是否应该显示最后一次更新的时间(TRUE)或者不应该显示 (FALSE)。默认为FALSE。