WP-頁面導覽

Description

想要取代較舊 ← 舊發表 | 新發表 → 部分頁面的連結?

此外掛提供 wp_pagenavi() 絢麗分頁連結的板模標籤。

使用量

在您的主題中,您需要取代 next_posts_link() 與 previous_posts_link() 。

在貳零壹零主題中,看起來像是:

<div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">&larr;</span> Older posts', 'twentyten' ) ); ?></div>
<div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?></div>

您可以透過以下項目取代這兩行:

<?php wp_pagenavi(); ?>

針對多部分頁面,您可以尋找類似於以下的編碼:

<?php wp_link_pages( ... ); ?>

使用以下項目進行取代:

<?php wp_pagenavi( array( 'type' => 'multipart' ) ); ?>

移至 WP-管理 -> Settings -> PageNavi 進行設定。

變更的CSS

如果您需要設定 WP-頁面導覽 的 CSS 樣式,您可以複製外掛目錄中的 pagenavi-css.css 的檔案,並進行修改。這樣您就不會在變更外掛後,遺失您先前的變更。

另外,您也可以在設定頁面中取消選取「使用 Use pagenavi.css ?」選項,並增加目錄中 style.css 檔案的樣式。

變更類別名稱

可以在這裡找到更多有用的 篩選器 ,並可變更指定頁面元素中的類別名稱。

篩選器

  • wp_pagenavi_class_pages
  • wp_pagenavi_class_first
  • wp_pagenavi_class_previouspostslink
  • wp_pagenavi_class_extend
  • wp_pagenavi_class_smaller
  • wp_pagenavi_class_page
  • wp_pagenavi_class_current
  • wp_pagenavi_class_larger
  • wp_pagenavi_class_nextpostslink
  • wp_pagenavi_class_last

篩選器使用量

// Simple Usage - 1 callback per filter
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_previouspostslink_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_nextpostslink_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_page_class');

function theme_pagination_previouspostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--previous';
}

function theme_pagination_nextpostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--next';
}

function theme_pagination_page_class($class_name) {
  return 'pagination__current-page';
}


// More Concise Usage - 1 callback for all filters
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_class');

function theme_pagination_class($class_name) {
  switch($class_name) {
    case 'previouspostslink':
      $class_name = 'pagination__control-link pagination__control-link--previous';
      break;
    case 'nextpostslink':
      $class_name = 'pagination__control-link pagination__control-link--next';
      break;
    case 'page':
      $class_name = 'pagination__current'
      break;
  }
  return $class_name;
}

組建狀態

開發

製作群

捐贈

我在空餘時間建立、更新、維護並支援這個外掛,如果您真的喜愛我的外掛,可以透過捐獻協助,會真的很感謝您。即使沒有,也無須有壓力的使用我的作品。

Screenshots

  1. wp-pagenavi screenshot 1

    自訂設計

  2. wp-pagenavi screenshot 2

    管理 – 選項頁面

FAQ

啟動時發生錯誤:「可能的錯誤:語法錯誤、不可預期的…」

請確認您的主機正在執行 PHP 5版。這才是唯一萬無一失的方式在 wp-config.php 增加新行 (在 <?php 標籤後開啟):

var_dump(PHP_VERSION);

當我移至第二頁時,我看見與第一頁相同的文章!

您正在使用 query_posts() 發生錯誤。請見 正確使用 query_posts() 的方式

PageNavi 會以次要項目有效執行 WP_Query 例項嗎?

是的;請閱讀 這個教學(英文)

我要如何忽略選項頁面?

如果您執行多國語言外掛,您可能需要略過這頁選項的字串。

您也可以:

<?php wp_pagenavi( array( 'options' => PageNavi_Core::$options->get_defaults() ) ); ?>

Reviews

nice one

configurable, possibility to disable css, show & hide fields.. just nice =)

閱讀全部 134 評論

Contributors & Developers

“WP-頁面導覽” is open source software. The following people have contributed to this plugin.

貢獻者

Changelog

2.91

  • 驗證文字選項與 kses 衝突
  • 更新 SCB Framework

2.90

  • 移除來自外掛的 po/mo 檔案
  • 使用 translate.wordpress.org 翻譯外掛

2.89.1

  • 修正:arguments 物件的之前與之後

2.89

  • 新功能:wrapper_tag 選項除了 DIV 外允許其他 HTML 標籤,並 wrapper_class 功能除了 wp-pagenavi 外允許其他類別的名稱。提供 @Mahjouba91 。

2.88

  • 新功能:新增變更類別名稱的過濾器。提供 @Mahjouba91

2.87

  • 新功能:使用 WordPress 原生 uninstall.php

2.86

  • 新功能:更新至 4.0
  • 新功能:新增 rel=next 與 rel=previous

2.85

  • 修正:「使用 pagenavi-css.css」與「總是顯示頁面導航」為儲存的設定

2.84

  • 修正:更新 scb framework 至修正 scbAdminPage 不相容錯誤

2.83

  • 新增 ‘echo’ 參數
  • 新增愛沙尼亞文與孟加拉文翻譯
  • 更新 scbFramework

2.82

  • 修正 prev/next 連結在部分條件下未顯示
  • 新增希伯來文,由 Georgian 與 Azerbaijani 翻譯
  • 更新 scbFramework

2.81

  • 需要明確類型;修正多部分頁面的錯誤

2.80

  • 支援多部分頁面與使用者查詢
  • 移除 prev/next 連結之後的 before/after first/last 連結
  • 更多資訊

2.74 (2011-02-17)

  • 新增 ‘smaller’ 與 ‘larger’ 類別
  • 新增 $query 掛勾至 wp_pagenavi()
  • 翻譯更新
  • 更多資訊