个人工具
名字空间
变换
操作

WordPress:Template Tags/get links

来自站长百科
跳转到: 导航, 搜索

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_links()一样,这个标签显示来自链接管理器中的链接,但是允许用户通过标签参数控制链接的显示方式,而不是通过WordPress管理界面(在几个模板上显示链接的时候,有用),控制链接的显示方式。这个标签不会忽视,可视属性设置为否定的任何链接。

取代

wp_list_bookmarks().

用法

%%% <?php get_links(category, 'before', 'after', 'between', show_images, 'order', show_description,show_rating, limit, show_updated, echo); ?> %%%


例子

默认用法

默认情况下,用法显示:

  • 所有链接
  • 每个链接item后面的行分隔符
  • 如果包含了一个链接,就会有一个图像
  • 图像和文本之间有一个空格
  • 根据名称给类别分类
  • 显示链接的描述
  • 不显示等级级别
  • 除非设置了限定,否则显示所有的链接
  • 将链接显示为链接而不是文本

<?php get_links(); ?>


根据URL分类的特别的类别

在span标签中为链接类别ID2显示链接,为链接使用图像,不显示描述,根据链接URL分类。

<?php get_links(2, '<span>', '</span>', '', TRUE, 'url', FALSE); ?>

显示等级级别和时间标记

在一个无序列表上显示所有的链接,重起一行显示描述,不为链接显示图像,根据链接id分类,显示描述,显示等级级别,对于链接的数目没有限制,显示最后更新的时间,并且echo结果。

<ol>

<?php get_links('-1', '<li>', '</li>', '<br />', FALSE, 'id', TRUE, 
TRUE, -1, TRUE, TRUE); ?>
</ol>

参数

category 
(integer) 将要显示的链接的链接类别的ID数。审查通过一个包含用逗号分开的类别的列表的字符串,如"4,11,3",以在多个类别中显示链接。如果没有规定任何内容,将会显示所有链接。默认为-1(所有链接)。


before 
(string) 每个链接之前放置的文本。没有默认设置。.
after 
(string) 每个链接之后放置的文本。默认为'<br />'
between 
(string) 每个链接/图像和各自的描述之间放置的文本。默认为' '(空格)。
show_images 
(boolean) 链接的图像应该显示(正确的)还是不应该显示(错误的)。默认为正确的
order 
(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')以相反的顺序给链接分类。
  • 'rand' - 以任意的顺序显示链接。


show_description 
(boolean)描述应该显示(正确的)还是不应该显示(错误的)。当show_images错误的,或者没有定义一个图像的时候,是有效的。默认正确的
show_rating 
(boolean) 等级级别stars/字符是否应该显示(true) 或者不应该显示(false)。默认为错误的
limit 
(integer) 显示最多的链接的数目。默认为-1 (所有链接)。
show_updated 
(boolean) 是否应该显示最后一次更新的时间(正确的)或者不应该显示 (错误的)。默认为错误的
echo 
(boolean)显示链接(TRUE)或者将链接返回用于使用PHP(FALSE)。默认为正确的

相关的

Template:标签链接管理器标签

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

Go to Template Tag index

留言