Aldolat.it — Post con tag Pagina

Query personalizzate e paginazione dei post

aldolat@gmail.com (Aldo Latino) — Mon, 09 Apr 2012 20:26:05 +0000

Avete creato un query personalizzata per tirare fuori dal database tutti i vostri post archiviati sotto un certa categoria. I post sono circa 200 e per evitare di caricare una pagina con così tanti articoli decidete saggiamente che sarebbe bene mostrarne un certo quantitativo per pagina o, magari, tanti quanti avete scelto di mostrarne nelle preferenze di WordPress. Subito dopo il loop, quindi, inserite la riga:

next_posts_link( "Pagina precedente" );

e poi questa:

previous_posts_link( "Pagina successiva" );

Però vi accorgete che i link non appaiono.

Questione di query

Il motivo è presto detto. Quando in una pagina statica (cioè una pagina creata ad hoc) create una nuova query, abbiate presente che esiste già una query principale che popola la variabile globale $wp_query. In questa variabile, nel nostro caso della pagina statica creata appositamente, andranno le informazioni inerenti questa, come la data di creazione, il suo nome, il suo contenuto e tante altre. Le funzioni citate nelle due righe di sopra fanno riferimento proprio a questa variabile, infischiandosene della variabile popolata dalla query personalizzata.

Il punto sta, quindi, nel collegare le due funzioni poc’anzi citate alla query personalizzata. Lo si fa usando il secondo parametro che le due funzioni mettono a disposizione:

next_posts_link( $label, $max_pages );
previous_posts_link( $label, $max_pages );

Quel $max_pages quindi diventerà:

next_posts_link( "Pagina precedente", $mia_variabile->max_num_pages );
previous_posts_link( "Pagina successiva", $mia_variabile->max_num_pages );

Quel $mia_variabile è la variabile utilizzata per creare la query personalizzata, quella cioè che conterrà tutti i post e le loro informazioni, come ad esempio:

$mia_variabile = new WP_Query( $args );

Ma non finisce qui

Dopo aver collegato correttamente la funzione per la visualizzazione dei link alle pagine successiva e precedente, vi accorgete che la pagina 2 visualizza i post della prima, la 3 pure e così via.

Quest’altro punto va risolto aggiungendo un’ulteriore riga tra gli argomenti della query. Ad esempio:

$args = array(
  'category_name'  => 'mie-ricette',
  'tag'            => 'le-regionali',
  'posts_per_page' => 10,
  'orderby'        => 'date',
  'order'          => 'DESC',
  'paged'          => get_query_var( 'paged' )
);

$mia_variabile = new WP_Query( $args );

La riga che ci interessa è la 7. Con quella riga diciamo a WordPress di visualizzare la pagina (paged) X che gli è stata fornita quando abbiamo fatto clic sul link Pagina successiva (o precedente). Altrimenti per lui paged sarà sempre quello della prima.

Un esempio di tutto quanto fin qui detto lo trovate nelle mie pagine Featured posts, Guide su GNU/Linux e Guide su WordPress.

Note finali

1. Se volete che i post visualizzati in ogni pagina siano tanti quanti avete deciso nelle preferenze di WordPress, sostituite la riga 4 con questa:

'posts_per_page' => get_option( 'posts_per_page' ),

che va a prelevarsi proprio il valore impostato.

2. Se volete, poi, che l’output di next_posts_link venga inserito in una variabile anziché visualizzato, utilizzate get_next_posts_link e get_previous_posts_link.

3. se utilizzate il plugin WP-PageNavi, sappiate che anch’esso può essere reindirizzato sulla query personalizzata in questo modo:

wp_pagenavi( array( "query" => $mia_variabile ) );

4. Come rilevato nei commenti a questo post e come descritto nel Codex, se la pagina statica è usata anche come homepage, le righe contenenti gli argomenti vanno modificate in tal senso:

$paged = ( get_query_var( 'page' ) ) ? get_query_var( 'page' ) : 1;
$args = array(
  'category_name'  => 'mie-ricette',
  'tag'            => 'le-regionali',
  'posts_per_page' => 10,
  'orderby'        => 'date',
  'order'          => 'DESC',
  'paged'          => $paged
)

Grazie a Jonathan per la segnalazione.

Per approfondire

La classe WP_Query
Cosa è il Loop?
La funzione next posts link nel Codex
La funzione previous posts link nel Codex
Il codice della funzione get_next_posts_link
Il mio breve articolo sulle variabili di pagina
Jeff Starr, Definitive Guide to WordPress Page Navigation
WPCanyon, Solution if previous_posts_link() and next_posts_link() are not working

