任鸟飞网站设计博客

为了更好更快的设计一个优秀Wordpress主题,网页设计师必须尽量掌握Wordpress中常用的函数,下面整理列出了目录模板函数列表，供大家参考。

目录模板函数集 （Category Template Tags）

1. 获取文章目录链接（Post Category）函数-<?php the_category(‘arguments);?>，多参数。
   参数说明：
   分隔符（seperator），目录之间的分隔符号，可以为文字或字符，默认情况下按照无序列表的形式显示。
   例子：
   <?php the_category(‘seperator=&bull;’); ?>
   层级参数（parents），如何显示子目录链接，属性值有single和multiple。
   例子：
   <?php the_category(‘parents=multiple’); ?>
2. 在RSS中显示文章的发表目录（Post Category in RSS Format）函数-<?php the_category_rss(‘arguments’); ?>。
   参数说明：
   类型（type）：Feed显示类型。
   例子：
   <?php the_category_rss(‘type=rss’); ?>
3. 获取页面目录名称函数（Page Category Title）函数-<?php single_cat_title(‘prefix’,'display’); ?>,显示或返回当前页面所属目录名称。
   参数说明：
   前缀（prefix），目录名称前缀，默认值：不显示任何内容。
   例子：
   <?php single_cat_title(‘&bull;’,'display’); ?>
   显示目录名称参数（display）。属性值 TRUE | FALSE
   例子：
   <?php single_cat_title(‘prefix’,'true’); ?>
4. 获取当前页目录描述（Category Description）函数<?php category_description(category); ?>。
   参数说明：
   目录ID（category），返回目录描述,参数值类型为整数
   例子：
   <?php category_description(’2′); ?>
5. 显示下来菜单形式的目录列表（Category Dropdown）函数-<?php wp_dropdown_categories(‘argument’); ?>
   参数说明：
   显示所有选项（show_option_all）
   例子：
   <?php wp_dropdown_categories(‘show_option_all=’) ;?>
   允许选择类别为“无”（show_option_none）
   例子：
   <?php wp_dropdown_categories(‘show_option_none=’); ?>
   排列字段（orderby）参数值 ID | name
   例子：
   <?php wp_dropdown_categories(‘orderby=name’); ?>
   排序次序（order）参数值 ASC | DESC
   例子：
   <?php wp_dropdown_categories(‘order=DESC’); ?>
   是否显示最后更新日期（show_last_update）属性值 1 | 0
   例子：<?php wp_dropdown_categories(‘show_last_update=1′); ?>
   是否显示目录内文章数量（show_count）属性值 1 | 0
   例子：<?php wp_dropdown_categories(‘show_count=1′); ?>
   是否隐藏空目录（hide_empty）属性值 1 | 0
   例子：
   <?php wp_dropdown_categories(‘hide_empty=0′); ?>
   显示子目录（Child of）属性值类型为 Interger
   根据目录ID显示其子目录
   例子：<?php wp_dropdown_categories(‘child_of=5′); ?>
   排除指定目录（exclude），以逗号分开指定目录的ID。参数值类型：Interger。
   例子：<?php wp_dropdown_categories(‘exclude=5,12′); ?>
   输出（echo）属性值 1 | 0,当参数echo=0是返回PHP形式的代码共使用。
   例子：<?php wp_dropdown_categories(‘echo=0′); ?>
   下拉列表中的选中项（selected）属性值类型：Interger。，参数范围为目录ID。
   例子：
   <?php wp_dropdown_categories(‘selected=5′); ?>
   层级（heirarchial），属性值 1 | 0
   例子：
   <?php wp_dropdown_categories(‘heirarchial=1′); ?>
   目录下拉列表名称（name），默认值为 “cat”。
   例子：
   <?php wp_dropdown_categories(‘name=cat-dropdown’); ?>
   目录下拉列表类（class）,默认值为“postform”。
   例子：
   <?php wp_dropdown_categories(‘class=cat-dropdown’); ?>
   层级目录深度（depth）属性值 0 | -1 | 1 | n。
   0：显示所有目录及子目录，默认值。
   -1：平级显示所有目录（子目录无缩进）
   1：只先是顶级目录
   n：指定层级深度
   例子：
   <?php wp_dropdown_categories(‘depth=n’); ?>
6. 获取目录链接（Category Link List）函数-<?php wp_list_categories(‘arguments’); ?>。
   具体参考 WordPress目录链接列表函数-Category Link List
7. 返回文章是否属于某个指定目录（If In Category）函数-in_category()。
   <?php if ( in_category(‘category_id’) ): ?>
   // 具体代码
   <?php endif; ?>
8. 返回父目录列表（Category’s Parents List）函数-get_category_parents)。
   <?php echo(get_category_parents(category, display link, separator, nice name)); ?>
9. 以数组的形式返回文章所属目录（Category Array）的函数-get_the_category()。
   <?php foreach((get_the_category()) as $category) {
        echo $category->cat_name . ’ ’;
        }
   ?>