Wordpress函数详解Word文档下载推荐.docx
《Wordpress函数详解Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《Wordpress函数详解Word文档下载推荐.docx(15页珍藏版)》请在冰豆网上搜索。
phpbloginfo(’description’);
”>
phpbloginfo(’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>
phpwp_title(’|‘,true,’right’);
–<
/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号;
description的语句,返回当前文章所属分类的描述;
6.the_category()
该函数返回当前文章所属的类别名称,而且是文章类别的超链接形式。
默认的无参数形式the_category()直接以超链接形式显示类别名称,显示为:
精品推介;
可以在函数中跟上分隔符等参数来格式化输出,如the_category(’-’),若当前文章属于两个以上分类,可以显示这样的形式:
精品推介-经验知识;
如只属于一个分类,则显示为这样的形式:
精品推介。
7.category_description()
该函数以分类的ID为输入,得到该分类的描述。
常和echo、get_the_category()配合使用,将当前分类描述输出:
echocategory_description(get_the_category()->
cat_ID);
如上语句,get_the_category()得到保存有当前分类信息的一个数组;
cat_ID为该数组中该分类的ID;
将该ID输入给category_description()函数,即可得到该分类的描述;
然后使用echo将其输出。
但经月夜试验,使用如下的语句可以实现和上面语句相同的功能:
echocategory_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值。
我们可以在模板中通过该函数判断当前是否是一个独立页面,从而决定是否为当前显示的文章显示发布时间等等。
11.is_paged()
该函数用以判断当前文章是否因为内容过多而分页显示;
需要注意的是,如果你在写文章时手动添加了<
!
–nextpage–>
标签,来强制分页的话,该函数并不会因此而返回TRUE。
12.is_page_template()
is_page_template()函数需要跟一个参数,通常以如下方式使用:
is_page_template(’guestbook.php’);
藉此判断当前显示的独立页面(page)是否使用了参数所示的模板guestbook.php;
如果不跟参数,函数返回当前独立页面是否使用了模板。
13.is_single()
is_single()用以判断当前显示的页面内容是否是一篇单独的文章。
其后面可以跟三种参数,一种是文章ID;
一种是文章题目(title);
一种是文章名称(slug,文章题目的一种简短说明形式);
或者可以将三种参数组合使用,藉此来判断当前页面内容是否是具体的某篇文章。
一个简单的例子如下,我们可以通过如下几种方式判断当前显示的内容是否是本文:
is_single(’808′);
is_single(’用好WordPress不可不知的函数
(二)’);
is_single(’functions-must-known-using-wordpress-second’);
is_single(’808′,’用好WordPress不可不知的函数
(二)’,’functions-must-known-using-wordpress-second’);
在这里,月夜需要对上述最后一种方式做些说明:
该函数后跟三个参数时,有优先级,如果第一个参数符合条件,则返回TRUE;
否则,则返回FALSE;
貌似后面的参数并没有什么意义。
14.is_category()
该函数用以判断当前显示的页面内容是否是一个分类页面,如网站相关;
其中无需参数。
函数返回一个Bool值。
15.is_tag()
is_tag()用以判断当前显示的页面是否是一个标签页面,比如WordPress;
其后也不需要跟参数。
该函数同样返回一个Bool值。
16.is_date()
此函数用以判断当前显示的内容是否为按时间归档的页面,比如2009年四月,或者2009年4月8日,等等。
17.is_day()、is_month()、is_year()
这些函数用以判断当前显示的内容是否为按天、按月、按年份归档的页面。
它们和is_date()类似,只不过将归档时间更具体化而已。
18.is_author()
该函数用以判断当前显示的内容是否为以作者名归档的页面,比如月夜博客的admin作者页面。
19.is_admin()
is_admin()函数用以判断当前是否在控制面板页面,或者管理员面板页面。
20.get_bloginfo()
该函数和我们前面的文章用好WordPress不可不知的函数
(一)中介绍的bloginfo()函数实现近乎相同的功能。
主要用来显示博客的信息;
而且根据后跟参数的不同,会输出博客的不同信息。
其后不跟参数时,get_bloginfo()可以显示博客名称,形如“月夜”;
后跟其他参数时,可以显示对应的信息,比如get_bloginfo(‘description’)用以显示博客描述信息;
其他还可以使用的参数包括name、url、wpurl以及admin_email等等。
但因为其与bloginfo()函数实现相同的结果,所以,在bloginfo能够实现的情况下,月夜不推荐使用get_bloginfo()函数。
21.query_posts()
query_posts()函数结合适当的参数用来控制哪些文章会在页面上显示。
形如query_posts(”cat=3,6&
cat=-5,-10″)表示取分类ID为3和6的文章显示,不取分类ID为5和10的文章显示;
形如query_posts(”order=ASC&
showposts=10&
offset=1&
orderby=date&
posts_per_page=5″)意义如下:
order=ASC表示按照升序排列,取为DESC则表示按降序;
showposts=10则表示获取10篇文章;
offset=1表示取最新的文章;
orderby=date表示将文章按照日期排序;
posts_per_page=5表示每页显示5篇文章。
需要注意的是该函数只是将文章内容从MySQL数据库中查询出来,要将其显示,还需要与其他语句配合,比如一个经常在侧边栏中使用的形式如下:
h2>
最近文章<
/h2>
phpquery_posts(’showposts=5&
offset=1′);
ul>
phpwhile(have_posts()):
the_post();
phpthe_permalink();
phpthe_title();
”>
/li>
phpendwhile;
/ul>
如上的这段代码用以在侧边栏的指定位置上显示最新的5篇文章。
query_posts()函数后面可以跟众多种类的参数,功能十分强大,在此,我们不进行过多介绍。
如果时间和精力允许,月夜会在以后的文章中专门撰文详细地为朋友们做一介绍。
22.get_posts()
该函数和query_posts()函数功能大体相同,都是用来从数据库中查询并得到符合某条件的文章。
不过get_posts()函数的使用有一个固定的形式,如下:
$lastposts=get_posts(’numberposts=5′);
foreach($lastpostsas$post):
setup_postdata($post);
”id=”post-<
phpthe_ID();
phpthe_content();
phpendforeach;
即首先使用get_posts()函数查询得到文章数据,然后使用形如foreach($lastpostsas$post):
的循环将查询得到的文章内容显示出来。
get_posts()函数使用和query_posts()函数相同的参数,在此我们也不再作详细介绍。
23.wp_list_cats()
该函数和前文用好WordPress不可不知的函数
(一)中wp_list_categories()函数实现相同的功能,不过在最新的WordPress版本中,此函数已经被弃用,其功能为wp_list_categories()函数完全取代。
24.get_calendar()
get_calendar()函数用以在WordPress上显示日历,日历样式和使用widget显示的效果相同,如下图所示:
其后可以跟一个BOOL参数,用以控制日历上方星期的显示样式。
但经月夜测试,在中文状态下,使用TRUE或FALSE参数,日历的显示效果并没有什么区别。
25.wp_list_bookmarks()
该函数用来显示博客的友情链接,并可以使用各种参数来控制显示的数量、种类以及样式等等。
形如wp_list_bookmarks(’title_li=&
categorize=0&
orderby=rand&
include=41,40,37,54′);
的形式,意义解释如下:
title_li=&
categorize=0是一种通常使用的组合,意为不显示WordPress后台控制面板中设置的友情链接标题,但所有友链都按照设置的分类显示出来;
单独的一个title_li=还可以用来设置被显示友链的类别名称;
orderby=rand设置友链的显示方式为随机顺序,当然,还可以设置为其他的方式,比如id、url、name等等;
include=41,40,37,54表示只显示ID为这四个数字的四个友链;
与此对应,还支持使用exclude,表示不显示ID为多少的友链。
此外,该函数还经常用到的参数有before和after,用来设置每个链接前后的文字,默认的是<
和<
标记。
26.get_links()、wp_get_links()
这两个函数实现和25.wp_list_bookmarks()相同的功能,不过此二函数已在WordPress升级的过程中为25.wp_list_bookmarks()所取代。
27.wp_list_pages()
该函数以页面名称的超链接形式显示WordPress博客内的所有页面,经常用来建立顶端导航页面,或用来修饰侧边栏。
形如wp_list_pages(’title_li=&
sort_column=menu_order&
include=12,25,38,57&
depth=1&
’);
的函数调用,各参数意义如下:
title_li=用来设置所有显示页面的一个总名称;
后面没有参数值时,表示不显示名称;
sort_column=menu_order用来设置页面的显示顺序,表示按照WP后台设置的各页面顺序显示,其他的常用顺序设置可能还包括post_title、post_date、ID等等;
include=12,25,38,57表示只显示ID为这四个数值的四个页面;
同样,可以使用exclude来排除相应ID的页面;
depth=1表示只显示父页面,对所有子页面不予显示;
其他数值还包括默认的0,表示显示所有页面(子页面有缩进);
-1显示所有页面(子页面无缩进);
此外,该函数可能会用到的属性还包括link_before和link_after,用于设置显示的页面链接前后的字符。
28.wp_tag_cloud()
顾名思义,wp_tag_cloud()函数用来显示WordPress博客的标签云。
一种形如wp_tag_cloud(’smallest=8&
largest=22&
number=30&
orderby=count’);
的函数调用,各参数的意义如下:
smallest=8用来设置标签云中显示出来的所有标签中,计数最少(最少文章使用)的标签的字体大小为8;
largest=22用来设置标签云的所有标签中,计数最多(最多文章使用)的标签的字体大小为22;
number=30设置标签云中显示的最多标签数量为30;
orderby=count设置标签云中标签的排序方式为计数(默认),而不是名称(相应参数为name,widget调用时的默认值)。
其他常用的参数还包括include和exclude,用来设置在标签云中是否包含或去除ID为某数字的标签。
29.wp_register()
wp_register()函数用以向管理员显示“站点管理”超链接;
或者当WP博客开放了注册时,向未登陆的用户显示“注册”超链接。
该函数不需要什么参数,唯一可能用到的参数形式如wp_register(’前’,’后’),可以在如上显示的超链接文字的前后分别显示一个“前”字和一个“后”字。
当然,你可以据此发挥想象力来个性化自己网站的管理或注册链接。
30.wp_loginout()
该函数用来在指定位置显示一个“登录”链接;
当然,如果你已经登录过了,则会相应地显示一个“退出”链接。
此函数后面不使用任何参数,所以无法进行灵活的自定义。
不过如果你想自定义自己的WP博客的登录或退出链接文字的话,还是可以使用下面31中月夜介绍的函数wp_logout_url()和wp_login_url()。
31.wp_logout_url()、wp_login_url()
使用如上30中的函数尽管可以方便地为WP博客设置登录、退出链接,但自定义不够灵活。
所以,从WordPress2.7版本开始,提供了这里的两个函数。
它们分别用来获取WP博客退出或登录超链接,然后,我们使用获得的超链接即可编写如下代码,来对WP博客的登录和退出链接进行灵活设置:
phpechowp_logout_url();
点击这里退出
phpechowp_login_url();
点击这里登录
当然,要想实现完美的效果,还需要对访客的登录状态进行判断,使用一个if语句,根据登录状态显示相应的菜单项。
32.wp_meta()
该函数通常会紧跟如上29、30中的函数后面,其具体在直观显示上没有什么异样,貌似是WP主题为WP插件留下的APIHook,月夜建议朋友们在如上函数后面跟上这一函数。
33.get_recent_posts()
该函数只有当你安装了中文WordPress工具箱之后,才能使用。
其作用是用来获取最新日志,函数原型如下:
get_recent_posts($no_posts=5,$before=‘<
+‘,$after=‘<
’,$show_pass_post=false,$skip_posts=0)
可以使用$no_posts控制显示文章数量,$before和$after的意义和前面函数中相同;
至于后两个参数,一般不必设置,直接取默认值即可。
不过因为该函数与WordPress内置的get_posts()和query_posts()函数功能重复,所以通常情况下很少使用。
34.get_recent_comments()
其实安装了如上的中文WordPress工具箱之后,最常使用的是这个函数,因为WordPress程序本身没有内置获取最新评论的函数。
该函数原型如下:
get_recent_comments($no_comments=5,$before=‘<
‘,$after=‘<
’,$show_pass_post=false)
意义显然,和上面函数类似,月夜此处不再赘言。
35.get_recentcomments()
该函数是在安装了WP-RecentComments插件之后才具有的功能,与如上34中的函数类似。
get_recentcomments(intnum,ints