WP-PageNavi

Descrizione

Vuoi sostituire i vecchi ← Older posts | Newer posts → con quale link di pagina?

Questo plugin fornisce il tag wp_pagenavi() che genera link di impaginazione fantasiosi.

Utilizzo

Nel tuo tema devi trovare e sostituire le chiamate a next_posts_link() e previous_posts_link().

Nel tema Twentyten è così:

<div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">&larr;</span> Older posts', 'twentyten' ) ); ?></div>
<div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">&rarr;</span>', 'twentyten' ) ); ?></div>

Dovrai sostituire quelle due linee con queste:

<?php wp_pagenavi(); ?>

Per le pagine con più parti il tuo codice dovrà essere come questo:

<?php wp_link_pages( ... ); ?>

e sostituiscilo con questo:

<?php wp_pagenavi( array( 'type' => 'multipart' ) ); ?>

Per la configurazione vai a WP-Admin -> Impostazioni -> PageNavi.

Modificare i CSS

Se hai bisogno di configurare i CSS di WP-PageNavi puoi copiare il file pagenavi-css.css dalla directory del plugin nella directory del tuo tema e fare le tue modifiche da lì. In questo modo non perderai le modifiche quando aggiornerai il plugin.

In alternativa puoi togliere la spunta dall’opzione “Usa pagenavi.css” nella pagina delle impostazioni e aggiungere gli stili direttamente nel file style.css del tuo tema.

Modificare i nomi delle classi

Esistono dei filtri che puoi utilizzare per cambiare i nomi della classe predefinita assegnati agli elementi della navigazione di pagina.

Filtri

• wp_pagenavi_class_pages
• wp_pagenavi_class_first
• wp_pagenavi_class_previouspostslink
• wp_pagenavi_class_extend
• wp_pagenavi_class_smaller
• wp_pagenavi_class_page
• wp_pagenavi_class_current
• wp_pagenavi_class_larger
• wp_pagenavi_class_nextpostslink
• wp_pagenavi_class_last

Utilizzo del filtro.

// Simple Usage - 1 callback per filter
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_previouspostslink_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_nextpostslink_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_page_class');

function theme_pagination_previouspostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--previous';
}

function theme_pagination_nextpostslink_class($class_name) {
  return 'pagination__control-link pagination__control-link--next';
}

function theme_pagination_page_class($class_name) {
  return 'pagination__current-page';
}


// More Concise Usage - 1 callback for all filters
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_class');
add_filter('wp_pagenavi_class_page', 'theme_pagination_class');

function theme_pagination_class($class_name) {
  switch($class_name) {
    case 'previouspostslink':
      $class_name = 'pagination__control-link pagination__control-link--previous';
      break;
    case 'nextpostslink':
      $class_name = 'pagination__control-link pagination__control-link--next';
      break;
    case 'page':
      $class_name = 'pagination__current'
      break;
  }
  return $class_name;
}

Sviluppo

• https://github.com/lesterchan/wp-pagenavi

Riconoscimenti

• Icona del plugin realizzata da SimpleIcon da Flaticon

Donazioni

Ho passato molto del mio tempo libero creando, aggiornando, manutenendo e dando supporto per questi plugin. Se davvero ami i miei plugin e vuoi donare qualcosa lo apprezzerò.
Sentiti libero di usarlo senza nessun obbligo.