WordPress进行模板和插件设计,当然少不了要了解Wordpress的函数,就像要用C++、Java少不了API一样。本篇文章总结了Wordpress Category分类函数Tags标签函数的使用方法。

目录模板函数集 (Category Template Tags)
(注意:所有代码的符号均需半角符号)

一、获取文章目录链接(Post Category)函数

<?php the_category('arguments');?>(多参数)

参数说明:

①分隔符(seperator),目录之间的分隔符号,可以为文字或字符,默认情况下按照无序列表的形式显示。

例子:

<?php the_category('seperator=&bull;'); ?>

②层级参数(parents),如何显示子目录链接,属性值有single和multiple。

例子:

<?php the_category('parents=multiple');>

二、在RSS中显示文章的发表目录(Post Category in RSS Format)函数

<?php the_category_rss('arguments'); ?>

参数说明:

①类型(type):Feed显示类型。

例子:

<?php the_category_rss('type=rss'); ?>

三、获取页面目录名称函数(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'); ?>

四、获取当前页目录描述(Category Description)函数

<?php category_description(category); ?>

参数说明:

①目录ID(category),返回目录描述,参数值类型为整数

例子:

<?php category_description('2'); ?>

五、显示下来菜单形式的目录列表(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'); ?>

六、获取目录链接(Category Link List)函数

<?php wp_list_categories('arguments'); ?>

具体参考 WordPress目录链接列表函数-Category Link List

七、返回文章是否属于某个指定目录(If In Category)函数

in_category()

<?php if ( in_category('category_id') ): ?>
// 具体代码
<?php endif; ?>

八、返回父目录列表(Category’s Parents List)函数

get_category_parents)

<?php echo(get_category_parents(category, display link, separator, nice name)); ?>

九、以数组的形式返回文章所属目录(Category Array)的函数

get_the_category()

<?php 
foreach((get_the_category()) as $category) {
echo $category->cat_name .' ';
}
?>

总结

好了,关于WordPress Category分类函数、Tags标签函数详解就介绍到这里,如果您在使用过程中遇到什么问题可以在下面留言,我会Mail回复您的。

如果您对青柠檬感兴趣,可以订阅青柠檬

3 Thoughts on “WordPress Category分类函数、Tags标签函数详解”

发表评论

电子邮件地址不会被公开。 必填项已用*标注