Переопределите стандартную разметку пагинации WordPress

Я хочу отобразить разметку пагинации в постах WordPress с помощью моего собственного HTML. В моей теме разметка пагинации имеет формат ul > li. Но стандартная разметка пагинации WordPress отличается от моей разметки.

Как я могу применить свою разметку HTML вместо стандартной разметки пагинации?

Вы имеете в виду пагинацию архивов постов? Функция paginate_links() принимает параметр type, так что если вам нужен только формат ul > li, вы можете попробовать что-то вроде:

    // пагинация архивов
    global $wp_query;
    $big = 999999999; // нужен маловероятный целый 

    echo paginate_links( [
        'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
        'format' => '?paged=%#%',
        'current' => max( 1, get_query_var('paged') ),
        'total' => $wp_query->max_num_pages,
        'type' => 'list',
    ] );

Если вам нужна полностью индивидуальная разметка, вы можете попробовать установить параметр type на 'array' и затем создать что угодно с помощью цикла foreach.

документация: https://developer.wordpress.org/reference/functions/paginate_links/

Чтобы настроить разметку пагинации в WordPress так, чтобы она соответствовала желаемой структуре вашей темы (например, с использованием <ul><li></li></ul>), вы можете переопределить стандартную функцию пагинации, предоставленную WordPress. Вот как это можно сделать:

1. Используйте функцию paginate_links с пользовательским обратным вызовом
   Функция paginate_links() в WordPress позволяет вам настраивать HTML-структуру пагинации. Вы можете указать формат и обернуть ссылки пагинации в вашу желаемую разметку.

2. Создайте пользовательскую функцию пагинации
   Вы можете создать пользовательскую функцию пагинации в файле functions.php вашей темы, которая выводит пагинацию с вашей разметкой:

function custom_pagination() {
    global $wp_query;
    $big = 999999999; // нужен маловероятный целый 

    $pagination = paginate_links( array(
        'base'      => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
        'format'    => '?paged=%#%',
        'current'   => max( 1, get_query_var('paged') ),
        'total'     => $wp_query->max_num_pages,
        'type'      => 'array', // возвращает массив вместо строки
        'prev_text' => __('« Предыдущая'),
        'next_text' => __('Следующая »'),
    ) );

    if ( is_array( $pagination ) ) {
        echo '<ul class="custom-pagination">';
        foreach ( $pagination as $page ) {
            echo '<li>' . $page . '</li>';
        }
        echo '</ul>';
    }
}

3. Реализуйте пользовательскую пагинацию в вашей теме
   Как только функция определена, вам нужно вызвать её в шаблонных файлах вашей темы, где необходима пагинация. Обычно это index.php, archive.php, category.php или search.php.

Пример:

if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        // Ваш код цикла здесь
    endwhile;

    // Вызовите функцию пользовательской пагинации
    custom_pagination();

else :
    // Посты не найдены
endif;