Nonostante ci siano un po’ di ottimi plugin per la gestione e la stampa dei “featured posts” ho sviluppato questo mio plugin che, credo, sia diverso dai plugin in circolazione e per certi versi offra una gestione più user friendly. Probabilmente questo sarà un giudizio soggettivo… In pratica, ci sono alcuni plugin che permettono di inserire gli id dei post, separati da virgole, in una casella di testo. Il mio plugin legge i “custom fields” (in italiano “campo personalizzati”) dei post che si decide di mettere in evidenza. In questo senso credo che impostare un campo personalizzato sia un po’ più user friendly rispetto all’aver a che fare con insiemi di numeri. Secondo te?

Per gli impazienti

Per iniziare a utilizzare il plugin:

1. effettua il download: http://download.jblog.it/wp-plugins/jblog_featured_posts.zip
2. copialo nella directory “plugins” e attivalo
3. inserisci la funzione jblog_print_featured_posts() nel punto del template in cui vuoi stampare la lista dei post in evidenza

Per far comparire un determinato post fra i post in evidenza è necessario entrare nella pagina di editing dell’articolo e inserire un campo personalizzato di nome “featured” con il valore “ok” o uno qualsiasi. Il valore non incide sul funzionamento del plugin. Tuttavia consiglio di inserire il valore “ok” in modo da beneficiare di futuri aggiornamenti in cui eventualmente verrà utilizzato.

In profondità

Il plugin è composto da due funzioni:

• jblog_getFeaturedPosts seleziona i post e li restituisce in un array, ordinati dal più recente al più vecchio
• jblog_printFeaturedPosts seleziona i post e li stampa sottoforma di lista <ul>…<li>

jblog_getFeaturedPosts

Questa funzione è il cuore del plugin. Seleziona i post e li restituisce in un array. In questo modo potrai essere libero di gestire e stampare i dati restituiti come più ti piace.

La funzione ha 2 argomenti:

• $args [default "limit=10&len=0"] è una stringa in cui vengono passate le opzioni (nella forma [opzione]=[valore]) separate da “&”. Le uniche due opzioni sono limit (-1 per stampare tutti i post in evidenza, un numero maggiore di 0 per stampare un numero limitato di post) e len per la lunghezza del contenuto (per non selezionare il contenuto basta impostarlo con zero o non impostarla affatto)
• $metakey [default "featured"] è una stringa utilizzata per impostare il nome del campo personalizzato utilizzato per indicare che il post deve esser messo in evidenza

Esempio

$myarray = jblog_getFeaturedPosts("limit=-1&len=150","myfeatured");

• $myarray è l’array in cui verranno restituiti i post
• limit=-1 fa in modo che si selezionino tutti i post che hanno il campo “myfeatured”
• len=150 imposta il numero di caratteri del contenuto da restituire
• “myfeatured” è il campo personalizzato utilizzato per indicare che il post deve esser messo in evidenza

L’array restituito dalla funzione è composto dai post selezionati, ordinati dal più recente al più vecchio. Ogni elemento dell’array è a sua volta un array associativo contenente le informazioni del singolo post divise in corrispondenza degli indici “id”, “title”, “link” e “content”.

Esempio

Un semplice esempio per la stampa delle informazioni di ogni singolo post selezionato.

// Seleziona i post
$posts_array = jblog_getFeaturedPosts("limit=20&len=300","myfeatured");

// Ciclo: stampa le informazioni di ogni singolo post
foreach($posts_array as $post)
{
     echo "ID: ".$post['id'];
     echo "Titolo: ".$post['title'];
     echo "Link: ".$post['link'];
     echo "Contenuto: ".$post['content'];
}

jblog_printFeaturedPosts

Oltre a selezionare i post in evidenza, li stampa in una lista del tipo <ul>…<li>.

Gli argomenti sono gli stessi della funzione jblog_getFeaturedPosts (vedi sopra).

Esempio

Questa funzione va utilizzata direttamente all’interno del template inserendo la riga seguente nel punto in cui si desidera visualizzare la lista.

<? jblog_printFeaturedPosts("limit=-1&len=100") ?>

Come impostare un post “in evidenza”

Questo se vogliamo è il lato del plugin un po’ più “macchinoso”.

Per fare in modo che un post venga stampato nella lista dei post in evidenza è necessario andare nella pagina di editing dell’articolo e creare un “custom field” (o campo personalizzato) di nome “featured” oppure uguale all’argomento $metakey passato alle funzioni.

Come valore scrivere una cosa qualsiasi. Tuttavia consiglio di inserire il valore “ok” in modo da beneficiare di futuri aggiornamenti in cui eventualmente verrà utilizzato. Il valore non incide sul funzionamento del plugin, ma è necessario dato che wordpress non permette la creazione di un campo personalizzato senza un valore.