L'articolo Query personalizzate e paginazione dei post è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Le variabili relative alle pagine in WordPress

aldolat@gmail.com (Aldo Latino) — Thu, 28 Jul 2011 09:28:02 +0000

Visto che per l’ennesima volta mi sono scordato di appuntarmi in Tomboy il contenuto di queste variabili, lo faccio adesso anche sul blog, così magari vi tornano utili.

Si tratta di alcune variabili globali di WordPress relative alla paginazione di post (quando leggete “post” intendo dire articolo e pagina statica) e di pagine d’archivio. Trovate segnalato se la variabile va usata all’interno del loop; per dichiararla globale si usa global $variabile;.

Variabili globali di post e pagina

$multipage
Dice se un post è suddiviso in più pagine o no. Va usata nel loop.
Ad esempio, se un post è suddiviso in 5 pagine, il valore sarà true.

$numpages
Contiene il numero di pagine di un post suddiviso in più pagine. Va usata nel loop.
Ad esempio, se un post è suddiviso in 5 pagine, il valore sarà 5.

$page
Contiene il numero di pagina visualizzata di un post suddiviso in più pagine.
Ad esempio, se stiamo visualizzando la pagina 3 di un post suddiviso in 5 pagine, il valore sarà 3.

$pages
È un array contenente tanti elementi quante sono le pagine di un post. Va usato nel loop.
Ad esempio, se un post è suddiviso in 3 pagine, l’array conterrà 3 elementi (0, 1, 2) e ciascun elemento conterrà una parte del post.

Variabili globali d’archivio

$paged
Contiene il numero di pagina visualizzata di un archivio.
Ad esempio, se stiamo vedendo la pagina 5 dell’archivio del tag “wordpress”, il valore sarà 5.

$wp_query->max_num_pages
Contiene il numero totale di pagine in cui un archivio è suddiviso. Non è una variabile globale, ma un elemento dell’array $wp_query, che quindi andrà dichiarato globalmente (global $wp_query;)
Ad esempio, se abbiamo impostato WordPress per mostrare 5 post per pagina e abbiamo 20 post con tag “wordpress”, il valore sarà 4 per la pagina d’archivio del tag “wordpress”.

L'articolo Le variabili relative alle pagine in WordPress è uno scritto di aldolat.it. Rispettane le condizioni di licenza.

Visualizzare il numero di pagina nell’elemento title

aldolat@gmail.com (Aldo Latino) — Sat, 24 Apr 2010 15:02:05 +0000

Qualche giorno fa un utente del mio forum mi ha chiesto di aiutarlo a inserire nell’elemento title della pagina, qualora il post di WordPress o la pagina “statica” fosse suddivisa su più pagine, il numero di pagina attualmente visualizzata: in altre parole, avere un titolo di questo tipo “Titolo della pagina — Pagina 7”. Mentre era riuscito a farlo con le pagine di archivio, non aveva avuto altrettanto successo con quelle dei post (e, aggiungo io, con quelle delle pagine statiche).

Il motivo è semplice: la variabile $paged, che contiene il numero di pagina attualmente visualizzata, è attiva nella home e nell’archivio, cioè data, autore, categoria, tag; per i post e le pagine che si estendono su più pagine bisogna usarne un’altra: la semplice $page.

La richiesta del lettore è stata molto istruttiva per me e il merito di questo post, dunque, va dato a lui, che ringrazio per avermi spinto ad analizzare questa faccenda e a farmi entrare nei meandri di /wp-includes/post-template.php. Ho anche approfittato dell’occasione per implementare questa soluzione in Ubuntu block notes, che in questo articolo vi mostro.

Inserire il numero di pagina attuale nell’elemento title

Di solito nel file header.php troviamo che il tag title è generato da una riga simile:

<title>
  <?php wp_title('&laquo;', true, 'right'); ?> <?php bloginfo('name'); ?>
</title>

che ci restituisce:

<title>Titolo del post < Titolo del blog</title>

o, se siamo in un archivio di categoria, sarà:

<title>Nome categoria < Titolo del blog</title>

Questa soluzione, però, può essere migliorata dando al lettore altre informazioni più chiare e dettagliate. Credo che anche dal punto di vista SEO si abbiano miglioramenti, ma non ho verificato.

