Chi ha un sito WordPress e vuole mostrare dei libri si chiede presto come presentarli in modo ordinato, con le copertine in bella vista, senza ricopiare a mano autore, editore, anno e pagine di ogni titolo.
Per questo ho scritto Montecchiani Book Catalog, un plugin gratuito e open source che aggiunge al tuo sito WordPress un catalogo di libri. Dal 26 ottobre 2026 è nella directory ufficiale di WordPress.org, quindi si installa direttamente dalla bacheca.
In questa guida ti mostro come si usa, dall'installazione al catalogo pubblicato su una pagina.
Che cos'è e a chi serve
Il cuore del plugin è un tipo di contenuto dedicato ai libri. Ogni libro ha la sua copertina, i suoi dati bibliografici e uno o più generi. Per mostrarli usi uno shortcode, cioè un breve codice tra parentesi quadre che WordPress sostituisce con il catalogo: lo inserisci in qualsiasi pagina e ottieni una griglia di copertine che mostra i dettagli del libro al passaggio del mouse o al tocco.
È pensato per chi vuole mostrare dei libri sul proprio sito: lettori, autori con la loro bibliografia, librerie, biblioteche, associazioni culturali e case editrici.
In breve:
- versione 1.3.1, gratuita, licenza GPLv2 o successiva;
- richiede WordPress 5.8 e PHP 7.2 o versioni successive;
- testato fino a WordPress 7.1;
- pronto per l'editor a blocchi.
Installazione
- Nella bacheca vai su Plugin > Aggiungi nuovo plugin.
- Cerca "Montecchiani Book Catalog".
- Clicca Installa ora e poi Attiva.
Nel menu laterale compare la voce Book Catalog, con quattro sottomenu: All Books, Add New Book, Genres e Settings. Per ora il plugin è in inglese, anche nel catalogo pubblico: qui trovi i nomi originali di pulsanti e campi, che cambieranno con la traduzione italiana.
Aggiungere un libro
Un libro si crea come un articolo: vai su Book Catalog > Add New Book, scrivi il titolo e, se vuoi, una descrizione nell'editor. Se hai l'ISBN, puoi lasciarli vuoti: li compila Autofill from ISBN, come vedrai più avanti.
Sotto l'editor trovi il riquadro Book Details con i campi del libro:
- ISBN, da 10 o 13 cifre;
- Author, l'autore;
- Publisher, l'editore;
- Publication Year, l'anno di pubblicazione;
- Number of Pages, il numero di pagine;
- Language, la lingua (per esempio it oppure en);
- Shop Link, facoltativo: l'indirizzo della pagina in cui acquistare il libro.
Con lo Shop Link la copertina nel catalogo diventa un link al negozio. Se lasci vuoto Author, il plugin usa l'autore predefinito scelto nelle impostazioni: comodo quando il catalogo raccoglie i libri di una sola persona.
La copertina è l'immagine in evidenza del libro ("Set book cover" nel pannello laterale). Puoi caricarla tu oppure farla trovare al plugin.
Quando hai finito, clicca Pubblica: nel catalogo compaiono solo i libri pubblicati.
Compilare i dati dall'ISBN
Questa è la parte che fa risparmiare più tempo:
- Scrivi l'ISBN nel campo ISBN.
- Clicca Autofill from ISBN, accanto al campo.
- Il plugin interroga Google Books e Open Library, unisce i risultati e compila i campi vuoti: titolo, autore, editore, anno, pagine, lingua e descrizione.
- Un avviso ti dice quali campi ha compilato e da quale fonte arrivano i dati.
- Controlla i dati, scegli i generi nel pannello Genres e clicca Pubblica: i campi compilati vengono salvati solo allora.
La regola più importante: vengono compilati solo i campi vuoti. Quello che hai già scritto non viene mai sovrascritto. Puoi quindi scrivere la descrizione con parole tue e lasciare al plugin i dati più noiosi da ricopiare.
Se ripeti la ricerca sullo stesso ISBN entro 12 ore, la risposta è immediata: il plugin la conserva in cache sul tuo server. Se un ISBN non viene trovato, controlla il numero. Se nelle impostazioni, alla voce Data Source, hai scelto una sola fonte, prova l'altra oppure entrambe.
Dopo il clic su Autofill from ISBN: autore, editore, anno, pagine e titolo arrivano da Open Library, con la copertina pronta da importare.
Importare la copertina con un clic
Se la ricerca trova anche una copertina, sotto l'avviso compare la sua anteprima con il pulsante Use as cover. Un clic e il plugin scarica l'immagine, la salva nella Libreria media e la imposta come immagine in evidenza del libro.
Non tutti gli ISBN hanno una copertina negli archivi. In quel caso carica la copertina a mano, come una normale immagine in evidenza (oppure, se usi una sola fonte, prova l'altra).
Organizzare i libri per genere
I generi funzionano come le categorie degli articoli: li crei da Book Catalog > Genres e li assegni a ogni libro dal pannello laterale dell'editor. Un libro può avere più generi.
Ogni genere ha uno slug, cioè il nome scritto in forma adatta agli indirizzi web: "Romanzo storico" diventa romanzo-storico. Lo trovi nell'elenco dei generi e serve nello shortcode per mostrare solo una parte del catalogo.
Pubblicare il catalogo con lo shortcode
Lo shortcode di base è questo:
[mbcat_books]Per mostrare il catalogo sul sito:
- Vai su Pagine > Aggiungi nuova pagina, oppure apri la pagina che vuoi usare.
- Clicca il pulsante + e aggiungi un blocco Shortcode.
- Incolla lo shortcode qui sopra.
- Clicca Pubblica e apri la pagina: vedrai la griglia delle copertine.
Così mostri tutti i libri pubblicati, dall'ultimo inserito sul sito, con il numero di colonne scelto in Settings. Lo shortcode funziona anche negli articoli.
Gli attributi
columns: il numero di colonne, da 1 a 5. Se non lo indichi, vale quello delle impostazioni.hitem: quanti libri mostrare. Se ce ne sono di più, sotto la griglia compare il pulsante "Show All Books".orderby: l'ordinamento, cioèdate(data di pubblicazione sul sito, predefinito),title(titolo),year(anno del libro),author(autore),rand(casuale),menu_order(ordine manuale: l'editor dei libri non ha un campo Ordine, quindi serve solo con un plugin di riordinamento) oppuremodified(ultima modifica). Conyeareauthori libri senza quel dato finiscono in fondo; conauthorci finiscono anche quelli che usano l'autore predefinito delle impostazioni.order: la direzione,ASC(crescente) oppureDESC(decrescente, predefinito).genre: uno o più slug di genere separati da virgola. Compaiono i libri di almeno uno dei generi indicati.
Tre esempi
Una vetrina in home page con gli ultimi sei libri inseriti, su tre colonne (se ne hai di più, sotto compare il pulsante Show All Books):
[mbcat_books hitem="6" columns="3"]Tutto il catalogo ordinato per anno, dal libro più vecchio al più recente, su quattro colonne (se raccogli i libri di un solo autore, è la sua bibliografia):
[mbcat_books columns="4" orderby="year" order="ASC"]Una pagina per fantasy e thriller in ordine alfabetico, con i primi sei titoli e il pulsante per vedere gli altri:
[mbcat_books hitem="6" columns="3" orderby="title" order="ASC" genre="fantasy,thriller"]Come appare il catalogo sul sito
Il risultato è una griglia responsive di copertine, da 1 a 5 colonne, che si adatta a computer, tablet e smartphone.
Il catalogo su quattro colonne: sulla copertina di The War of the Worlds è aperto il pannello con i dettagli, sotto c'è il pulsante Show All Books.
Quando passi il mouse su una copertina, la raggiungi con la tastiera o la tocchi sullo smartphone, compare un pannello con titolo, un breve estratto della descrizione, autore, editore, anno, pagine, genere e ISBN. Si vedono solo i dati che hai compilato. Al primo tocco si apre il pannello; se il libro ha uno Shop Link, il secondo tocco porta al negozio.
Se hai usato hitem e i libri sono di più, sotto la griglia c'è il pulsante Show All Books: carica il resto del catalogo senza ricaricare la pagina, con gli stessi filtri e lo stesso ordinamento.
I file CSS e JavaScript del plugin vengono caricati solo nelle pagine con lo shortcode, quindi il resto del sito non ne risente.
L'elenco dei libri e le impostazioni
Nell'amministrazione, Book Catalog > All Books mostra i libri con le colonne Cover, Author, Year e ISBN, oltre a titolo e generi. Un clic sull'intestazione ordina l'elenco per autore o per anno.
L'elenco dei libri nell'amministrazione, ordinabile per autore e per anno.
In Book Catalog > Settings trovi:
- Default Author: l'autore usato per i libri che non ne hanno uno;
- Author Gender: l'etichetta che precede il nome nel pannello dei dettagli, Author oppure Authoress (per un'autrice);
- Number of Columns: le colonne predefinite della griglia;
- Data Source: Google Books e Open Library insieme (consigliato) oppure uno solo dei due;
- Google Books API Key: facoltativa, vedi le domande frequenti;
- Delete Data on Uninstall: se la spunti, eliminando il plugin vengono cancellati anche libri e generi.
La pagina delle impostazioni del plugin.
Dati strutturati per i motori di ricerca
Nelle pagine con lo shortcode il plugin aggiunge per ogni libro i dati strutturati Schema.org Book in formato JSON-LD, con i dati che hai compilato e la copertina. Aiutano i motori di ricerca a capire che la pagina parla di libri e a mostrarli, quando lo ritengono utile, come risultati arricchiti.
Non devi configurare nulla: i dati si aggiornano anche quando Show All Books carica il resto del catalogo.
Servizi esterni: cosa viene inviato
Per la compilazione automatica il plugin interroga Google Books e Open Library (Internet Archive) dal server del tuo sito, solo nell'amministrazione e solo quando clicchi Autofill from ISBN o Use as cover. Viene inviato soltanto l'ISBN, più la chiave API di Google Books se l'hai inserita. Le copertine scaricate sono contenuti di terzi: verifica di poterle pubblicare. I dettagli completi sono nella sezione External services della pagina del plugin su WordPress.org.
Traduzioni in arrivo e come contribuire
Ho preparato le traduzioni in italiano, francese, spagnolo, giapponese e russo: le sto caricando su translate.wordpress.org, quindi sono in arrivo. Quando saranno disponibili, WordPress le scaricherà da solo per la lingua del tuo sito, senza configurazioni.
Il plugin è open source e ogni contributo è benvenuto:
- Traduzioni: se la tua lingua manca, puoi aggiungerla dal progetto di traduzione, anche poche stringhe alla volta.
- Segnalazioni e domande: il posto giusto è il forum di supporto su WordPress.org.
- Codice: il repository su GitHub è pubblico: puoi aprire una segnalazione o proporre una modifica.
Domande frequenti
Serve una chiave API di Google Books?
No. Google Books risponde anche senza chiave: la chiave alza solo il limite di richieste, utile se importi molti libri in poco tempo.
Il catalogo pubblico è in italiano?
Non ancora: le etichette del pannello (Author, Publisher, Year...) e il pulsante Show All Books sono in inglese finché la traduzione italiana non arriva su translate.wordpress.org.
Cosa succede ai miei libri se elimino il plugin?
Per impostazione predefinita libri, generi e copertine restano sul sito: vengono rimosse solo le impostazioni del plugin. Se vuoi cancellare anche libri e generi, spunta Delete Data on Uninstall prima di eliminare il plugin.
Posso avere più cataloghi sullo stesso sito?
Sì. Puoi inserire lo shortcode in quante pagine vuoi, anche più volte nella stessa pagina. Ogni inserimento ha i suoi attributi: per esempio una pagina per genere e una vetrina degli ultimi arrivi in home page.
Link utili
- Il plugin su WordPress.org
- Il codice sorgente su GitHub
- Il progetto di traduzione
- Il forum di supporto
Se lo provi, mi farebbe piacere sapere come lo usi e cosa miglioreresti: scrivimi nel forum di supporto o su GitHub.
Buona catalogazione!
Mirko Montecchiani
