WordPress中获取页面链接和标题的相关PHP函数用法解析
get_permalink()(获取文章或页面链接)
get_permalink()用来根据固定连接返回文章或者页面的链接。在获取链接时get_permalink()函数需要知道要获取的文章的ID,如果在循环中则自动默认使用当前文章。
用法
get_permalink($id,$leavename);
参数
$id
(混合)(可选)文章或者页面的ID(整数);还可以是文章对象。
默认值:在循环中自动调用当前的文章
$leavename
(布尔)(可选)转化成链接是是否忽略文章别名。如果设置成True,那么将返回http://www.example.com/%postname%而不是http://www.example.com/my-post-name
默认值:None
返回值
(字符串|布尔)成功获取链接则返回链接,失败则返回False.
例子
根据ID获取文章或页面的链接:
<ahref="<?phpechoget_permalink(268);?>">获取指定ID的文章或页面链接</a>
循环中获取当前文章的链接:
<?phpechoget_permalink();?>
根据页面标题获取页面链接:
<ahref="<?phpechoesc_url(get_permalink(get_page_by_title('留言板')));?>">留言板</a>
其它
此函数位于:wp-includes/link-template.php
wp_title()(获取网页标题)
wp_title()用来获取当前网页的标题,也就是title标签里边的内容。
wp_title()能在不同的页面自动生成不同的标题(比如首页就是网站标题、文章页就是文章标题)。WordPress官方的主题都在使用这个函数生成标题,但是在国内的主题中却总是被忽视(因为默认情况下这个函数对SEO并不是太好)。
我还是推荐使用这个函数调用标题,更加符合主题开发规范,如果你要让他变的更加符合SEO,可以使用过滤器优化一下,本文结尾有优化方法。
用法
wp_title($sep,$display,$seplocation);
参数
$sep
(字符串)(可选)标题内容的分隔符,一般设置成“|”或者“-”。
默认值:»(»)
$display
(布尔)(可选)是否直接打印标题,如果设置成False则返回标题,可以存储到变量里。
默认值:True(直接打印输出)
$seplocation
(字符串)(可选)分隔符所在位置,左边还是右边,如果传递“right”则为右边,其它任何内容都是左边。
默认值:空字符串(左边)
返回值
(字符串)如果$display参数设置成False,才能返回标题的内容,根据不同的标题会返回不同的内容,默认情况下返回的内容是这样的:
- 文章页:文章标题
- 日期页:日期
- 分类页:分类标题
- 作者页:作者名字
如果你想更加详细的了解,可以阅读下边的函数源码:
/**
*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$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'saposttypearchive
if(is_post_type_archive()){
$post_type=get_query_var('post_type');
if(is_array($post_type))
$post_type=reset($post_type);
$post_type_object=get_post_type_object($post_type);
if(!$post_type_object->has_archive)
$title=post_type_archive_title('',false);
}
//Ifthere'sacategoryortag
if(is_category()||is_tag()){
$title=single_term_title('',false);
}
//Ifthere'sataxonomy
if(is_tax()){
$term=get_queried_object();
if($term){
$tax=get_taxonomy($term->taxonomy);
$title=single_term_title($tax->labels->name.$t_sep,false);
}
}
//Ifthere'sanauthor
if(is_author()&&!is_post_type_archive()){
$author=get_queried_object();
if($author)
$title=$author->display_name;
}
//Posttypearchiveswithhas_archiveshouldoverrideterms.
if(is_post_type_archive()&&$post_type_object->has_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";
/**
*Filterthepartsofthepagetitle.
*
*@since4.0.0
*
*@paramarray$title_arrayPartsofthepagetitle.
*/
$title_array=apply_filters('wp_title_parts',explode($t_sep,$title));
//Determinespositionoftheseparatoranddirectionofthebreadcrumb
if('right'==$seplocation){//seponright,soreversetheorder
$title_array=array_reverse($title_array);
$title=implode("$sep",$title_array).$prefix;
}else{
$title=$prefix.implode("$sep",$title_array);
}
/**
*Filterthetextofthepagetitle.
*
*@since2.0.0
*
*@paramstring$titlePagetitle.
*@paramstring$sepTitleseparator.
*@paramstring$seplocationLocationoftheseparator(leftorright).
*/
$title=apply_filters('wp_title',$title,$sep,$seplocation);
//Senditout
if($display)
echo$title;
else
return$title;
}
很显然默认情况下标题是比较简陋的,对SEO并不是很友好。
例子
<title><?phpwp_title('|',true,'right');?></title>
其它
标题可以使用wp_title过滤器定制,此函数位于:wp-includes/general-template.php