HTML e utilizzo dei CSS

Se utilizzi la funzione jblog_printFeaturedPosts ecco le informazioni che ti servono per poter formattare adeguatamente la lista dei post.

• Per formattare il contenitore principale della lista (<ul>) fare riferimento all’id “featured_posts”
• Ad ogni contenitore del singolo post (<li>) viene attribuito l’id “featured_post_” al quale viene aggiunto in coda l’id del post
• Il titolo di ogni post viene inserito all’interno di un tag <a>, il cui attributo href sarà impostato con il link del post
• Il contenuto dei post viene inserito in un tag <p>

Vuoi personalizzare il codice html? Apri il file del plugin, individua la funzione jblog_printFeaturedPosts e buon lavoro!

Esempio dell’output

<ul id="featured_posts">
	 <li>
		<a href="http://...html" id="featured_post_270">Titolo 1 - post 270</a>
		<p>Howwww! Nab him, jab him, tab him, grab him, stop that pigeon now.</p>
	</li>
	<li>
		<a href="http://...html" id="featured_post_320">Titolo 2 - post 320</a>
		<p>Grab him, stop that pigeon now.</p>
	</li>
	<li>
		<a href="http://...html" id="featured_post_450">Titolo 1 - post 450</a>
		<p>Tab him, grab him, stop that pigeon now.</p>
	</li>
</ul>

Script e Download

Per vedere il codice del plugin fai su http://test.jblog.it/wp-plugins/jblog_featured_posts.txt

Per scaricare il plugin vai su http://download.jblog.it/wp-plugins/jblog_featured_posts.zip

Per eventuali segnalazioni e malfunzionamenti scrivi dei commenti a questo post o contattami sull’email che trovi nella pagina “contatti”.

Questo plugin non fa per te? In questa pagina (su wordpress.org) trovi tantissimi plugin riguardanti i “post in evidenza”. Sicuramente ne troverai uno adatto alle tue esigenze!

Foto: still managed to draw a straight line di deadmanjones

In particolare, ha bisogno di ordinare i post in modo casuale nell’archivio di categoria.

Dopo aver spulciato le librerie di Wordpress e aver eseguito un po’ di prove ho sfornato questa funzione che sembra funzionare a dovere.

La classe WP_Query

In Wordpress le query (interrogazioni) al database vengono gestite con la classe WP_Query che si trova in wp-includes/query.php.

Ecco le proprietà e i metodi della classe WP_Query che utilizziamo:

• con il metodo set($query_var, $value) impostiamo le caratteristiche della query
• il metodo get($query_var) restituisce il valore di una variabile
• per eseguire la query utilizziamo la funzione get_posts()

Tuttavia, questi tre metodi non bastano a modificare l’elenco dei post che verranno visualizzati.

Questo elenco è memorizzato all’interno della proprietà posts (di tipo array) che verrà sovrascritta con l’array restituito dal metodo get_posts(), nell’ultima riga.

Per saperne di più sulla classe WP_Query vai su http://codex.wordpress.org/Function_Reference/WP_Query.

Il codice

function jblog_orderbyRand()
{
	global $wp_query;

	// Imposta il tipo di ordinamento
	$wp_query->set('orderby', 'rand');

	// Disabilita la paginazione dei post
	$wp_query->set('nopaging', true);
	$wp_query->set('posts_per_page', -1);

	// Reimposta l'array dei post da stampare
	$wp_query->posts = $wp_query->get_posts();
}

Come utilizzare la funzione

Innanzitutto copiamo il codice precedente nel file functions.php (all’interno della directory del template). Se il file non esiste basterà crearlo.

Anche se la necessità originale era quella di modificare l’elenco dell’archivio di categoria, questa funzione è efficace in ogni pagina del blog che contenga un elenco di post, quindi nell’homepage, nell’archivio di tag, ecc.

Per utilizzarla basterà inserirla in testa alla pagina da modificare. Ad esempio, se vogliamo che tutti gli archivi vengano ordinati in modo casuale, dobbiamo aprire il file archive.php del template e inserirla in testa:

<? // Ordinamento casuale
   jblog_orderbyRand(); 	?>

<? get_header(); ?>
	<div id="content" class="narrowcolumn">
		<?php if (have_posts()) : ?>
			. . .

Se, come nel caso del lettore, si deve ordinare in modo casuale solo l’archivio di categoria scriveremo la funzione all’interno di un costrutto if in cui si controlla che l’archivio sia relativo a una categoria.

Questo controllo si esegue ottenendo l’id della categoria grazie alla funzione get_query_var('cat') che restituisce il valore di una variabile per la query. Nota che quella funzione è equivalente all’istruzione $wp_query->get('cat'). Entrambe restituiscono l’id (di tipo intero) della categoria. Questo sarà maggiore di zero se l’archivio che si sta visualizzando è di categoria.

