详解WordPress开发中wp_title()函数的用法
wp_title函数在WordPress中是用来显示文章、页面、分类等等等等标题的一个函数,但在首页索引,该函数将不显示任何的东西。该函数在WordPress官方主题中一直被使用,但目前很多定制的主题中这个函数总是为忽视。
函数意义详解
wp_title函数用来显示页面的标题,如在文章页面,则显示文章标题;在分类页面,则显示分类名称,但在首页索引,该函数将不显示任何的东西。
有点像WordPress中的get_the_title和single_cat_title()这两个函数的自适应用法(自动判断是页面、文章还是分类、归档、标签)。
函数声明
有点长,希望您能耐心看一遍,哪怕只有那么一遍。
/**
*Displayorretrievepagetitleforallareasofblog.
*
*Bydefault,thepagetitlewilldisplaytheseparatorbeforethepagetitle,
*sothattheblogtitlewillbebeforethepagetitle.Thisisnotgoodfor
*titledisplay,sincetheblogtitleshowsuponmosttabsandnotwhatis
*important,whichisthepagethattheuserislookingat.
*
*TherearealsoSEObenefitstohavingtheblogtitleafterortothe'right'
*orthepagetitle.However,itismostlycommonsensetohavetheblogtitle
*totherightwithmostbrowserssupportingtabs.Youcanachievethisby
*usingtheseplocationparameterandsettingthevalueto'right'.Thischange
*wasintroducedaround2.5.0,incasebackwardscompatibilityofthemesis
*important.
*
*@since1.0.0
*
*@paramstring$sepOptional,defaultis'»'.Howtoseparatethevariousitemswithinthepagetitle.
*@parambool$displayOptional,defaultistrue.Whethertodisplayorretrievetitle.
*@paramstring$seplocationOptional.Directiontodisplaytitle,'right'.
*@returnstring|nullStringonretrieve,nullwhendisplaying.
*/
functionwp_title($sep='»',$display=true,$seplocation=''){
global$wpdb,$wp_locale;
$m=get_query_var('m');
$year=get_query_var('year');
$monthnum=get_query_var('monthnum');
$day=get_query_var('day');
$search=get_query_var('s');
$title='';
$t_sep='%WP_TITILE_SEP%';//Temporaryseparator,foraccurateflipping,ifnecessary
//Ifthereisapost
if(is_single()||(is_home()&&!is_front_page())||(is_page()&&!is_front_page())){
$title=single_post_title('',false);
}
//Ifthere'sacategoryortag
if(is_category()||is_tag()){
$title=single_term_title('',false);
}
//Ifthere'sataxonomy
if(is_tax()){
$term=get_queried_object();
$tax=get_taxonomy($term->taxonomy);
$title=single_term_title($tax->labels->name.$t_sep,false);
}
//Ifthere'sanauthor
if(is_author()){
$author=get_queried_object();
$title=$author->display_name;
}
//Ifthere'saposttypearchive
if(is_post_type_archive())
$title=post_type_archive_title('',false);
//Ifthere'samonth
if(is_archive()&&!empty($m)){
$my_year=substr($m,0,4);
$my_month=$wp_locale->get_month(substr($m,4,2));
$my_day=intval(substr($m,6,2));
$title=$my_year.($my_month?$t_sep.$my_month:'').($my_day?$t_sep.$my_day:'');
}
//Ifthere'sayear
if(is_archive()&&!empty($year)){
$title=$year;
if(!empty($monthnum))
$title.=$t_sep.$wp_locale->get_month($monthnum);
if(!empty($day))
$title.=$t_sep.zeroise($day,2);
}
//Ifit'sasearch
if(is_search()){
/*translators:1:separator,2:searchphrase*/
$title=sprintf(__('SearchResults%1$s%2$s'),$t_sep,strip_tags($search));
}
//Ifit'sa404page
if(is_404()){
$title=__('Pagenotfound');
}
$prefix='';
if(!empty($title))
$prefix="$sep";
//Determinespositionoftheseparatoranddirectionofthebreadcrumb
if('right'==$seplocation){//seponright,soreversetheorder
$title_array=explode($t_sep,$title);
$title_array=array_reverse($title_array);
$title=implode("$sep",$title_array).$prefix;
}else{
$title_array=explode($t_sep,$title);
$title=$prefix.implode("$sep",$title_array);
}
$title=apply_filters('wp_title',$title,$sep,$seplocation);
//Senditout
if($display)
echo$title;
else
return$title;
}
用法
<?phpwp_title($sep,$echo,$seplocation);?>
参数详解
- $sep:分隔符;
- $echo:是否显示;
- $seplocation:分隔符所在位置(左还是右,只接受'right',如果不是right自动判定为左)
总结
WordPress中相同功能的函数有很多,都是从基层到高级不断的经过封装最后到达使用层的,当然如果我们需要一些灵活用法的话,我们可以直接用中间那层的函数,如果我们懒的话我们可以直接使用最高级的那层函数,诸如本函数wp_title,其实这个函数我们从源代码来看,wp替我们针对分类、标签、文章、归档、作者、页面等多种类型的页面进行了判断,并根据不同页面调用不同的标题函数来达到目的。
如果有时间,您可以对下面几个函数进行深入研究一下,一遍更灵活的进行seo
single_post_title文章页面提取标题的函数
single_term_titletag(标签)、cat(分类)、日期、提取标题的函数类似于single_cat_title()函数
get_queried_object作者页面提取对象的函数(对象中有作者名)
post_type_archive_title()规档等等提取标题的函数
还等什么?
GOGOGO!