码库记事本

码库记事本

详解WordPress开发中wp_title()函数的用法

小诸哥 0

wp_title 函数在 WordPress 中是用来显示文章、页面、分类等等等等标题的一个函数,但在首页索引,该函数将不显示任何的东西。该函数在 WordPress 官方主题中一直被使用,但目前很多定制的主题中这个函数总是为忽视。

函数意义详解

wp_title 函数用来显示页面的标题,如在文章页面,则显示文章标题;在分类页面,则显示分类名称,但在首页索引,该函数将不显示任何的东西。

有点像 WordPress 中的 get_the_title 和 single_cat_title()这两个函数的自适应用法(自动判断是页面、文章还是分类、归档、标签)。

函数声明

有点长,希望您能耐心看一遍,哪怕只有那么一遍。

  1. /** 
  2.  * Display or retrieve page title for all areas of blog. 
  3.  * 
  4.  * By default, the page title will display the separator before the page title, 
  5.  * so that the blog title will be before the page title. This is not good for 
  6.  * title display, since the blog title shows up on most tabs and not what is 
  7.  * important, which is the page that the user is looking at. 
  8.  * 
  9.  * There are also SEO benefits to having the blog title after or to the 'right' 
  10.  * or the page title. However, it is mostly common sense to have the blog title 
  11.  * to the right with most browsers supporting tabs. You can achieve this by 
  12.  * using the seplocation parameter and setting the value to 'right'. This change 
  13.  * was introduced around 2.5.0, in case backwards compatibility of themes is 
  14.  * important. 
  15.  * 
  16.  * @since 1.0.0 
  17.  * 
  18.  * @param string $sep Optional, default is '»'. How to separate the various items within the page title. 
  19.  * @param bool $display Optional, default is true. Whether to display or retrieve title. 
  20.  * @param string $seplocation Optional. Direction to display title, 'right'. 
  21.  * @return string|null String on retrieve, null when displaying. 
  22.  */ 
  23. function wp_title($sep = '»'$display = true, $seplocation = '') { 
  24. global $wpdb$wp_locale
  25.    
  26. $m = get_query_var('m'); 
  27. $year = get_query_var('year'); 
  28. $monthnum = get_query_var('monthnum'); 
  29. $day = get_query_var('day'); 
  30. $search = get_query_var('s'); 
  31. $title = ''
  32.    
  33. $t_sep = '%WP_TITILE_SEP%'// Temporary separator, for accurate flipping, if necessary 
  34.    
  35. // If there is a post 
  36. if ( is_single() || ( is_home() && !is_front_page() ) || ( is_page() && !is_front_page() ) ) { 
  37.  $title = single_post_title( '', false ); 
  38.    
  39. // If there's a category or tag 
  40. if ( is_category() || is_tag() ) { 
  41.  $title = single_term_title( '', false ); 
  42.    
  43. // If there's a taxonomy 
  44. if ( is_tax() ) { 
  45.  $term = get_queried_object(); 
  46.  $tax = get_taxonomy( $term->taxonomy ); 
  47.  $title = single_term_title( $tax->labels->name . $t_sep, false ); 
  48.    
  49. // If there's an author 
  50. if ( is_author() ) { 
  51.  $author = get_queried_object(); 
  52.  $title = $author->display_name; 
  53.    
  54. // If there's a post type archive 
  55. if ( is_post_type_archive() ) 
  56.  $title = post_type_archive_title( '', false ); 
  57.    
  58. // If there's a month 
  59. if ( is_archive() && !emptyempty($m) ) { 
  60.  $my_year = substr($m, 0, 4); 
  61.  $my_month = $wp_locale->get_month(substr($m, 4, 2)); 
  62.  $my_day = intval(substr($m, 6, 2)); 
  63.  $title = $my_year . ( $my_month ? $t_sep . $my_month : '' ) . ( $my_day ? $t_sep . $my_day : '' ); 
  64.    
  65. // If there's a year 
  66. if ( is_archive() && !emptyempty($year) ) { 
  67.  $title = $year
  68.  if ( !emptyempty($monthnum) ) 
  69.  $title .= $t_sep . $wp_locale->get_month($monthnum); 
  70.  if ( !emptyempty($day) ) 
  71.  $title .= $t_sep . zeroise($day, 2); 
  72.    
  73. // If it's a search 
  74. if ( is_search() ) { 
  75.  /* translators: 1: separator, 2: search phrase */ 
  76. $title = sprintf(__('Search Results %1$s %2$s'), $t_sepstrip_tags($search)); 
  77.    
  78. // If it's a 404 page 
  79. if ( is_404() ) { 
  80.  $title = __('Page not found'); 
  81.    
  82. $prefix = ''
  83. if ( !emptyempty($title) ) 
  84.  $prefix = " $sep "
  85.    
  86. // Determines position of the separator and direction of the breadcrumb 
  87. if ( 'right' == $seplocation ) { // sep on right, so reverse the order 
  88. $title_array = explode$t_sep$title ); 
  89. $title_array = array_reverse$title_array ); 
  90. $title = implode( " $sep "$title_array ) . $prefix
  91. else { 
  92.  $title_array = explode$t_sep$title ); 
  93.  $title = $prefix . implode( " $sep "$title_array ); 
  94.    
  95. $title = apply_filters('wp_title'$title$sep$seplocation); 
  96.    
  97. // Send it out 
  98.  if ( $display ) 
  99.  echo $title
  100.  else 
  101.  return $title
  102.    

用法:

<?php wp_title( $sep, $echo, $seplocation ); ?>

参数详解

$sep:分隔符;

$echo:是否显示;

$seplocation:分隔符所在位置(左还是右,只接受'right',如果不是right自动判定为左)

总结:

WordPress 中相同功能的函数有很多,都是从基层到高级不断的经过封装最后到达使用层的,当然如果我们需要一些灵活用法的话,我们可以直接用中间那层的函数,如果我们懒的话我们可以直接使用最高级的那层函数,诸如本函数 wp_title ,其实这个函数我们从源代码来看, wp 替我们针对 分类、标签、文章、归档、作者、页面等多种类型的页面进行了判断,并根据不同页面调用不同的标题函数来达到目的。

如果有时间,您可以对下面几个函数进行深入研究一下,一遍更灵活的进行seo

single_post_title 文章页面提取标题的函数

single_term_title tag(标签)、cat(分类)、日期、提取标题的函数 类似于 single_cat_title()函数

get_queried_object 作者页面提取对象的函数(对象中有作者名)

post_type_archive_title()规档等等提取标题的函数

标签: wp_title()