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