Nel mio header.php la semplice riga è stata sostituita con le seguenti, che differenziano il titolo ogni volta che si accede a un determinato tipo di pagina: articolo, pagina statica, archivio. Ecco le righe:

 1<title>
 2 <?php
 3  /**
 4   * Prepara il titolo della pagina a seconda del tipo
 5   * Stampa anche il numero di pagina a partire dalla seconda
 6   *
 7   * $paged contiene l'attuale numero di pagina nella home e nell'archivio
 8   * $page  contiene l'attuale numero di pagina di un articolo multipagine o di una pagina multipagine
 9   *
10   */
11  if (is_home()) {
12    echo 'Home';
13    // Si può usare `if (is_paged())` oppure `if ($paged)` oppure `if ($paged > 1)`
14    // Nella prima pagina di una serie, $paged è sempre 0
15    if ($paged) { echo ' | Pagina '.$paged; }
16  } elseif (is_category()) {
17    echo 'Archivio della categoria &laquo;'.single_cat_title('', false).'&raquo;';
18    if ($paged) { echo ' | Pagina '.$paged; }
19  } elseif (is_tag()) {
20    echo 'Archivio del tag &laquo;'.single_tag_title('', false).'&raquo;';
21    if ($paged) { echo ' | Pagina '.$paged; }
22  } elseif (is_day()) {
23    echo 'Archivio del '.get_the_time('j F Y');
24    if ($paged) { echo ' | Pagina '.$paged; }
25  } elseif (is_month()) {
26    echo 'Archivio di '.get_the_time('F Y');
27    if ($paged) { echo ' | Pagina '.$paged; }
28  } elseif (is_year()) {
29    echo 'Archivio per l\'anno '.get_the_time('Y');
30    if ($paged) { echo ' | Pagina '.$paged; }
31  } elseif (is_author()) {
32    $author = $wp_query->get_queried_object();
33    echo 'Archivio di '.$author->display_name;
34  if ($paged) { echo ' | Pagina '.$paged; }
35    } elseif (is_search()) {
36    echo 'Risultati della ricerca di &laquo;'.wp_specialchars($s).'&raquo;';
37  if ($paged) { echo ' | Pagina '.$paged; }
38    } elseif (is_404()) {
39    echo 'Errore 404: Non trovato';
40  } elseif (is_single() || is_page()) {
41    wp_title('');
42    // qui non si può usare $paged: si usa $page al suo posto
43    if ($page) { echo ' | Pagina '.$page; }
44  }
45  echo ' &lsaquo; '.get_bloginfo('name');
46 ?>
47</title>

Ci sono dei commenti nel codice: penso siano chiari.

Provate, ora, a dare un’occhiata al titolo pagina della pagina 2 del blog: mentre nella 1 (la homepage) il numero non viene stampato, lo vediamo dalla 2 in poi; così anche date un’occhiata alla categoria WordPress, al tag Guide del blog, a un archivio basato su anno o su ricerca.

Date ora uno sguardo a un post suddiviso su più pagine: il title presenta solo il titolo dell’articolo più il nome del blog, mentre nella pagina 2 vediamo scritto anche il numero.

Specificare anche il numero totale di pagine

E se volessimo aggiungere anche il numero complessivo delle pagine, nella forma: “Pagina 3 di 10”?

Anche in questo caso dovremmo distinguere se si tratta di Home/Archivio e di Post/Pagina. Nel primo caso useremmo:

if ($paged) { echo ' | Pagina '.$paged.' di '.$wp_query->max_num_pages; }

mentre nel secondo dobbiamo agire diversamente perché non abbiamo una variabile diretta fuori dal loop:

global $page;
$pages = count( explode( '<!--nextpage-->', $wp_query->post->post_content ) );
if ($page) { echo ' | Pagina '.$page.' di '.$pages; }

Usare queste forme in altre parti del tema

Chiaramente questa soluzione può essere usata altrove. Io l’ho fatto nel template single.php nel caso il post sia suddiviso su più pagine: a lato del testo appare la dicitura che restituisce le informazioni. L’ho usata anche nelle ricerche che si estendono su più pagine e anche nelle pagine d’archivio: penso sia un servizio in più che si fornisce al lettore.

Mi fermo qui, con la promessa di scrivere qualcosa di più dettagliato su questo argomento e anche su come ho agito per personalizzare il mio archivio e le informazioni che ne escono.

L'articolo Visualizzare il numero di pagina nell’elemento title è uno scritto di aldolat.it. Rispettane le condizioni di licenza.