WordPress 的文章頁自帶 previous_post_link() 和 next_post_link(),可以直接生成上一篇/下一篇鏈接。但在 page.php 這種獨立頁面模板裡,這兩個函數並不能滿足需求——頁面是有層級的,我們希望的是「同一父頁面下、按 menu_order 排序的兄弟頁面之間互相導航」。
比如結構如下:
Themes(父頁面) ├─ zBench(子頁面 1) ├─ zBorder(子頁面 2) └─ zSofa(子頁面 3)
當前停留在 zBorder 時,上一篇應指向 zBench,下一篇應指向 zSofa。這種情況下就需要自己寫一個函數。
把下面的代碼放進主題的 functions.php:
/**
* 獲取子頁面的上一頁/下一頁鏈接
*/
function subpage_nav_link($prevText = '', $nextText = '') {
global $post;
if (!$post->post_parent) return null; // 不是子頁面則返回空
$args = array(
'sort_order' => 'ASC',
'sort_column' => 'menu_order',
'child_of' => $post->post_parent,
'post_type' => 'page'
);
$pages = get_pages($args);
$num = count($pages);
$i = 0;
$index = -1;
foreach ($pages as $page) {
if ($page->ID == $post->ID) {
$index = $i;
break;
}
++$i;
}
if ($i == 0) { // 第一個子頁面,沒有上一篇
$prev = '';
$next = $pages[$index + 1];
} elseif ($i == $num - 1) { // 最後一個子頁面,沒有下一篇
$prev = $pages[$index - 1];
$next = '';
} else {
$prev = $pages[$index - 1];
$next = $pages[$index + 1];
}
if ($prev) {
if ($prevText) {
if (substr_count($prevText, '%title') > 0) {
$explode = explode('%title', $prevText);
$prevText = $explode[0] . get_the_title($prev->ID) . $explode[1];
}
} else {
$prevText = get_the_title($prev->ID);
}
$prevlink = '<a class="previous-page-link" href="' . get_page_link($prev->ID) . '">' . $prevText . '</a>';
}
if ($next) {
if ($nextText) {
if (substr_count($nextText, '%title') > 0) {
$explode = explode('%title', $nextText);
$nextText = $explode[0] . get_the_title($next->ID) . $explode[1];
}
} else {
$nextText = get_the_title($next->ID);
}
$nextlink = '<a class="next-page-link" href="' . get_page_link($next->ID) . '">' . $nextText . '</a>';
}
return array($prevlink, $nextlink);
}
subpage_nav_link($prevText, $nextText)
一般放在 page.php 的主循環裡,緊跟 the_content(); 之後即可:
<?php
if (function_exists('subpage_nav_link')) {
if ($subpage_nav_link = subpage_nav_link()) {
echo $subpage_nav_link[0]; // 上一篇鏈接
echo $subpage_nav_link[1]; // 下一篇鏈接
}
}
?>
用 if (!$subpage_nav_link[0]) 可以判斷是否沒有上一篇,if (!$subpage_nav_link[1]) 則判斷下一篇是否存在。
另外,兩個文字參數支持組合寫法,例如 subpage_nav_link('oo %title xx', '') 會輸出「oo 頁面名 xx」這樣的形式。
WordPress 默認的上下篇是按發布順序排列的。如果每個分類代表一部作品(比如小說站),跨分類導航就很彆扭,此時需要限定分類。
默認調用:
<?php previous_post_link('上一篇: %link') ?>
<?php next_post_link('下一篇: %link') ?>
文章處於首篇或末篇時輸出為空,可以補上提示:
<?php if (get_previous_post()) { previous_post_link('上一篇: %link'); } else { echo "已是最後一篇"; } ?>
<?php if (get_next_post()) { next_post_link('下一篇: %link'); } else { echo "已是最新一篇"; } ?>
但實測時,即使這樣寫,首篇與末篇的提示文案仍可能不顯示。原因在於判斷函數沒有被告知分類範圍,只要把分類 ID 傳進 get_previous_post() 和 get_next_post() 就能徹底解決:
<?php
$categories = get_the_category();
$categoryIDS = array();
foreach ($categories as $category) {
array_push($categoryIDS, $category->term_id);
}
$categoryIDS = implode(",", $categoryIDS);
?>
<?php if (get_previous_post($categoryIDS)) { previous_post_link('上一篇: %link', '%title', true); } else { echo "已是最後一篇"; } ?>
<?php if (get_next_post($categoryIDS)) { next_post_link('下一篇: %link', '%title', true); } else { echo "已是最新一篇"; } ?>
把這段代碼貼到主題目錄下的 single.php 中合適的位置,保存即可生效。
兩套方案分別覆蓋了「子頁面導航」和「同分類文章導航」這兩種典型需求,可以按需選用。