L’uso del plugin Category Page è sempre stato un dilemma per molti utenti, probabilmente perchè non ha mai avuto una documentazione coerente; per rimediare a questo problema, ho deciso di scrivere questo howto in modo da spiegare meglio sia la sua logica interna, sia i vari modi in cui è possibile usarlo.
A cosa serve questo plugin?
Category Page crea connessioni tra pagine e categorie all’interno di WordPress. permettendo di usare le pagine (meglio ancora il contenuto delle pagine) come intestazione di un archivio di categoria. Per semplificare: supponiamo di avere una categoria ‘articoli’, e di voler avere uno o più paragrafi introduttivi da visualizzare quando un utente naviga l’archivio di questa categoria; per ottenere questo, è necessario:
- creare una pagina con il contenuto che ritenete più opportuno
- creare una connessione tra questa pagina e la categoria relativa
- fare in modo che il vostro tema supporti questo inserimento
Il primo punto è semplice. Basta entrare in Scrivi » Pagina e creare una pagina con il vostro contenuto preferito. Nella stessa pagina di scrittura troverete un box sulla destra (fino a WordPress 2.3) oppure in basso (WordPress 2.5) come questo:
In questo box potrete indicare a quale categoria (o categorie) sarà abbinata la pagina che state scrivendo o modificando. Potrete modificare questa scelta nello stesso box, oppure nella pagina di gestione delle connessioni, che troverete sotto Modifica » Category Pages:
In questa pagina potrete gestire ogni connessione esistente, oppure crearne delle nuove. Cliccando sul nome della categoria sarà possibile visualizzare la pagina di archivio corrispondente, mentre cliccando sul nome della pagina potrete modificare la pagina stessa.
Come si vede tutto questo nel sito?
Category Page richiede una piccola modifica del vostro tema per funzionare correttamente. Si tratta di sostituire il titolo di default degli archivi di categoria con una breve funzione. Purtroppo questa operazione non può essere resa standard, e le istruzioni per eseguirla possono variare completamente a seconda del tema. L’esempio che farò adesso si riferisce al tema di default, Kubrick.
1) Aprite archive.php e cercate le linee #8-9:
2) Modificate queste due linee in questo modo:
3) Salvate la pagina e controllate l’archivio di una categoria abbinata a qualche pagina. Vedrete il contenuto della pagina inserito come ‘introduzione’ dell’archivio stesso, più o meno così:
Per rendere ancora più semplice questo passaggio, abbiamo modificato alcuni temi molto comuni, e stiamo lavorando direttamente con alcuni autori per far supportare nativamente Category Page nei loro temi. Per il momento, questi sono i temi già modificati:
- InSense theme, by BloggingPro
- Kubrick theme, by Michael Heilemann
- Sandbox (pixlined) (la nostra versione di Sandbox)
Altri temi verranno rilasciati nei prossimi giorni, assieme a un howto più dettagliato sugli stili da applicare a Category Page. Accettiamo proposte sui temi da supportare!
Avevo capito che facesse il contrario..
Questo plugin (e la mia poca documentazione) ha generato un grosso equivoco nell’ultimo anno: molte persone erano convinte che questo plugin potesse permettere di elencare una lista di post appartenenti a una certa categoria all’interno dei propri post o pagine. Nella versione 2.5 ho deciso di accogliere questa richiesta nascosta tra le righe, e Category Page ora supporta - in via sperimentale - un quicktag, [ catlist ].
L’uso è decisamente molto semplice: basta conoscere l’ID della categoria (nel nostro esempio, sarà la categoria n. 8, Accessibilità) di cui volete far apparire una lista di post, e scrivere all’interno del post o della pagina in cui volete questa lista: [ catlist=8 ] (senza gli spazi!!)
Il risultato sarà simile a questo:
[catlist=8]
Nella pagina delle opzioni del plugin, potrete indicare quanti post elencare, e quale titolo aggiungere alla lista, a seconda del contesto in cui prevedete di inserirla.
Questo quicktag è completamente in via sperimentale, e cambierà quasi del tutto nelle prossime release, perchè una delle sorprese meglio nascoste di WordPress 2.5 è una nuova API dedicata proprio alla gestione degli shortcode (un altro modo di chiamare i quicktag). Quindi vi consiglio di non abusare di questa funzione, e di tenere a mente queste pressochè certe future modifiche.
Questo è quanto. Se avete ulteriori dubbi, potete scrivere nel forum di supporto (anche in italiano!). Se poi ritenete questo plugin utile, sulla parte destra di questo sito trovate due modi diversi di sostenere il nostro sviluppo opensource, tramite donazioni Paypal, oppure tramite Amazon. Nel caso, grazie!