<? // Ordinamento casuale (se id categoria è positivo)
   if(get_query_var('cat')>0)
   jblog_orderbyRand(); 	?>

<? get_header(); ?>
	<div id="content" class="narrowcolumn">
		<?php if (have_posts()) : ?>
		. . .

Svantaggio: non è possibile dividere i post per pagine

Ogni volta che si carica la pagina viene rigenerato l’elenco e, dato che viene ordinato in modo casuale, i post non vengono adeguatamente distribuiti nelle varie pagine. In pratica è concreto il rischio che dei post apparsi nella pagina 1 possano apparire nuovamente in altre pagine. Per questo motivo viene disabilitata la paginazione.

Inoltre, è necessario applicare un ultima modifica al tema della pagina che ospiterà l’elenco da ordinare in modo casuale. Cioé, è necessario evitare che appaiano i link “post precedenti” e “post successivi”. Nei casi più semplici basterà eliminare il codice relativo a questi link. Se invece l’ordinamento casuale è condizionato (come nel codice precedente) bisognerà applicare le condizioni (contrarie rispetto a quelle relative alla funzione) alla visualizzazione di questi link:

<? // Per la funzione la condizione era get_query_var('cat')>0 (con il ">" anziché "<=")
if(get_query_var('cat')<=0) : ?>
	<div class="navigation">
		<div class="alignleft"><?php next_posts_link(__('&laquo; Older Entries', 'kubrick')); ?></div>
		<div class="alignright"><?php previous_posts_link(__('Newer Entries &raquo;', 'kubrick')); ?></div>
	</div>
<? endif; ?>

Serve aiuto?

Come vedi quello che ho scritto nella pagina “Informazioni” riguardo l’aiuto ai lettori non sono solo un mucchio di frasi fatte per riempire una pagina. Quindi se hai bisogno di aiuto o, più semplicemente, di un consiglio ricordati di passare da qui. Finché ne avrò il tempo sarò felice di aiutarti!

Vantaggi

• leggendo libri sull’usabilità dei siti web ho imparato che gli utenti sono molto pigri ma allo stesso tempo molto curiosi; allora ho pensato che se un lettore vuole leggere altri articoli è troppo pigro per ritornare nella homepage o nell’archivio, ma non per consultare una lista pronta di articoli da raggiungere con pochi click
• se hai inserito il plugin “post correlati” hai sicuramente notato che a volte ci sono pochi articoli correlati; è proprio in questi casi che torna utile avere una lista alternativa, da mostrare automaticamente quando articoli correlati
• gli appassionati di seo e guadagni online avranno subito pensato agli effetti in termini di tempo di permanenza; infatti invogliando gli utenti a visitare altre sezioni del sito o leggere altri articoli, ad esempio, avresti un aumento delle pagine viste con piacevoli conseguenze sul conto ad-sense
• quando un nuovo (e potenziale) lettore capita nel tuo blog è importante aiutarlo a scoprire il blog e gli articoli che scrivi; a tal proposito sarebbe vantaggioso avere il blocco “post in evidenza”, con gli articoli, secondo te, qualitativamente migliori

Svantaggi

• il database ha un’ulteriore query da eseguire
• anche se di poco, dovrai modificare il design della pagina (operazione non gravosa se hai già l’area riservata ai “post correlati”)

Casuali, ma non troppo

L’autore del plugin, Yakup GÖVLER, ha avuto la bellissima idea di far selezionare (opzionalmente) i post appartenenti alle stesse categorie del post principale. Secondo me è veramente un’ottima caratteristica perché si mantiene comunque un certo collegamento con il post che si sta leggendo.

Il plugin

L’autore del plugin originale è Yakup GÖVLER. Poiché non ero completamente soddisfatto dalla versione originale ho modificato solo la funzione principale. Infatti la mia versione non può essere gestita dal pannello di controllo, quindi è necessario entrare nei file del tema per modificare le opzioni.

Caratteristiche del plugin originale

• gestione del plugin nel pannello di controllo
• scelta del numero di post (da 1 a 20)
• selezione delle categorie dei post da stampare
• stampa dei post appartenenti alle stesse categorie del post che si sta leggendo
• selezione di id, link e titolo di ogni singolo post

Caratteristiche della mia versione del plugin

• unica funzione php da richiamare e configurare all’interno dei file di template
• scelta del numero di post (da 1 a 20)
• selezione delle categorie dei post da stampare
• stampa dei post appartenenti alle stesse categorie del post che si sta leggendo
• selezione di id, link, titolo e contenuto di ogni singolo post
• scelta del tipo di post tra “post” e “page”, o entrambi
• scelta del post genitore della pagina
• impostazione della lunghezza del contenuto del post
• segnalazione dei post da includere ed escludere, con l’opzione di stampare per primi i post inclusi

