实用的WordPress函数使用说明、参数介绍（一）

这是一篇通俗易懂的Wordpress函数简明教程，原文来自月夜的《用好WordPress不可不知的函数》，文章作者将长期积累的WordPress函数知识，用自己语言简明扼要的对WordPress常用函数进行讲解描述，阅后帮助颇大，忍不住贴过来，相信看过这篇教程的童鞋从中会获得很多WordPress函数知识。（一） WordPress是目前十分流行的独立博客程序，因傻瓜化安装和使用，其在网民中的应用已近乎普及。但也因为很多新入门的用户几乎对WordPress程序没有任何了解，造成使用中碰到问题无法解决，求助也十分不易。而且，根据 月夜 的经验，WordPress用户学习了解并掌握一些基本的WordPress知识尤其是WordPress中功能强大使用方便的函数会极大地方便自己的应用，从而定制一个自己心仪的独立博客。 在这一系列文章中，月夜试着将自己在长期的WordPress生涯中摸索积累的WordPress函数以自己的语言与朋友们分享，希望这一系列文章能够为朋友们使用WordPress程序带来方便。 在讲述下面的WordPress函数之前，我们需要明确这样一点，所有的WordPress函数都是已经定义好的PHP函数，它们都需要写在PHP 语句中（<?php ?>）才能执行；而且，所有这些函数在PHP语句中都应以分号”;”结尾。其实，为了用好这些函数，为你的WordPress服务，你最好具有 PHP语言的基础。 1.bloginfo() 顾名思义，该函数主要用来显示博客信息；而且根据参数的不同，可以用来显示博客信息中的不同部分。常用的有以下几种： bloginfo(’name’) 显示博客题名，如“月夜”；默认（不写参数）输出该项； bloginfo(’description’) 显示博客描述部分，如“分享网络知识·享受快乐生活”； bloginfo(’url’) 输出博客URL地址，如http://www.yueye.org； bloginfo(’rss2_url’) 显示博客的RSS2.0 feed地址，如http://www.yueye.org/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(); 这可能是因为该函数在默认无参数输入的情况下会输出当前分类描述的结果吧。