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):

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):

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 function.php naszego szablonu i użyć w dowolnym miejscu:

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

Nasz kod daje taki efekt:

• Dla pierwszej strony:
• Dla strony ze środka:
• Dla ostatniej strony:

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

Lepsza paginacja, paginacja, Paginacja dla WordPressa, Paginacja numeryczna WordPress, paginate_links(), PHP, Programowanie, Tworzenie stron WWW, WordPress, Wordpress 4.0