:~$ newsletter --subscribe
cat ~/artykuly/backend/paginacja-numeryczna-w-wordpressie.md

Paginacja numeryczna w WordPressie

Witryny internetowe oparte o WordPressa często mają zaimplementowaną nieefektywną paginację opartą o linki do poprzedniej/następnej strony z wpisami. Takie rozwiązanie ma bardzo wiele wad, a jedną z najważniejszych jest to, że nie możemy bezpośrednio przejść do np. najstarszych artykułów. Problem ten można rozwiązać stosując paginację numeryczną, czyli po prostu wyświetlając numery poszczególnych stron z wpisami. Co ciekawe takie rozwiązanie jest również bezpośrednio wspierane przez system WordPress.

Jak więc zrobić paginację numeryczną na stronie opartej o WordPressa?

Do tego celu wykorzystamy funkcję paginate_links(), która bezpośrednio wygeneruje nam listę stron.

Przykładowa implementacja (kod działa dla WordPressa od wersji 4.0):

javascript
global $wp_query;

paginate_links( array(
        'base' => @add_query_arg('paged','%#%'),
        'format' => '?paged=%#%',
        'current' => max( 1, get_query_var('paged') ),
        'total' => $wp_query->max_num_pages,
        'prev_text' => __('« '),
        'next_text'    => __(' »'),
) );

Kod ten należy wkleić w miejscu, w którym chcemy wyświetlić naszą paginację. Oczywiście należy dopisać do niego instrukcję echo() gdyż jak wcześniej wspomniałem funkcja paginate_links() wygeneruje nam tylko listę stron.

Napiszmy więc kompletną funkcję w PHP wyświetlającą paginację dla WordPressa (kod działa od wersji 4.0):

javascript
function pagination() {

    global $wp_query;

    if ($wp_query->max_num_pages > 1) { echo '<p class="pages" role="navigation">' . paginate_links( array(
        'base' => @add_query_arg('paged','%#%'),
        'format' => '?paged=%#%',
        'current' => max( 1, get_query_var('paged') ),
        'total' => $wp_query->max_num_pages,
        'prev_text' => __('« '),
        'next_text'    => __(' »'),
    ) ) . '</p>'; }
}

Kod ten można zapisać np. w pliku functions.php naszego szablonu i użyć w dowolnym miejscu:

php
<?php pagination(); /*wyświetlamy paginację*/ ?>

Nasz kod daje taki efekt:

  • Dla pierwszej strony:paginacja-przyklad
  • Dla strony ze środka:paginacja-przyklad2
  • Dla ostatniej strony:paginacja-przyklad3

Więcej na temat funkcji paginate_links() można znaleźć w dokumentacji WordPressa (wersja angielska): developer.wordpress.org/reference/functions/paginate_links.

udostępnij: ·
Łukasz Dudziński
Łukasz Dudziński · założyciel i autor
Pasjonat informatyki, a zwłaszcza programowania. Zwariowany maniak na tle nowych technologii oraz komputerów. W wolnych chwilach bloger... więcej-o-mnie →
ls ~/artykuly/powiazane --limit 3
komentarze --count 0
rss dla komentarzy →

// brak komentarzy — bądź pierwszy

dodaj-komentarz

Komentarze są moderowane. Podane dane przetwarzamy wyłącznie w celu publikacji komentarza (polityka prywatności).