WordPress 獲取文章連結 get_permalink() 與頁面標題 wp_title() 完整用法解析

前言

get_permalink() 是取得文章/頁面規範連結的標準函數；wp_title() 是輸出網頁 <title> 標籤內容的核心函數。本文完整解析參數、回傳值、實戰範例、SEO 優化技巧與常見誤區。

get_permalink() — 取得文章/頁面永久連結

函數原型

get_permalink( $post = 0, $leavename = false )

參數說明

參數	型別	預設	說明
$post	int|WP_Post	0 (當前迴圈文章)	文章 ID 或 WP_Post 物件
$leavename	bool	false	true 保留 %postname% 結構標記，不解析為實際 slug

回傳值

• 成功：完整永久連結 (string)
• 失敗：false (如文章不存在、狀態非發布)

常用範例

// 1. 迴圈中取得當前文章連結
echo get_permalink();

// 2. 依 ID 取得指定文章連結
echo '閱讀全文';

// 3. 依頁面標題取得頁面連結
$page = get_page_by_title('聯絡我們');
if ($page) {
    echo '聯絡我們';
}

// 4. 保留結構標記 (用於 JS 路由或重寫規則測試)
echo get_permalink(123, true); // 輸出: https://example.com/%postname%/

進階：取得自訂文章類型連結

// 產品頁面
$product = get_post(456);
if ($product && $product->post_type === 'product') {
    echo get_permalink($product);
}

// 使用 get_post_type_archive_link() 取得封存頁
echo get_post_type_archive_link('product');

wp_title() — 輸出/取得網頁標題

函數原型

wp_title( $sep = '»', $display = true, $seplocation = '' )

參數說明

參數	型別	預設	說明
$sep	string	» (»)	分隔符號，建議用 '|' 或 '-'
$display	bool	true	true 直接 echo，false 回傳字串
$seplocation	string	''	'right' 分隔符在右側 (較符合 SEO)，其他值在左側

各頁面預設輸出內容

頁面類型	預設標題內容
單篇文章	文章標題
單一頁面	頁面標題
分類封存	分類名稱
標籤封存	標籤名稱
日期封存	年/月/日
作者封存	作者顯示名稱
搜尋結果	搜尋關鍵字
404 頁面	Page not found
首頁 (非靜態首頁)	最新文章標題

基本用法 (header.php)

// 輸出範例: 文章標題 | 網站名稱

SEO 優化：使用 wp_title filter 自定義標題結構

現代最佳實務：title-tag 主題支援 (WP 4.1+)

// functions.php
add_theme_support('title-tag');

// WordPress 自動輸出