站长百科 | 数字化技能提升教程 数字化时代生存宝典
首页
数字化百科
电子书
▼
建站程序
开发
服务器
办公软件
开发教程
▼
服务器教程
软件使用教程
运营教程
热门电子书
▼
CSS教程
WordPress教程
导航
程序频道
推广频道
网赚频道
人物频道
网站程序
网页制作
云计算
服务器
CMS
论坛
网店
虚拟主机
cPanel
网址导航
WIKI使用导航
WIKI首页
热点词条
最新资讯
网站程序
站长人物
页面分类
使用帮助
编辑测试
创建条目
网站地图
站长百科导航
站长百科
主机侦探
IDCtalk云说
跨境电商导航
WordPress啦
站长专题
网站推广
网站程序
网站赚钱
虚拟主机
cPanel
网址导航专题
云计算
微博营销
虚拟主机管理系统
开放平台
WIKI程序与应用
美国十大主机
编辑“
WordPress:Template Tags/wp list bookmarks
”
人物百科
|
营销百科
|
网赚百科
|
站长工具
|
网站程序
|
域名主机
|
互联网公司
|
分类索引
跳转至:
导航
、
搜索
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
== 描述 == 这个函数是在WordPress2.1版本时,引进的。[[WordPress:Template_Tags/wp_list_bookmarks|wp_list_bookmarks()]],显示[[WordPress:Administration_Panels|管理]] > [[WordPress:Administration_Panels#Manage_Blogroll|友情链接]] > [[WordPress:Manage_Blogroll_SubPanel|管理友情链接]]面板中出现的书签。这个[WordPress:Template_Tags|模板标签]]允许用户控制书签的分类,显示方式,而且试图替换模板标签'[[WordPress:Template_Tags/get_links_list|get_links_list()]]' 和'[[WordPress:Template_Tags/get_links|get_links()]]'。 == 用法 == %%% <?php wp_list_bookmarks('arguments'); ?> %%% ==例子 == ===默认用法=== <pre> $defaults = array( 'orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '', 'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'show_description' => 1, 'echo' => 1, 'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '<h2>', 'title_after' => '</h2>', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>' );</pre> 默认情况下,用法显示: *Bookmarks分成了拥有类别名的类别。 *不管类别ID,或者类别名,包含了所有bookmarks *根据名称给列表分类 *如果包含了图像,就会有一个图像 *图像和文本之间拥有一个空格 *显示关于bookmark的描述 *不显示级别 *除非设置了限制,否则显示所有的bookmarks *显示bookmarks <?php wp_list_bookmarks(); ?> === 简单的列表 === 显示所有的bookmarks,带有标题"Bookmarks",同时将items放入<li>标签。这个标题包裹在h2标签中。 <?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?> ===没有标头的简单列表=== 如上所述,显示所有的bookmarks,但是不包含默认标头。 <?php wp_list_bookmarks('title_li=&categorize=0'); ?> === 根据URL分类的特别的类别 === 在span标签中显示类别ID2的bookmarks,为bookmarks使用图像,不显示描述,根据bookmarkURL分类。 <?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?> === 显示级别和时间标记 === 在一个有序的列表上显示所有的bookmarks,另起一行加上描述,不为bookmarks使用图像,根据bookmark id 分类,显示级别和最后更新的时间。 <ol> <?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?> </ol> == 参数 == <!-- <pre> 真正的函数的默认设置,会在发表之时,被删除 $defaults = array('orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '', 'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1, 'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '<h2>', 'title_after' => '</h2>', 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '<li id="%id" class="%class">', 'category_after' => '</li>'); </pre> --> ; categorize : (''boolean'') Bookmarks必须在指定的类别中显示(<tt>TRUE</tt>)或者不必在指定的类别中显示(<tt>FALSE</tt>)。默认为<tt>TRUE</tt>。 :* <tt>1</tt> (True - default) :* <tt>0</tt> (False) ; category : (''string'') 用逗号分开列表上将要显示的类别ID。如果没有特别规定,拥有bookmarks的所有类别都会显示。默认为<tt>''</tt>(所有类别)。 ; category_name : (''string'') 将要显示bookmarks的类别的名称。如果没有特别规定,拥有bookmarks的所有的类别都会显示。默认为<tt>''</tt>(所有类别)。 ; category_before : (''string'')每个类别之前放置的文本。默认为<tt>'<li id="[category id]" class="linkcat">'</tt>。 ; category_after : (''string'') 每个类别之前放置的文本。默认为<tt>'<'/li>'</tt>。 ; class : (''string'') 每个类别li从属的class。默认为<tt>'linkcat'</tt>。 ; category_orderby : (''string'') 给类别分类的参数。默认为<tt>'name'</tt>。有效的参数值: :* <tt>'name'</tt> (Default) :* <tt>'id'</tt> :* <tt>'slug'</tt> :* <tt>'count'</tt> :* <tt>'term_group'</tt> (not used yet) ; category_order : (''string'') 类别顺序,category_orderby参数升序或者降序。有效的参数值: :* <tt>ASC</tt> (默认) :* <tt>DESC</tt> ; title_li : (''string'') 链接列表标头的文本。默认为<tt>'__('Bookmarks')'</tt>,显示"Bookmarks"(<tt>__('')</tt>用作[[WordPress:Localization|本地化目的]])。只当类别设置为0的时候,才会使用(否则会使用类别名代替)。如果验证通过了零(0)值,不显示标头,而且列表不会包裹在<tt><ul>, </ul></tt>标签内部。 ; title_before : (''string'')如果'categorize'是TRUE,每个类别描述之前放置的文本。默认为<tt>'<h2>'</tt>。 ; title_after : (''string'')如果'categorize'是TRUE,每个类别描述之后放置的文本。默认为<tt>'</h2>'</tt>。 ;show_private : (''boolean'')如果类别被规定为保密的,类别是否应该显示。忽视管理设置,并且显示保密的类别(<tt>TRUE</tt>)还是不显示保密的类别(<tt>FALSE</tt>)。默认为<tt>FALSE</tt>。 :* <tt>1</tt> (True) :* <tt>0</tt> (False - default) ; include : (''string'') 用逗号分开列表上的bookmark的ID数字,并且将其包含在输出中。例如,, 'include=1,3,6'指的是返回或者echo bookmark ID1,3,和6。如果使用了包含字符串,便忽视了''category'', ''category_name'', 和 ''exclude''参数。默认为<tt>''</tt>(所有的Bookmarks)。 ; exclude : (''string'') 删除列表上用逗号分开的bookmark ID 数字。例如,'exclude=4,12'指的是bookmark ID 为4和12的bookmark不会返回或者echod。默认为<tt>''</tt>(不删除任何内容)。 ; orderby : (''string'') 给bookmark分类的参数。默认为<tt>'name'</tt>,除非你验证通过了参数<tt>''</tt> (empty),在这种情况下,设置为<tt>'id'</tt>。有效的选项: :* <tt>'id'</tt> :* <tt>'url'</tt> :* <tt>'name'</tt> :* <tt>'target'</tt> :* <tt>'description'</tt> :* <tt>'owner'</tt> - 通过bookmarks管理器添加bookmark的用户 :* <tt>'rating'</tt> :* <tt>'updated'</tt> :* <tt>'rel'</tt> - bookmark关系 (XFN). :* <tt>'notes'</tt> :* <tt>'rss'</tt> :* <tt>'length'</tt> - bookmark名称的长度,从最短到最长。 :* <tt>'rand'</tt> - 以任意的顺序显示bookmarks。 ; order : (''string'') 分类顺序,根据参数的升序或者降序。有效的参数值: :* <tt>ASC</tt> (Default) :* <tt>DESC</tt> ; limit : (''integer'') 最多显示的bookmarks的数目。默认为<tt>-1</tt>(所有的bookmarks)。 ; before : (''string'') 每个bookmark之前放置的文本。默认为<tt>'<li>'</tt>。 ; after : (''string'') 每个bookmark之后放置的文本。默认为<tt>'</li>'</tt>。 ; category_before : (''string'') 每个类别之前放置的文本。默认为<tt>'<li>'</tt>,拥有适当的id和class。 ; category_after : (''string'') 每个类别之后放置的文本。默认为<tt>'</li>'</tt>。 ; between : (''string'') 每个bookmark/image 和各自的描述之间放置的文本。默认为<tt>'\n'</tt>(换行)。 ; show_images : (''boolean'')关于bookmarks的图像应该显示(<tt>TRUE</tt>) 或者不显示(<tt>FALSE</tt>)。默认为<tt>TRUE</tt>。 :* <tt>1</tt> (True - default) :* <tt>0</tt> (False) ; show_description : (''boolean'') 描述应该显示(<tt>TRUE</tt>) 或者不应该显示 (<tt>FALSE</tt>)。当'''show_images'''是<tt>FALSE</tt>,或者没有定义一个图像的时候,是有效的。默认为<tt>FALSE</tt>。 :* <tt>1</tt> (True) :* <tt>0</tt> (False - default) ; show_rating : (''boolean'') 等级级别stars/字符应该显示(<tt>TRUE</tt>)或者不应该显示 (<tt>FALSE</tt>)。默认为<tt>FALSE</tt>。 :* <tt>1</tt> (True) :* <tt>0</tt> (False - default) ; show_updated : (''boolean'') 最后更新的时间应该显示(<tt>TRUE</tt>)或者不应该显示 (<tt>FALSE</tt>)。默认为<tt>FALSE</tt>。 :* <tt>1</tt> (True) :* <tt>0</tt> (False - default) ; hide_invisible : (''boolean'') 即时bookmark的可视设置为否定的,也应该显示这个bookmark,遵从管理设置(<tt>TRUE</tt>)或者不遵从管理设置(<tt>FALSE</tt>)。默认为<tt>TRUE</tt>。 :* <tt>1</tt> (True - default) :* <tt>0</tt> (False) ; echo : (''boolean'') Display bookmarks (<tt>TRUE</tt>) or return them for use by PHP (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>. :* <tt>1</tt> (True - default) :* <tt>0</tt> (False) == 相关的== {{标签bookmark管理器标签}} {{PHP函数标签页底文字}}
摘要:
请注意,您对站长百科的所有贡献都可能被其他贡献者编辑,修改或删除。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源(参阅
Wordpress-mediawiki:版权
的细节)。
未经许可,请勿提交受版权保护的作品!
取消
编辑帮助
(在新窗口中打开)
本页使用的模板:
模板:PHP函数标签页底文字
(
编辑
)
模板:标签bookmark管理器标签
(
编辑
)