站长百科 | 数字化技能提升教程 数字化时代生存宝典
首页
数字化百科
电子书
▼
建站程序
开发
服务器
办公软件
开发教程
▼
服务器教程
软件使用教程
运营教程
热门电子书
▼
CSS教程
WordPress教程
导航
程序频道
推广频道
网赚频道
人物频道
网站程序
网页制作
云计算
服务器
CMS
论坛
网店
虚拟主机
cPanel
网址导航
WIKI使用导航
WIKI首页
热点词条
最新资讯
网站程序
站长人物
页面分类
使用帮助
编辑测试
创建条目
网站地图
站长百科导航
站长百科
主机侦探
IDCtalk云说
跨境电商导航
WordPress啦
站长专题
网站推广
网站程序
网站赚钱
虚拟主机
cPanel
网址导航专题
云计算
微博营销
虚拟主机管理系统
开放平台
WIKI程序与应用
美国十大主机
编辑“
WordPress:Template Tags/wp list categories
”
人物百科
|
营销百科
|
网赚百科
|
站长工具
|
网站程序
|
域名主机
|
互联网公司
|
分类索引
跳转至:
导航
、
搜索
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
== 描述 == 模板标签[[WordPress:Template_Tags/wp_list_categories|wp_list_categories]],显示了关于[[WordPress:Glossary#Category|类别]]的一个列表作为一个关于链接的列表。当点击一个类别的链接的时候,关于那个类别的所有文章都会显示在类别网页上,使用了[[WordPress:Template_Hierarchy|模板层级规则]]规定的适当的[[WordPress:Category Templates|类别标签]]。[[WordPress:Template_Tags/wp_list_categories|wp_list_categories]] 与WordPress2.1中被取代的两个标题的运行方式基本相同, [[WordPress:Template_Tags/list_cats|list_cats()]](取消的),和[[WordPress:Template_Tags/wp_list_cats|wp_list_cats()]](取消的)。 == 用法 == %%% <?php wp_list_categories('arguments'); ?> %%% ==例子== ===默认用法=== <pre> $defaults = array( 'show_option_all' => '', 'orderby' => 'name', 'order' => 'ASC', 'show_last_update' => 0, 'style' => 'list', 'show_count' => 0, 'hide_empty' => 1, 'use_desc_for_title' => 1, 'child_of' => 0, 'feed' => '', 'feed_image' => '', 'exclude' => '', 'hierarchical' => true, 'title_li' => __('Categories'), 'echo' => 1, 'depth' => 0 ); </pre> 默认情况下,用法显示: *没有链接连接到所有的类别 *以升序的方式,根据类别名称,给类别分类。 *不显示最近的更新(每个类别中的最后更新的文章) *以无序的列表样式显示 *不显示文章数目 *只显示拥有文章的类别 *将标题属性设置为类别描述 *没有限制到任何类别的子类别_ *没有使用feed或者feed图像 *没有排除任何类别,也没有包含所有的类别('include' => '' 没有在上面显示) *以层级嵌套的方式显示类别 *显示类别为列表上的标题 *没有强加SQL 限制('数字' => 没有在上面显示0) * 显示 (echos)类别 * 对于深度,没有限制 wp_list_categories(); === 包含或者删除类别 === 按字母顺序给类别分类,并且只包含ID是16,3,9,和5的类别,你可以写下以下的代码: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_categories('orderby=name&include=3,5,9,16'); ?> <br /> </ul> </tt> </div> 下面的例子显示了根据名称分类的类别链接,显示了每个类别的文章数目,并且从列表中删除了ID是10的类别。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_categories('orderby=name&show_count=1&exclude=10'); ?> <br /> </ul> </tt> </div> === 显示或者隐藏列表标题 === '''title_li'''为''wp_list_categories''产生的类别列表设置或者隐藏一个标题或者标头。默认<tt>'(__('Categories')'</tt>,例如,显示单词"类别"作为列表的标题。如果参数设置为零,或者空参数,就不会显示标题。下面的例子代码排除了ID为4和7的类别并且隐藏了列表标题: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_categories('exclude=4,7&title_li='); ?> <br /> </ul> </tt> </div> 在下面的例子中,只有ID是9,5和23的类别包含在列表中,而且标题文本已经更改为"诗",标题样式为<tt><nowiki><h2></nowiki></tt>: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul> <br /> <?php<br /> wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?> <br /> </ul> </tt> </div> === 只显示子类别 === 下面的例子编码产生的类别链接,根据ID分类,只对于ID为8的子类别;显示每个类别的文章数目而且从产生的链接的<tt>标题</tt> 属性中隐藏了类别描述。'''注:'''如果母类别中没有包含文章,就不会显示母类别。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul><br /> <?php wp_list_categories('orderby=id&show_count=1<br />&use_desc_for_title=0&child_of=8'); ?> <br /> </ul> </tt> </div> === 显示拥有RSS Feed 链接的类别 === 下面的例子产生的类别链接,是根据名称分类的,显示了每个类别中的文章的数目,而且为每个类别显示了链接,连接到RSS feed。 <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul><br /> <?php<br /> wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?> <br /> </ul> </tt> </div> 要用一个feed图标来代替rss链接,你可以编写: <div style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;"> <tt> <ul><br /> <?php<br /> wp_list_categories('orderby=name&show_count=1<br /> &feed_image=/images/rss.gif'); ?> <br /> </ul> </tt> </div> === 类别列表的Markup和样式 === 默认情况下,'''wp_list_categories()'''在一个单一的列表item(<tt>li</tt>)标题为"类别"的内部,产生嵌套的无序列表(<tt>ul</tt>)。 你可以通过将<tt>title_li</tt> [[#WordPress:Parameters|参数]]设置到一个空的字符串中,来[[#WordPress:Display_or_Hide_the_List_Heading|移除最外层的item 和列表]]。你需要自己覆盖结果在一个有序的列表(<tt>ol</tt>)或者无序的列表上(请看看下面的[[WordPress:Template_Tags/wp_list_categories#Examples|例子]])。如果你不想要这些list output,将<tt>样式</tt>参数设置为<var>none</var>。 如果类别列表是在类别归档网页上产生的,关于那个类别的list item被标记有HTML class <tt>current-cat</tt>。其它的list item没有class。 <pre>... <li class="current-cat"> [You are on this category page] </li> <li> [Another category] </li> ...</pre> 你可以使用一个[[WordPress:Glossary#CSS|CSS 选择器]]来设计那个list item: .current-cat { ... } == 参数 == ; show_option_all : (''string'')如果样式设置到列表上,一个非空的参数值会导致显示的链接连接到所有的类别中。默认值是不显示连接到所有类别的链接。 ; orderby : (''string'')根据字母顺序给类别分类,通过独一的类别ID或者通过类别中文章的数目,给类别分类。默认是通过类别名称给类别分类。有效的参数值: :* <tt>ID</tt> :* <tt>name</tt> - default :* <tt>count</tt> ; order : (''string'') 类别的分类顺序(升序或者降序)。默认是''升序''。有效参数值: :* <tt>ASC</tt> - default :* <tt>DESC</tt> ; show_last_updated : (''boolean'') 最后更新的文章的日期是否应该显示,显示(TRUE) 或者不显示 (FALSE).默认是 FALSE. : * <tt>1 (true) </tt> : * <tt>0 (false) </tt> - default ; style : (''string'')样式用来显示列表的类别。''列表''的参数值显示类别为list items,然而''none''没有产生特别的显示方法(list item由<tt><nowiki><br></nowiki></tt>标签分开)。默认设置是''列表''(为一个无序列表创建了list items)。更多的内容,请看看[[WordPress:Template_Tags/wp_list_categories#Markup_and_Styling_of_Category_Lists|the markup 部分]]。有效的参数值: :* <tt>list</tt> - 默认的。 :* <tt>none</tt> ; show_count : (''boolean'')显示每个类别中当前文章的数目。默认是''错误的''(不显示文章数目)。有效的参数值: :* <tt>1 (true)</tt> :* <tt>0 (false)</tt> - default ; hide_empty : (''boolean'') 显示不包含有文章的类别。默认是''真的'' (隐藏空类别)。有效的参数值: :* <tt>1 (true)</tt> - 默认 :* <tt>0 (false)</tt> ; use_desc_for_title : (''boolean'')设置是否将类别的[[WordPress:Manage_Categories_SubPanel|描述]]插入到创建的链接的<tt>标题</tt>属性中(例如 <nowiki><a title="<em>Category Description</em>" href="...</nowiki>)。默认是''true''(会插入类别描述)。有效的参数值: :* <tt>1 (true)</tt> - default :* <tt>0 (false)</tt> ; child_of : (''integer'') 只显示这个参数识别的类别的子类别。这个参数没有默认值。如果使用了参数, the '''hide_empty''' 参数设置为 ''false''. ; '''feed''' (''string''):显示链接连接到每个类别的[[WordPress:Glossary#RSS|rss-2]] feed并且设置显示链接文本。默认是''不显示文本和feed''。 ; '''feed_image''' : (''string'')为一个图像设置一个URI(通常是一个rss feed 图标)作为链接,连接到每个类别的rss-2 feed。这个参数废除了'''feed'''参数。没有关于这个参数的默认值。 ; 删除 : (''string'')从结果中删除一个或者更多的类别。这个参数拥有一个唯一的ID的,以逗号分开的类别列表,以升序的顺序。请看看[[WordPress:Template_Tags/wp_list_categories#Include_or_Exclude_Categories|例子]]中。''child_of''参数自动设置为假的。 ;包含 : (''string'')只包含属于某个ID的,在列表中用逗号分开的,以升序排列的类别。请看看[[WordPress:Template_Tags/wp_list_categories#Include_or_Exclude_Categories|例子]]。 ; hierarchical :(''boolean'')将子类别显示为内部列表内部(在母类别列表item的下面)或者内联的。默认是''真的''(在母类别item下面显示子类别)。有效的参数值: :* <tt>1 (true)</tt> - default :* <tt>0 (false)</tt> ; title_li : (''string'')设置外部列表item的标题和样式。默认为"_类别"。如果呈现了,但是是空的,就不会显示外部列表item 。请看看下面的[[#WordPress:Display or Hide the List Heading|例子]]。 ; number : (''integer'')设置需要显示多少个类别。这定义了SQL LIMIT 参数值。默认没有LIMIT。 ; echo : (''boolean'') 显示了结果或者将结果保存在一个变数中。默认是''真的''(显示组织好的类别)。有效的参数值: :* <tt>1 (true)</tt> - default :* <tt>0 (false)</tt> ; depth : (''integer'') 这个参数控制了,类别的列表中包含的类别拥有多少个层级。默认值是''0''(显示所有的类别和所有的子类别)。这个参数添加在[[WordPress:Version 2.5|2.5版本]]中 :* <tt>0</tt> -所有的类别和子类别(默认)。 :* <tt>-1</tt> -所有的类别显示为flat(而不是缩进)形式(取消'''层级''')。 :* <tt>1</tt> -只显示最高级别的类别 :* <tt>n</tt> -n的值(某个数字)规定了显示的类别的深度(或者层级) == 相关的 == {{标签 类别 标签}} {{查询 字符串 标签 页底文字}} {{Copyedit}}
摘要:
请注意,您对站长百科的所有贡献都可能被其他贡献者编辑,修改或删除。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源(参阅
Wordpress-mediawiki:版权
的细节)。
未经许可,请勿提交受版权保护的作品!
取消
编辑帮助
(在新窗口中打开)
本页使用的模板:
模板:Copyedit
(
编辑
)
模板:PHP Function Tag Footer
(
编辑
)
模板:PHP 函数标签页底文字
(
编辑
)
模板:Tag Category Tags
(
编辑
)
模板:查询 字符串 标签 页底文字
(
编辑
)
模板:标签 类别 标签
(
编辑
)
模板:标签类别标签
(
编辑
)