In questa lezione del tutorial sul tema WordPress per principianti entreremo nel dettaglio del "ciclo dei post" in WordPress; cos’è, come appare, perché lo usiamo e come accedere ai post. Passeremo quindi all’implementazione del loop nel nostro tema.
Il ciclo della posta
Se hai familiarità con PHP potresti riconoscere che un "loop" è una tecnica per passare attraverso ogni elemento in un array o oggetto con for, foreacho while. Il ciclo in WordPress funziona proprio così. Ma utilizzeremo le funzioni proprie di WordPress per eseguire il loop al fine di ottenere alcuni vantaggi e semplificazioni aggiuntivi.
In ogni momento, WordPress ha già interrogato i post per te, a seconda della pagina in cui ti trovi. Se ti trovi in una pagina di categoria, WordPress ha già interrogato tutti i post associati a questa categoria, e se ti trovi in una singola pagina di post, WordPress ha già recuperato quel post per te.
Quando vogliamo accedere ai post che WordPress ha interrogato nei nostri modelli, aggiungiamo il loop. All’interno del loop abbiamo accesso a ogni post. E per ogni post decidiamo cosa mostrare o fare.
Nota: anche nei modelli di post singolo o pagina singola aggiungerai un loop, anche se sappiamo che contiene solo un post! Il ciclo viene eseguito solo una volta.
Ecco il ciclo di WordPress in tutto il suo splendore:
while (have_posts()): the_post();
// Access to each post here
endwhile;Questo pezzo di codice fa due cose. La whileparte (incluso il endwhile) è la parte in loop che verrà ripetuta per quanto tempo rimangano dei post. La seconda parte è quella the_post()che imposta un accesso semplificato e intuitivo all’oggetto post all’interno del loop. Ne sapremo di più in seguito.
È buona norma racchiudere il ciclo all’interno di un ifcontrollo che controlla se ci sono effettivamente dei post da scorrere. Quindi possiamo anche facoltativamente mostrare un messaggio se non ci fosse. La query del post potrebbe essere vuota se si passa a un archivio di categorie vuoto o si tenta di cercare qualcosa che non ha risultati. Questa è una versione migliore del ciclo:
Prendi familiarità con questo pezzo di codice poiché lo ripeterai ogni volta che vorrai accedere ai post! Implementiamo il ciclo nel nostro tema.
Implementazione del ciclo nel nostro tema
Aggiungiamo il ciclo nel nostro index.php, sostituendo il testo fittizio.
Ho aggiunto una funzione chiamata the_title()all’interno del ciclo che fa eco al titolo del post. Questo è solo per quello che possiamo vedere il ciclo in pratica. Non preoccuparti, nel passaggio successivo impareremo tutto sull’accesso a tutte le informazioni sul post effettivo.
Vediamo cosa succede in WordPress ora. Aggiorna la prima pagina. A seconda delle tue impostazioni e dei tuoi contenuti dovresti vedere apparire alcuni titoli. Nel mio WordPress ho il post predefinito "Hello world!" e un altro post che ho creato intitolato "Questo è un altro post". Questo è quello che ottengo in prima pagina:
Se provi a visitare una singola pagina di post, dovresti vedere solo un titolo, il titolo del post che stai visualizzando. Simpatico!
Per i curiosi…
Se sei curioso di sapere quale ciclo sta attraversando e quali parametri WordPress ha utilizzato per questa query, puoi verificarlo. La variabile globale a cui si riferisce il ciclo si chiama $wp_query. È necessario definirlo globale per accedervi. Prova a utilizzare var_dump()per stamparne l’intero contenuto. Il ciclo sta attraversando la $wp_query->postsproprietà.
global $wp_query;
var_dump($wp_query);Aggiungiamo un dettaglio importante al nostro loop in index.php; un modo per l’utente di passare alla pagina successiva e precedente dei post.
Tieni presente che il ciclo recupererà il numero di post definito nelle tue Impostazioni di WordPress > Lettura, ogni volta che ti trovi in una pagina che mostra più post. Se ci sono più post disponibili nel loop rispetto al numero qui definito, abbiamo bisogno di un modo per navigare tra le pagine. Per questo possiamo usare la funzione the_posts_pagination().
Questa funzione accetta alcuni parametri per personalizzarne l’output. È possibile definire il numero di pagine tra i puntini di sospensione (quando sono presenti molte pagine). Puoi anche definire quali dovrebbero essere i testi per i collegamenti alla pagina "Precedente" e "Avanti". Lo aggiungerò senza alcun parametro per eseguire le impostazioni predefinite, ma puoi regolarlo se lo desideri.
...
while (have_posts()): the_post();
the_title();
endwhile;
the_posts_pagination();
} else {
...Questa funzione non produce assolutamente nulla se ci sono post inferiori o uguali al numero di post per impostazione di pagina. Quindi non preoccuparti se pensi di aver sbagliato perché non vedi alcun output. Una volta che ci sono più post che post per pagina, questa funzione genera un div, un’intestazione per i lettori di schermo (che in genere nascondi con CSS) e una serie di collegamenti di impaginazione.
Ora che sappiamo come accedere a qualsiasi post che WordPress ha trovato per noi, il passo successivo è imparare come mostrare ciò che vogliamo da ogni post; all’interno del ciclo.