Come mostrare i link di paginazione per WP_User_Query?

Non dovresti davvero utilizzare la risposta di Pippin. La query è molto inefficiente. $user_count_query nell'esempio può restituire fino a 999.999 utenti dal tuo database al tuo script, con tutti i campi degli utenti. Questo sicuramente raggiungerà i limiti di memoria e/o tempo per PHP se/quando il tuo sito crescerà abbastanza.

Ma quella potrebbe essere stata l'unica soluzione nel 2012.

Ecco un modo migliore per farlo. In questo esempio ho solo pagina successiva e precedente ma se hai bisogno di una paginazione numerata, le variabili sono presenti per costruirla. WordPress non ha una funzione di paginazione compatibile con WP_User_Query (per quanto ne so).

<?php

// Variabili per la paginazione
$current_page = get_query_var('paged') ? (int) get_query_var('paged') : 1;
$users_per_page = 2; // AUMENTA QUESTO DOPO I TEST ;)

$args = array(
    'number' => $users_per_page, // Quanti per pagina
    'paged' => $current_page // Quale pagina ottenere, partendo da 1.
);

$users = new WP_User_Query( $args );

$total_users = $users->get_total(); // Quanti utenti abbiamo in totale (oltre la pagina corrente)
$num_pages = ceil($total_users / $users_per_page); // Quante pagine di utenti ci serviranno

?>
    <h3>Pagina <?php echo $current_page; ?> di <?php echo $num_pages; ?></h3>
    <p>Visualizzazione di <?php echo $users_per_page; ?> su <?php echo $total_users; ?> utenti</p>

    <table>
        <thead>
            <tr>
                <th>Nome</th>
                <th>Cognome</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
        // Pagina precedente
        if ( $current_page > 1 ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page-1)) .'">Pagina Precedente</a>';
        }

        // Pagina successiva
        if ( $current_page < $num_pages ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page+1)) .'">Pagina Successiva</a>';
        }
        ?>
    </p>

Esempio che mostra la pagina 2:

Aggiornamento 8/6/2018: Come aggiungere numeri di pagina invece di Successiva/Precedente

Se vuoi avere numeri di pagina invece di link per pagina successiva/precedente, ecco come puoi configurarlo. Nota che dovrai sostituire i numeri con link alle pagine, non saranno cliccabili in questo esempio (basato su https://stackoverflow.com/a/11274294/470480, modificato per mostrare una quantità consistente di numeri centrali e non aggiungere "..." a meno che una pagina non sia effettivamente saltata).

Puoi anche vedere il mio file gist che contiene una funzione riutilizzabile per questo scopo.

$current_page = 5; // Esempio
$num_pages = 10; // Esempio

$edge_number_count = 2; // Modifica questo, opzionale

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

// Meno uno così da non dividere inutilmente il numero iniziale, es: "1 ... 2 3" dovrebbe iniziare come "1 2 3"
if ( ($start_number - 1) < 1 ) {
    $start_number = 1;
    $end_number = min($num_pages, $start_number + ($edge_number_count*2));
}

// Più uno così da non dividere inutilmente il numero finale, es: "8 9 ... 10" dovrebbe rimanere "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} ";

Output (dalla pagina 1 a 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]

Il merito completo dovrebbe andare a @radley-sustaire per la sua risposta, ma ho notato un piccolo problema nella sua soluzione, quindi condivido qui la mia versione.

Nella mia versione stavo anche filtrando i risultati per località, parole chiave ecc., quindi alcune pagine avevano meno risultati della variabile '$users_per_page'. Ad esempio, se avevo impostato di mostrare 10 utenti per pagina, ma il filtro restituiva solo 3 utenti, ottenevo "Visualizzazione di 10 su 3 utenti" in cima alla pagina. Ovviamente non aveva senso, quindi ho aggiunto un semplice controllo "if" per verificare se il conteggio dei risultati fosse maggiore della variabile '$users_per_page'.

Radley, se modificherai la tua risposta con questo aggiornamento, voterò volentieri per te come risposta corretta, poiché penso sia migliore della soluzione di Pippin.

Ecco il codice finale per chiunque ne abbia bisogno.

<?php

// Variabili per la paginazione
$current_page = get_query_var('paged') ? (int) get_query_var('paged') : 1;
$users_per_page = 10;

$args = array(
    'number' => $users_per_page, // Quanti utenti per pagina
    'paged' => $current_page // Quale pagina ottenere, partendo da 1.
);

$users = new WP_User_Query( $args );

$total_users = $users->get_total(); // Quanti utenti abbiamo in totale (oltre la pagina corrente)
$num_pages = ceil($total_users / $users_per_page); // Quante pagine di utenti saranno necessarie

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

?>
    <h3>Pagina <?php echo $current_page; ?> di <?php echo $num_pages; ?></h3>
    <p>Visualizzazione di <?php echo $users_per_page; ?> su <?php echo $total_users; ?> utenti</p>

    <table>
        <thead>
            <tr>
                <th>Nome</th>
                <th>Cognome</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
        // Pagina precedente
        if ( $current_page > 1 ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page-1)) .'">Pagina Precedente</a>';
        }

        // Pagina successiva
        if ( $current_page < $num_pages ) {
            echo '<a href="'. add_query_arg(array('paged' => $current_page+1)) .'">Pagina Successiva</a>';
        }
        ?>
    </p>