程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> 詳解WordPress開發中wp_title()函數的用法，wordpresswp_title

詳解WordPress開發中wp_title()函數的用法，wordpresswp_title

編輯：關於PHP編程

詳解WordPress開發中wp_title()函數的用法，wordpresswp_title

wp_title 函數在 WordPress 中是用來顯示文章、頁面、分類等等等等標題的一個函數，但在首頁索引，該函數將不顯示任何的東西。該函數在 WordPress 官方主題中一直被使用，但目前很多定制的主題中這個函數總是為忽視。

函數意義詳解
wp_title 函數用來顯示頁面的標題，如在文章頁面，則顯示文章標題；在分類頁面，則顯示分類名稱，但在首頁索引，該函數將不顯示任何的東西。
有點像 WordPress 中的 get_the_title 和 single_cat_title()這兩個函數的自適應用法（自動判斷是頁面、文章還是分類、歸檔、標簽）。

函數聲明
有點長，希望您能耐心看一遍，哪怕只有那麼一遍。

/**
 * Display or retrieve page title for all areas of blog.
 *
 * By default, the page title will display the separator before the page title,
 * so that the blog title will be before the page title. This is not good for
 * title display, since the blog title shows up on most tabs and not what is
 * important, which is the page that the user is looking at.
 *
 * There are also SEO benefits to having the blog title after or to the 'right'
 * or the page title. However, it is mostly common sense to have the blog title
 * to the right with most browsers supporting tabs. You can achieve this by
 * using the seplocation parameter and setting the value to 'right'. This change
 * was introduced around 2.5.0, in case backwards compatibility of themes is
 * important.
 *
 * @since 1.0.0
 *
 * @param string $sep Optional, default is '»'. How to separate the various items within the page title.
 * @param bool $display Optional, default is true. Whether to display or retrieve title.
 * @param string $seplocation Optional. Direction to display title, 'right'.
 * @return string|null String on retrieve, null when displaying.
 */
function wp_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%'; // Temporary separator, for accurate flipping, if necessary
 
// If there is a post
if ( is_single() || ( is_home() && !is_front_page() ) || ( is_page() && !is_front_page() ) ) {
 $title = single_post_title( '', false );
}
 
// If there's a category or tag
if ( is_category() || is_tag() ) {
 $title = single_term_title( '', false );
}
 
// If there's a taxonomy
if ( is_tax() ) {
 $term = get_queried_object();
 $tax = get_taxonomy( $term->taxonomy );
 $title = single_term_title( $tax->labels->name . $t_sep, false );
}
 
// If there's an author
if ( is_author() ) {
 $author = get_queried_object();
 $title = $author->display_name;
}
 
// If there's a post type archive
if ( is_post_type_archive() )
 $title = post_type_archive_title( '', false );
 
// If there's a month
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 : '' );
}
 
// If there's a year
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);
}
 
// If it's a search
if ( is_search() ) {
 /* translators: 1: separator, 2: search phrase */
$title = sprintf(__('Search Results %1$s %2$s'), $t_sep, strip_tags($search));
}
 
// If it's a 404 page
if ( is_404() ) {
 $title = __('Page not found');
}
 
$prefix = '';
if ( !empty($title) )
 $prefix = " $sep ";
 
// Determines position of the separator and direction of the breadcrumb
if ( 'right' == $seplocation ) { // sep on right, so reverse the order
$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);
 
// Send it out
 if ( $display )
 echo $title;
 else
 return $title;
 
}

用法

<?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（）規檔等等提取標題的函數
還等什麼？
GO GO GO !