wordpress常用函数

强大的wordpress,给我们带来无尽的方便的同时也给我们带来了无尽的折腾,这些就是Wordpress中所涉及到的常用函数,喜欢折腾的你必须要给力的收藏,因为你随时都可能会用上,以作备份!

在讲述下面的WordPress函数之前,我们需要明确这样一点,所有的WordPress函数都是已经定义好的PHP函数,它们都需要写在PHP 语句中(<?php ?>)才能执行;而且,所有这些函数在PHP语句中都应以分号”;”结尾。其实,为了用好这些函数,为你的WordPress服务,你最好具有 PHP语言的基础。

1.bloginfo()

顾名思义,该函数主要用来显示博客信息;而且根据参数的不同,可以用来显示博客信息中的不同部分。常用的有以下几种:

bloginfo(’name’) 显示博客题名,如“月夜”;默认(不写参数)输出该项;

bloginfo(’description’) 显示博客描述部分,如“分享网络知识·享受快乐生活”;

bloginfo(’url’) 输出博客URL地址,如http://www.zuidongting.com;

bloginfo(’rss2_url’) 显示博客的RSS2.0 feed地址,如http://www.zuidongting.com/feed;

bloginfo(’template_url’) 用来获取WordPress博客的模板地址;

bloginfo(’charset’) 显示博客的编码方式,如“UTF-8”;

一种常见的使用bloginfo()函数的组合如下:

<a href=”<?php bloginfo(’url’); ?>” title=”<?php bloginfo(’description’); ?>” ><?php bloginfo(’name’); ?>

在心淡若水博客中,如上信息输出形如心淡若水的样式。这种形式通常会用来添加博客的底部信息,如Copyright @心淡若水,经常在主题模板中使用。

需要注意的是bloginfo()函数只能输出显示这些参量,如果你想在PHP语句中使用得到的这些值,则需使用get_bloginfo()函数,该函数和bloginfo()使用相同的参数,获得相同的结果。

2.wp_title()

该函数用来显示页面的标题,如在文章页面,则显示文章标题;在分类页面,则显示分类名称;等等。

wp_title()函数可以跟三个参数,即wp_title(’separator’,echo,seplocation),其中 separator是title和其余部分之间的分割符号,默认是>>;echo是个bool变量,取true显示标题,取false则将标 题作为一个PHP参量返回;seplocation定义分隔符的位置,取right定义分隔符在标题后面,取其他任何值,都表示将分隔符放在标题前面。

比如形如主题文件夹下header.php中的一段代码:

<title>
<?php wp_title(’ | ‘,true,’right’); ?>
<?php bloginfo(’name’); ?> – <?php bloginfo(’description’); ?>
</title>

在博客首页可以显示这样的效果“心淡若水 – 素心如简,人淡如菊”;在文章页,可以显示这样的效果“用好WordPress不可不知的50个函数 | 心淡若水 – 素心如简,人淡如菊”;而在分类页面,则可以显示这样的效果“心淡若水 – 素心如简,人淡如菊”;等等。

3.wp_get_archives()

该函数用来获取博客的文章存档,通过设置函数的参数,可以按各种方式获取,如按月,按年等等。

wp_get_archives()函数后面同样可以跟多种参数,只不过所有参数都需要使用&连接,并放在单引号(’)中以字符串方式传递 给函数,形如wp_get_archives(’type=monthly&format=html& show_post_count=1&limit=10′)。

如上的参数意义描述如下:

type=monthly表示按月显示文章存档,可以使用yearly、daily、weekly等代替monthly表示按年、日、以及周显示文章存档;

format=html表示使用通常的HTML中<li>格式化文章列表;

show_post_count=1表示在文章存档后面显示属于该类别(年、月等)的文章数量,该参量是个bool值;

limit=10表示显示的文章存档的最大数量为10,超过次数,则超出部分不显示;

尽管参数稍多,显得略为复杂,但其实只需注意type、show_post_count以及limit等三个参量即可。

4.wp_list_categories()

和wp_get_archives()函数类似,wp_list_categories()函数用来获取博客文章的分类信 息,并可以通过设置适当的函数参数,将其显示出来。该函数的参数和wp_get_archives()函数类似,都需要使用&连接,放在单引号 (’)中以字符串方式传递。形如wp_get_archives(’orderby=name&order=ASC& show_count=1&use_desc_for_title=1&feed=订阅&exclude=2,5& number=10′)。

如上示例中,函数各参数的意义如下:

orderby=name表示按照分类名称的字母先后顺序显示分类信息,可以将name换为ID等;

order=ASC表示按照分类名称的字母的升序显示分类信息,将ASC改为DESC表示按降序;

show_count=1在每个分类名称后面显示属于该分类的文章数;

use_desc_for_title=1使用该分类的描述信息为每个分类名称超链接添加一个title属性;

feed=订阅:在每个分类信息旁边添加一个名为“订阅”的超链接,提供该分类的RSS订阅;

exlude=2,5:在显示的分类中去除ID为2和5的分类;也可以用include=2,5表示只显示ID为2和5的分类;

number=10:表示只显示最先的10个分类。

5.get_the_category()

get_the_category()函数用来返回当前文章所属的类别的若干属性所组成的一个数组,该数组包括以下内容:

cat_ID:当前类别的ID(也可以写作’term_id’);

cat_name:当前类别的名称(也被写作’name’);

category_description:当前分类的描述(也可以写作’description’);

category_count:属于当前分类的文章数量(也被写作’count’)。

具体的使用方法,我们通过下面的几个句子来说明:

形如get_the_category()->cat_ID的语句,返回当前文章所属分类的ID号;

形如get_the_category()->description的语句,返回当前文章所属分类的描述;等等。

6.the_category()

该函数返回当前文章所属的类别名称,而且是文章类别的超链接形式。

默认的无参数形式the_category()直接以超链接形式显示类别名称,显示为:精品推介;

可以在函数中跟上分隔符等参数来格式化输出,如the_category(’-’),若当前文章属于两个以上分类,可以显示这样的形式:精品推介-经验知识;如只属于一个分类,则显示为这样的形式:精品推介。

7.category_description()

该函数以分类的ID为输入,得到该分类的描述。常和echo、get_the_category()配合使用,将当前分类描述输出:

echo category_description(get_the_category()->cat_ID);

如上语句,get_the_category()得到保存有当前分类信息的一个数组;cat_ID为该数组中该分类的ID;将该ID输入给category_description()函数,即可得到该分类的描述;然后使用echo将其输出。

但经月夜试验,使用如下的语句可以实现和上面语句相同的功能:

echo category_description();

这可能是因为该函数在默认无参数输入的情况下会输出当前分类描述的结果吧。

8.is_home()

is_home()用以判断当前显示的博客页面是否是博客首页,返回的是一个Bool值。如果是在首页,则返回TRUE;否则返回FALSE。

该函数常用来控制博客侧边栏的显示方式,经常使用如下代码段:

<?php
if ( is_home() ) {
//此为在博客首页应该显示的内容
} else {
//此为非博客首页应该显示的内容
}
?>

9.is_archive()

is_archive()用以判断当前显示的内容是否是博客存档页面,比如按日期的存档,或者按分类的存档,等等;其和is_home()函数一样,返回一个Bool值。

10.is_page()

is_page()函数判断当前显示的内容是否是博客的独立页面(page),如“读者墙”、“关于若水”等页面;它也返回一个Bool值。

我们可以在模板中通过该函数判断当前是否是一个独立页面,从而决定是否为当前显示的文章显示发布时间等等。

来自 ishare :http://ishare.cn.ms