詳解WordPress開發(fā)中wp_title()函數(shù)的用法
wp_title 函數(shù)在 WordPress 中是用來顯示文章、頁面、分類等等等等標(biāo)題的一個函數(shù),但在首頁索引,該函數(shù)將不顯示任何的東西。該函數(shù)在 WordPress 官方主題中一直被使用,但目前很多定制的主題中這個函數(shù)總是為忽視。
函數(shù)意義詳解
wp_title 函數(shù)用來顯示頁面的標(biāo)題,如在文章頁面,則顯示文章標(biāo)題;在分類頁面,則顯示分類名稱,但在首頁索引,該函數(shù)將不顯示任何的東西。
有點(diǎn)像 WordPress 中的 get_the_title 和 single_cat_title()這兩個函數(shù)的自適應(yīng)用法(自動判斷是頁面、文章還是分類、歸檔、標(biāo)簽)。
函數(shù)聲明
有點(diǎn)長,希望您能耐心看一遍,哪怕只有那么一遍。
/**
* 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 ); ?>
參數(shù)詳解
- $sep:分隔符;
- $echo:是否顯示;
- $seplocation:分隔符所在位置(左還是右,只接受'right',如果不是right自動判定為左)
總結(jié)
WordPress 中相同功能的函數(shù)有很多,都是從基層到高級不斷的經(jīng)過封裝最后到達(dá)使用層的,當(dāng)然如果我們需要一些靈活用法的話,我們可以直接用中間那層的函數(shù),如果我們懶的話我們可以直接使用最高級的那層函數(shù),諸如本函數(shù) wp_title ,其實(shí)這個函數(shù)我們從源代碼來看, wp 替我們針對 分類、標(biāo)簽、文章、歸檔、作者、頁面等多種類型的頁面進(jìn)行了判斷,并根據(jù)不同頁面調(diào)用不同的標(biāo)題函數(shù)來達(dá)到目的。
如果有時間,您可以對下面幾個函數(shù)進(jìn)行深入研究一下,一遍更靈活的進(jìn)行seo
single_post_title 文章頁面提取標(biāo)題的函數(shù)
single_term_title tag(標(biāo)簽)、cat(分類)、日期、提取標(biāo)題的函數(shù) 類似于 single_cat_title()函數(shù)
get_queried_object 作者頁面提取對象的函數(shù)(對象中有作者名)
post_type_archive_title()規(guī)檔等等提取標(biāo)題的函數(shù)
還等什么?
GO GO GO !
- WordPress開發(fā)中用于標(biāo)題顯示的相關(guān)函數(shù)使用解析
- WordPress中調(diào)試縮略圖的相關(guān)PHP函數(shù)使用解析
- 配置解決Nginx服務(wù)器中WordPress路徑不自動加斜杠問題
- WordPress中用于獲取搜索表單的PHP函數(shù)使用解析
- 在WordPress中使用wp_count_posts函數(shù)來統(tǒng)計文章數(shù)量
- 詳解WordPress中調(diào)用評論模板和循環(huán)輸出評論的PHP函數(shù)
- 詳解WordPress中分類函數(shù)wp_list_categories的使用
- WordPress中限制非管理員用戶在文章后只能評論一次
- 詳解WordPress中創(chuàng)建和添加過濾器的相關(guān)PHP函數(shù)
相關(guān)文章
php serialize()與unserialize() 不完全研究
這篇文章主要介紹了php serialize()與unserialize() 的一些區(qū)別,需要的朋友可以參考下2017-11-11
php實(shí)現(xiàn)根據(jù)詞頻生成tag云的方法
這篇文章主要介紹了php實(shí)現(xiàn)根據(jù)詞頻生成tag云的方法,涉及php分析與操作字符串以及標(biāo)簽云的生成技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-04-04
PHP生成各種隨機(jī)驗(yàn)證碼的方法總結(jié)【附demo源碼】
這篇文章主要介紹了PHP生成各種隨機(jī)驗(yàn)證碼的方法,結(jié)合具體實(shí)例形式總結(jié)分析了php常用的生成驗(yàn)證碼操作相關(guān)技巧,并附帶demo源碼供讀者下載參考,需要的朋友可以參考下2017-06-06
PHP服務(wù)器頁面間跳轉(zhuǎn)實(shí)現(xiàn)方法
在ASP中,我們可以使用Server.Transfer來實(shí)現(xiàn)在服務(wù)器端重定向,PHP中雖然沒有這樣的函數(shù),但是要實(shí)現(xiàn)類似的跳轉(zhuǎn)也不難2012-08-08
php性能分析之php-fpm慢執(zhí)行日志slow log用法淺析
這篇文章主要介紹了php性能分析之php-fpm慢執(zhí)行日志slow log用法,結(jié)合實(shí)例形式分析了php慢執(zhí)行日志的功能與相關(guān)使用技巧,需要的朋友可以參考下2016-10-10

