用好WordPress不可不知的函数(七)

前面的文章中,月夜 为你介绍了WordPress中的一些函数,分类比较庞杂,包括获取文章tag、title等的函数,本文,我们继续为朋友们介绍WordPress中的其他函数。 今天我们要介绍的主要包括显示文章title的the_title()、single_post_title()等函数;获取当前文章ID号的the_ID()函数;以及the_permalink()等用来获取当前文章链接的函数;等等。

42.the_title()、the_title_attribute()

the_title()函数主要用来获取当前文章的title,其后可以跟上三个参数(可全部省略,取默认值),调用形式如下:

<?php the_title(‘before’, ‘after’, display); ?>

参数before用来设置在获取的title前面显示的字符内容;after用来设置title其后显示的内容;而display是一个Bool值,用于控制获取的title是否显示出来。 the_title_attribute()函数与the_title()类似,其使用方法如下:

the_title_attribute(‘before=前&after=后&echo=true’)

其中before=和after=分别用于设置title前面和后面显示的字符;echo=true或者false用户设置获取的title字符串是否显示出来。 形如<?php the_title(‘当前文章’, ‘的评论:’, true); ?>或the_title_attribute(‘before=当前文章&after=的评论:&echo=true’)的调用形式将会显示如下的结果:

当前文章用好WordPress不可不知的函数(七)的评论:

43.single_post_title()、single_tag_title()、single_cat_title()

这一系列函数用于获取当前文章页面、tag页面或分类页面的title字符串。其后可跟两个参数,调用形式如下:

<?php single_post_title(‘前缀’,display); ?>

可以使用形如<?php single_post_title(‘当前文章:’,TRUE); ?>或<?php single_post_title(‘当前文章:’); ?>的调用形式来显示如下的结果:

当前文章:用好WordPress不可不知的函数(七)

此外,也可以像42中的函数一样,将显示属性设置为false,把获取的title字符串传给一个变量,以供其他语句使用。此时的调用形式如下:

<?php $tt = single_post_title(‘当前文章:’,false); ?>

44.the_ID()

该函数后面不跟任何参数,使用如下所示的调用方式:

<?php $id = the_ID(); echo $id; ?> 用于获取并显示当前文章页面的ID号。不过需要特别注意的一点是,该函数只能在WordPress的大循环内使用,在其他地方使用可能也会显示ID号,但显示的内容始终不会随文章而改变。 此外,该函数通常还会在如下所示的CSS结构中使用:

<?php the_title(); ?>

可为博客中不同的作者设置不同的title样式,以示区分。

45.get_the_ID()

该函数与44.the_ID()函数实现完全相同的功能,目前WordPress官方也没有提供该函数的使用说明。你可以参阅如上44中对the_ID()函数的介绍。特别提醒一点,该函数与the_ID()类似,也只能在WordPress的大循环中才能正确使用。

46.the_time()、get_the_time()

the_time()用来获取并显示当前文章发布的时间,和上面几个函数类似,此函数也是只能在WordPress的大循环中使用。 该函数后面可以跟控制日期或时间格式的参数,常用的参数形式如下:

如<?php the_time(‘F j, Y’); ?>的调用形式显示效果为:六月13, 2009(英文状态下显示June 13, 2009);

如<?php the_time(‘g:i a’); ?>的调用形式显示效果为:7:09 下午(英文状态下显示7:09 pm);

如<?php the_time(‘G:i’); ?>的调用形式显示效果为:19:09。

事实上,除了使用the_time()函数之外,WordPress还提供了一个具有类似功能的get_the_time()函数。该函数除了不具有the_time()函数的显示功能之外,其余功能二者完全相同。使用get_the_time()函数时,如欲将获取的时间显示出来,需要使用专用语句。 下面,我们籍此机会来简单了解一下WordPress中时间的格式。在WordPress中,通常用于控制时间格式的有一下字符:l, F, j, S, Y, G, g, i, a等等,其详细意义如下:

l(小写L)用来显示一周之中每一天的名称,比如星期六,或者在英文中显示Saturday;

F用来显示月份名称,比如六月,或者June;

j用来显示一月之中的某一天,比如13;

Y用来以4位数字形式显示年份,使用y则以末两位数字显示年份,比如2009或09;

G, g, i, a等四个字符通常组合使用,如前例子,有两种形式:

g:i a以形如7:09 下午或7:09 pm的形式显示时间;

G:i以形如19:09的24小时进制形式显示时间。

S通常紧跟在j后面,表示是否在一月之中某天之后添加英文后缀(st, nd, th等)。