Come modificare la classe page-numbers nella paginazione WordPress per Bootstrap
Sto utilizzando il seguente codice (da qui) per paginare i link:
function custom_pagination() {
global $wp_query;
$big = 999999999; // numero improbabilmente grande
$pages = 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,
'prev_next' => false,
'type' => 'array',
'prev_next' => TRUE,
'prev_text' => __('«'),
'next_text' => __('»'),
) );
if( is_array( $pages ) ) {
$paged = ( get_query_var('paged') == 0 ) ? 1 : get_query_var('paged');
echo '<ul class="pagination">';
foreach ( $pages as $page ) {
echo "<li>$page</li>";
}
echo '</ul>';
}
}
L'output di questo codice usando echo custom_pagination();
è:
<ul class="pagination">
<li class="page-item">
<a class="page-numbers" href="example.com/page/1">1</a>
</li>
</ul>
Come posso modificare l'output per ottenere questo risultato?:
<ul class="pagination">
<li class="page-item">
<a class="page-link" href="example.com/page/1">1</a>
</li>
</ul>
Sto cercando di creare un tema Bootstrap, ma non riesco a sostituire la classe page-numbers
con la classe Bootstrap page-link
.

La funzione paginate_links()
, situata in wp-includes/general-template.php
, non consente di personalizzare alcune parti dell'HTML (come la classe page-numbers
).
Una semplice sostituzione di stringa non funziona a causa del modo in cui vengono generate le classi, come evidenziato in questo estratto di codice da paginate_links()
:
$page_links[] = '<a class="prev page-numbers" href="' . esc_url( apply_filters( 'paginate_links', $link ) ) . '">' . $args['prev_text'] . '</a>';
endif;
for ( $n = 1; $n <= $total; $n++ ) :
if ( $n == $current ) :
$page_links[] = "<span class='page-numbers current'>" . $args['before_page_number'] . number_format_i18n( $n ) . $args['after_page_number'] . "</span>";
Ecco una versione aggiornata della tua funzione custom_pagination()
, che utilizza DOMXpath per trovare gli elementi con la classe page-numbers
, quindi viene eseguita una sostituzione di stringa per cambiare la classe in page-link
. Per una migliore compatibilità con Bootstrap, la classe current
viene anche sostituita con active
. Infine, class="mynewclass"
viene aggiunto al <li>
che contiene l'elemento corrente.
function wpse247219_custom_pagination() {
global $wp_query;
$big = 999999999; // serve un numero improbabile
$pages = 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,
'prev_next' => false,
'type' => 'array',
'prev_next' => true,
'prev_text' => __( '«', 'text-domain' ),
'next_text' => __( '»', 'text-domain'),
) );
$output = '';
if ( is_array( $pages ) ) {
$paged = ( get_query_var('paged') == 0 ) ? 1 : get_query_var( 'paged' );
$output .= '<ul class="pagination">';
foreach ( $pages as $page ) {
$output .= "<li>$page</li>";
}
$output .= '</ul>';
// Crea un'istanza di DOMDocument
$dom = new \DOMDocument();
// Popola $dom con $output, assicurandosi di gestire UTF-8, altrimenti
// si verificheranno problemi con i caratteri UTF-8.
$dom->loadHTML( mb_convert_encoding( $output, 'HTML-ENTITIES', 'UTF-8' ) );
// Crea un'istanza di DOMXpath e tutti gli elementi con la classe 'page-numbers'
$xpath = new \DOMXpath( $dom );
// http://stackoverflow.com/a/26126336/3059883
$page_numbers = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' page-numbers ')]" );
// Itera sul nodo $page_numbers...
foreach ( $page_numbers as $page_numbers_item ) {
// Aggiungi class="mynewclass" al <li> quando il suo figlio contiene l'elemento corrente.
$page_numbers_item_classes = explode( ' ', $page_numbers_item->attributes->item(0)->value );
if ( in_array( 'current', $page_numbers_item_classes ) ) {
$list_item_attr_class = $dom->createAttribute( 'class' );
$list_item_attr_class->value = 'mynewclass';
$page_numbers_item->parentNode->appendChild( $list_item_attr_class );
}
// Sostituisci la classe 'current' con 'active'
$page_numbers_item->attributes->item(0)->value = str_replace(
'current',
'active',
$page_numbers_item->attributes->item(0)->value );
// Sostituisci la classe 'page-numbers' con 'page-link'
$page_numbers_item->attributes->item(0)->value = str_replace(
'page-numbers',
'page-link',
$page_numbers_item->attributes->item(0)->value );
}
// Salva l'HTML aggiornato e restituiscilo.
$output = $dom->saveHTML();
}
return $output;
}
Utilizzo:
echo wpse247219_custom_pagination();
HTML generato:
<ul class="pagination">
<li class="mynewclass"><span class="page-link active">1</span></li>
<li><a class="page-link" href="http://localhost/page/2/">2</a></li>
<li><a class="page-link" href="http://localhost/page/3/">3</a></li>
<li><span class="page-link dots">…</span></li>
<li><a class="page-link" href="http://localhost/page/5/">5</a></li>
<li><a class="next page-link" href="http://localhost/page/2/">»</a></li>
</ul>

