Как отобразить пагинацию для WP_User_Query?

Вам действительно не стоит использовать ответ от Pippin. Этот запрос очень неэффективен. В примере $user_count_query может вернуть до 999,999 пользователей из вашей базы данных в скрипт, со всеми полями пользователей. Это почти наверняка приведёт к превышению лимитов памяти и/или времени выполнения PHP, если/когда ваш сайт вырастет достаточно большим.

Но в 2012 году это могло быть единственным решением.

Вот более правильный способ. В этом примере у меня есть только следующая и предыдущая страницы, но если вам нужна нумерованная пагинация, переменные для её реализации уже есть. Насколько мне известно, в WordPress нет встроенной функции пагинации, совместимой с WP_User_Query.

<?php

// Переменные пагинации
$current_page = get_query_var('paged') ? (int) get_query_var('paged') : 1;
$users_per_page = 2; // УВЕЛИЧЬТЕ ЭТО ЗНАЧЕНИЕ ПОСЛЕ ТЕСТИРОВАНИЯ ;)

$args = array(
    'number' => $users_per_page, // Сколько пользователей на странице
    'paged' => $current_page // Какую страницу получить, начиная с 1.
);

$users = new WP_User_Query( $args );

$total_users = $users->get_total(); // Общее количество пользователей (вне текущей страницы)
$num_pages = ceil($total_users / $users_per_page); // Сколько всего страниц с пользователями потребуется

?>
    <h3>Страница <?php echo $current_page; ?> из <?php echo $num_pages; ?></h3>
    <p>Отображается <?php echo $users_per_page; ?> из <?php echo $total_users; ?> пользователей</p>

    <table>
        <thead>
            <tr>
                <th>Имя</th>
                <th>Фамилия</th>
                <th>Email</th>
            </tr>
        </thead>

        <tbody>
            <?php
            if ( $users->get_results() ) foreach( $users->get_results() as $user )  {
                $firstname = $user->first_name;
                $lastname = $user->last_name;
                $email = $user->user_email;
                ?>
                <tr>
                    <td><?php echo esc_html($firstname); ?></td>
                    <td><?php echo esc_html($lastname); ?></td>
                    <td><?php echo esc_html($email); ?></td>
                </tr>
                <?php
            }
            ?>
        </tbody>
    </table>

    <p>
        <?php
        // Предыдущая страница
        if ( $current_page > 1 ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page-1)) .'">Предыдущая страница</a>';
        }

        // Следующая страница
        if ( $current_page < $num_pages ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page+1)) .'">Следующая страница</a>';
        }
        ?>
    </p>

Пример, показывающий страницу 2:

Обновление 8.06.2018: Как добавить номера страниц вместо "Следующая/Предыдущая"

Если вы хотите иметь нумерацию страниц вместо ссылок "Следующая/Предыдущая", вот как это можно реализовать. Обратите внимание, что вам нужно будет заменить номера на ссылки страниц, в этом примере они не кликабельны (основано на https://stackoverflow.com/a/11274294/470480, модифицировано для отображения постоянного количества средних номеров и без добавления "..." если страницы не пропущены).

Вы также можете посмотреть мой gist-файл, который содержит переиспользуемую функцию для этой цели.

$current_page = 5; // Пример
$num_pages = 10; // Пример

$edge_number_count = 2; // Можно изменить, необязательно

$start_number = $current_page - $edge_number_count;
$end_number = $current_page + $edge_number_count;

// Минус один, чтобы не разделять начальный номер без необходимости, например: "1 ... 2 3" должно начинаться как "1 2 3"
if ( ($start_number - 1) < 1 ) {
    $start_number = 1;
    $end_number = min($num_pages, $start_number + ($edge_number_count*2));
}

// Плюс один, чтобы не разделять конечный номер без необходимости, например: "8 9 ... 10" должно оставаться "8 9 10"
if ( ($end_number + 1) > $num_pages ) {
    $end_number = $num_pages;
    $start_number = max(1, $num_pages - ($edge_number_count*2));
}

if ($start_number > 1) echo " 1 ... ";

for($i=$start_number; $i<=$end_number; $i++) {
    if ( $i === $current_page ) echo " [{$i}] ";
    else echo " {$i} ";
}

if ($end_number < $num_pages) echo " ... {$num_pages} ";

Вывод (со страницы 1 по 10):

[1]  2  3  4  5  ... 10 
1  [2]  3  4  5  ... 10 
1  2  [3]  4  5  ... 10 
1  2  3  [4]  5  ... 10 

1 ...  3  4  [5]  6  7  ... 10 
1 ...  4  5  [6]  7  8  ... 10 

1 ...  6  [7]  8  9  10
1 ...  6  7  [8]  9  10
1 ...  6  7  8  [9]  10
1 ...  6  7  8  9  [10]

Полная заслуга принадлежит @radley-sustaire за его ответ, но я заметил небольшую ошибку в нем, поэтому делюсь своей версией ответа здесь.

В моей версии я также фильтровал результаты по местоположению, ключевым словам и т.д., поэтому на некоторых страницах было меньше результатов, чем указано в переменной '$users_per_page'. Например, если у меня было установлено отображать 10 пользователей на странице, но результаты фильтра возвращали только 3 пользователя, вверху страницы появлялось сообщение "Displaying 10 of 3 users". Очевидно, это не имело смысла, поэтому я добавил простое условие "if" для проверки, является ли количество результатов больше переменной '$users_per_page'.

Radley, если ты отредактируешь свой ответ с этим обновлением, я с радостью проголосую за него как за правильный ответ, так как считаю его лучше решения Pippin.

Вот окончательный код для тех, кому он нужен.

<?php

// Переменные пагинации
$current_page = get_query_var('paged') ? (int) get_query_var('paged') : 1;
$users_per_page = 10;

$args = array(
    'number' => $users_per_page, // Сколько показывать на странице
    'paged' => $current_page // Какую страницу получать, начиная с 1.
);

$users = new WP_User_Query( $args );

$total_users = $users->get_total(); // Общее количество пользователей (за пределами текущей страницы)
$num_pages = ceil($total_users / $users_per_page); // Сколько страниц с пользователями нам понадобится

if ($total_users < $users_per_page) {$users_per_page = $total_users;}

?>
    <h3>Страница <?php echo $current_page; ?> из <?php echo $num_pages; ?></h3>
    <p>Показано <?php echo $users_per_page; ?> из <?php echo $total_users; ?> пользователей</p>

    <table>
        <thead>
            <tr>
                <th>Имя</th>
                <th>Фамилия</th>
                <th>Email</th>
            </tr>
        </thead>

        <tbody>
            <?php
            if ( $users->get_results() ) foreach( $users->get_results() as $user )  {
                $firstname = $user->first_name;
                $lastname = $user->last_name;
                $email = $user->user_email;
                ?>
                <tr>
                    <td><?php echo esc_html($firstname); ?></td>
                    <td><?php echo esc_html($lastname); ?></td>
                    <td><?php echo esc_html($email); ?></td>
                </tr>
                <?php
            }
            ?>
        </tbody>
    </table>

    <p>
        <?php
        // Предыдущая страница
        if ( $current_page > 1 ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page-1)) .'">Предыдущая страница</a>';
        }

        // Следующая страница
        if ( $current_page < $num_pages ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page+1)) .'">Следующая страница</a>';
        }
        ?>
    </p>