WordPress:Template Tags/wp title

目錄

• 1 描述
• 2 用法
• 3 例子
  • 3.1 默認(rèn)用法
  • 3.2 使用分隔符
  • 3.3 博客名和文章標(biāo)題順序顛倒時，之間的分隔符
• 4 參數(shù)
• 5 相關(guān)的

描述

顯示或者返回網(wǎng)頁的標(biāo)題。從2.5版本開始，可以定義一個分隔符字符串，可以指定這個分隔符字符串在網(wǎng)頁標(biāo)簽之前或者之后顯示。

只要標(biāo)簽是在主頁的The Loop的外部，標(biāo)簽就可以用在模板內(nèi)的任何位置，但是標(biāo)簽通常是用在<標(biāo)簽>元素內(nèi)，作為網(wǎng)頁的標(biāo)頭。

標(biāo)簽文本取決于查詢：

單篇文章或者一個網(wǎng)頁

文章（或者網(wǎng)頁）的標(biāo)題

按日期計算的存檔：日期

(例如, "2006", "2006 – 一月")

類別：類別的名稱

作者網(wǎng)頁：用戶的公用名稱

用法

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

例子

默認(rèn)用法

顯示博客名稱（使用bloginfo()),訪問只有一篇文章的網(wǎng)頁的時候，文章標(biāo)題使用默認(rèn)設(shè)置。如果博客名是"我的WordPress 博客",文章標(biāo)題是"世界，你好!"，那么下面的例子會顯示標(biāo)題為我的 WordPress博客 » 世界，你好!

 <title><?php bloginfo('name'); ?> <?php wp_title(); ?></title>

這個例子會執(zhí)行同樣的功能：

 <title><?php bloginfo('name'); ?> <?php wp_title('',true,''); ?></title>

使用分隔符

在文件的標(biāo)題標(biāo)簽上顯示博客名（使用bloginfo()）和文章標(biāo)題，使用"--"作為博客名和文章標(biāo)題之間的分隔符。因此（當(dāng)訪問只有一篇文章的網(wǎng)頁的時候），會出現(xiàn)標(biāo)題我的 WordPress 博客—世界，你好!

 <title><?php bloginfo('name'); ?> <?php wp_title('--'); ?></title>

這個例子執(zhí)行同樣的功能也是一樣的：

 <title><?php bloginfo('name'); ?> <?php wp_title('--',true,''); ?></title>

博客名和文章標(biāo)題順序顛倒時，之間的分隔符

通過移動分隔符(使用wp_title(' '),然后測試是否存在一個文章標(biāo)題(使用 if(wp_title(' ', false)))，可以顛倒上面的例子中的網(wǎng)頁標(biāo)題和博客名的排列順序，在標(biāo)題之間顯示分隔符，如果顯示了，再bloginfo()。

對于WordPress2.5版本 – 最新的

<title>
 <?php wp_title('--',true,'right'); ?>
 <?php bloginfo('name'); ?>
 </title>

對于先前的版本

<title>
 <?php wp_title(' '); ?>
 <?php if(wp_title(' ', false)) { echo '--'; } ?> 
 <?php bloginfo('name'); ?>
 </title>

參數(shù)

sep

(string)文章標(biāo)題之前或者之后顯示的文本（例如分隔符）。默認(rèn)情況下，（如果sep是空白的），那么就是&raquo; (»)符號會在文章標(biāo)題之前或者之后顯示（由seplocation規(guī)定）。

echo

(boolean) Echo標(biāo)題 (True) 或者返回標(biāo)題作為一個PHP字符串使用 (False). 有效的參數(shù)值：

• 1 (True) - default
• 0: (False)

seplocation

(string)在2.5版本中引入，這個參數(shù)定義了與文章標(biāo)題相關(guān)的sep字符串放置的位置。擁有除了'right'外所有的參數(shù)值，sep參數(shù)值可以放在文章標(biāo)題的前面（文章標(biāo)題的左邊）。如果seplocation的參數(shù)值是'right'，那么sep字符串會附加在文章的后面。