Questo codice funziona benissimo, ma un'ultima cosa, come potrei modificare anche "$page_links[] = "<span class='page-numbers current'>' "? Vorrei cambiare la classe da 'page-numbers current' a 'page-numbers active'

Sono contento che abbia funzionato! Ho aggiornato la mia risposta sostituendo current con active :-)

A dire il vero, c'è un modo per aggiungere una classe solo al <li> quando sono sul <span class="page-link active">1</span>? Ad esempio <li class='mynewclass'><span class="page-link active">1</span></li>.

È fattibile. Ho aggiornato la mia risposta in modo che l'elemento <li>
che contiene l'elemento corrente ottenga l'aggiunta della classe class="mynewclass"
.

Lavora su questo oggi, compatibile con WordPress 5.5.1 e Bootstrap 4:
<?php
$pagination = paginate_links( array(
'base' => str_replace( 999999999, '%#%', esc_url( get_pagenum_link( 999999999 ) ) ),
'format' => '?paged=%#%',
'current' => max( 1, get_query_var('paged') ),
'total' => $query_accueil->max_num_pages,
'prev_text' => '<i class="fas fa-angle-double-left"></i>',
'next_text' => '<i class="fas fa-angle-double-right"></i>',
'type' => 'array'
) );
?>
<?php if ( ! empty( $pagination ) ) : ?>
<nav aria-label="Navigazione tra le pagine">
<ul class="pagination">
<?php foreach ( $pagination as $key => $page_link ) : ?>
<li class="page-item
<?php
$link = htmlspecialchars($page_link);
$link = str_replace( ' current', '', $link);
if ( strpos( $page_link, 'current' ) !== false ) { echo ' active'; }
?>
">
<?php
if ( $link ) {
$link = str_replace( 'page-numbers', 'page-link', $link);
}
echo htmlspecialchars_decode($link);
?>
</li>
<?php endforeach ?>
</ul>
</nav>
<?php endif ?>

Analizzando questo, sembra che non ci sia un modo per passare una classe tramite la funzione paginate_links
. Quindi, basandomi sulla funzione custom_pagination
, ecco come la riscriverei:
function custom_pagination() {
global $wp_query;
// Non capisco perché questa riga fosse originariamente nell'if...
$paged = ( get_query_var('paged') ? get_query_var('paged') : 1 );
$big = 999999999; // serve un numero improbabilmente grande
$pages = paginate_links( array(
'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
'format' => '?paged=%#%',
'current' => $paged,
'total' => $wp_query->max_num_pages,
'prev_next' => false,
'type' => 'array',
'prev_next' => TRUE,
'prev_text' => __('«'),
'next_text' => __('»'),
) );
if( is_array( $pages ) ) {
echo '<ul class="pagination">' .
str_replace( 'class="page-numbers"', 'class="page-link"', implode( '', $pages ) .
'</ul>';
}
}
Non l'ho testato, fammi sapere se riscontri problemi.

Una soluzione più semplice utilizzando jQuery
jQuery(document).ready(function ($) {
$(".pagination .page-item .page-numbers").addClass("page-link");
$(".pagination .page-item .page-link").removeClass("page-numbers");
});
Lo stesso approccio può essere utilizzato per altre classi come current
ecc.

Sono consapevole che questa sia una domanda datata, ma la soluzione più semplice che ho trovato è utilizzare preg_replace
:
$pages = paginate_links( array(
... // i tuoi argomenti di paginazione esistenti
) );
$pages = preg_replace('/page-numbers/', 'page-link', $pages);