Guida all’utilizzo

La particolarità di questo plugin (nella mia versione) è che non stampa automaticamente la lista dei post, ma restituisce un array associativo da gestire a tuo piacimento. Per utilizzare la funzione all’interno del template bisogna avere un array in cui inserire i risultati della funzione. Ecco un esempio:

<?php
$random_posts = jblog_random_posts("limit=15&current_cat=1&len=200&post_type=post|page");
/*
- limit=15: recupera fino a 15 post
- current_cat=1: recupera i post di tipo "post" appartenenti alle stesse categorie del post che si sta leggendo
- len=200: seleziona anche il contenuto, in particolare i primi 200 caratteri
- post_type=post|page: recupera i post di tipo "post" e di tipo "page"
*/

foreach($random_posts as $random_post) { ?>
<h5><a href="<? echo $random_post['link']; ?>"><? echo $random_post['title']; ?></a></h5>
<? echo $random_post['content']; ?>
<?php } ?>

Parametri della funzione

Come hai potuto notare, la funzione ha un unico parametro di tipo stringa in cui vengono passate le opzioni (nella forma [opzione]=[valore]) separate da “&”.

post_type

Tipo dei post: “post”, “page”, “both” (entrambi). Default: “post”.

post_parent

ID del genitore del post. Valido solo se post_type=”page” o post_type=”both”. Default: “0″.

limit

Numero di post da selezionare. Impostare a “0″ per stampare tutti i post. Default: “10″.

cats

ID delle categorie alle quali devono appartenere i post da selezionare. Valido solo se post_type=”post” o post_type=”both”.

currentcat

Impostare a “1″ per selezionare tutti i post appartenenti alle categorie del post che si sta leggendo. Valido solo se post_type=”post” o post_type=”both”. Default: “0″.

len

Lunghezza del contenuto dei post. Impostare con un numero maggiore di “0″ per stampare il contenuto. Default: “0″ (quindi non viene restituito il contenuto).

exclude

ID dei post da escludere.

include

ID dei post da includere.

include_top

Impostare a “1″ per inserire nelle prime posizioni i post specificati da “include”. Default: “0″.

Valori restituiti dalla funzione

Il plugin non prevede la stampa automatica dell’elenco dei post, ma dovrai provvedere a scrivere un ciclo per la stampa degli elementi. L’array che viene restituito è un array di array associativi. Un array associativo invece degli indici numerici ha indici di tipo stringa (molto più user-friendly). In particolare, questo array ha quattro indici: id, link, title e content (se len>0), utilizzati nell’esempio precedente.

Analisi del codice

Vorrei fare alcune considerazioni sul codice, soprattutto perché potrei aiutarti nel caso volessi effettuare ulteriori modifiche.

Composizione della query. Ho avuto modo di provare diverse tecniche per comporre una query durante il controllo e l’impostazione dei parametri. Durante la modifica di questo plugin ho utilizzato un array associativo (chiamato $sql). Ogni indice corrisponde a una determinata sezione della query (“post_type”, “include”, “limit”, ecc.). La comodità consiste nell’avere una singola variabile (anche se complessa) da impostare nelle varie parti del codice e da utilizzare alla fine per comporre la query da eseguire.

Funzioni di wordpress. Quando si sviluppa un plugin o si scrive una funzione da richiamare all’interno di wordpress è consigliabile sfruttare le funzioni predefinite come wp_parse_args, apply_filters, ecc. La prima serve per la lettura dell’unico parametro, $args, e la seconda per applicare un determinato filtro a una stringa. In particolare, la funzione apply_filters è stata utilizzata per la formattazione del titolo: apply_filters('the_title', $post->post_title).

Vuoi modificare ulteriormente il plugin? In effetti potresti aver bisogno di stampare altri dati. Allora ti consiglio di analizzare la variabile $post all’interno del ciclo foreach (in fondo alla funzione) per scoprire gli altri dati relativi al singolo post da inserire in un nuovo indice dell’array di array associativi. Ricordati di utilizzare gli opportuni filtri e le opportune funzioni per evitare brutte sorprese!!!

Prossimamente…

Onestamente non credo che questa mia funzione si possa definire “plugin”. Tuttavia farò di tutto per sviluppare una versione migliore cioè priva il più possibile di errori, con più opzioni e gestibile interamente dal pannello di controllo.

Download

Puoi scaricare il file del plugin qui.

Crediti

• Il plugin originale è di Yakup GÖVLER
• La prima immagine è di Adrian Wallett

Hai domande o suggerimenti da fare? Si sono verificati malfunzionamenti o errori? Vorresti un po’ di aiuto per effettuare particolari modifiche?