DIV CSS 佈局教程網

WordPress 子頁面實現上一篇/下一篇導航的方法
編輯:關於JavaScript     

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)

  • $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 中合適的位置,保存即可生效。

兩套方案分別覆蓋了「子頁面導航」和「同分類文章導航」這兩種典型需求,可以按需選用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved