Sono passati due anni dal kick off del progetto per il rifacimento del sito Michelebattaglino.it. Il programma era quello di creare un plugin per WordPress che implementasse le funzionalità principali e un tema che presentasse graficamente i contenuti personalizzati con un layout flessibile, responsive e accessibile. Obiettivo finalmente raggiunto.

Per la verità per realizzare il plugin non c’è voluto molto tempo, dopo qualche mese era pronto.

Come previsto, le difficoltà sono cominciate con lo sviluppo della parte grafica, perché è un’attività che odio e per la quale sono negato.

In questi ultimi mesi, approfittando prima del periodo in cui sono dovuto restare a casa a causa del Covid e poi delle vacanze estive, ho potuto portare a termine anche la parte grafica realizzando un semplice tema basato su Bootstrap 5.3.

In futuro io o altre persone potranno realizzare dei nuovi temi alternativi da associare al plugin.

Seguendo questo link è possibile vedere il risultato finale e il primo sito in produzione implementato con questo tema e questo plugin [3].

Stato dell’arte

In questo momento sono disponibili in rete, su dei repository pubblici, distribuiti con una licenza open source i seguenti progetti:

• wp-kkwriter-plugin [1]:  plugin per WordPress che:
  • aggiunge dei tipi di post (libro, recensione, brano, notizie, eventi, ecc.) e delle tassonomie personalizzate (sezione, autore, editore, ecc.);
  • pubblica una REST API per recuperare i contenuti personalizzati creati,
  • aggiunge un menu dedicato per la gestione dei nuovi contenuti,
  • fornisce la possibilità di precaricare dei contenuti d’esempio.

• wp-kkwriter-theme [2]: tema per WordPress, con le seguenti funzionalità:
  • layout personalizzato e responsive, basato su Bootstrap 5.3, a tutti i contenuti del sito;
  • interfaccia di configurazione per personalizzare il layout della home page, gestire le funzionalità del sistema;
  • modifica del layout della Home Page e scelta dei contenuti delle sezioni manuale o automatica;
  • carousel della HP con scelta dei contenuti delle sezioni manuale o automatica;
  • gestione dei tag SEO per l’indicizzazione del sito e dei tag OG per la condivisione delle pagine sui social.

L’elenco completo delle funzionalità si trova nel file README di ciascun progetto.

Sviluppi futuri

Mi occuperò personalmente della manutenzione di questi progetti, ma spero che, prima o poi, altri programmatori vogliano contribuire al loro avanzamento.

Nel file CHANGELOG.md di ciascun progetto saranno indicate le modifiche effettuate, mentre nel file TODO.md l’elenco delle funzionalità che verranno implementate nelle versioni future.

A grandi linee, nell’immediato futuro, queste saranno le principali attività su cui lavorerò:

• wp-kkwriter-plugin:
  • Attività di bug-fixing.
  • Refactoring della API REST.
• wp-kkwriter-theme:
  • Attività di bug-fixing.
  • Produzione della documentazione.
  • Verifiche di accessibilità.
• wp-kkwriter-theme:
  • Sarà un nuovo tema, alternativo a wp-kkwriter-theme, da abbinare al plugin wp-kkwriter-plugin basato sulla libreria Bootstrap Italia [4].

Utilizzo del plugin e del tema

Il plugin e il tema sono rilasciati sotto la licenza GNU General Public License v3.0 e sono quindi utilizzabili liberamente nel rispetto dei termini della licenza.

Sia il plugin che il tema utilizzano librerie open source, l’elenco completo si trova nel file CREDITS.txt di ciascun progetto.

Per segnalare bug o per richiedere l’implementazioni di nuove funzionalità si può usare. già da ora, la sezione Issues dei due progetti su GitHub [1] [2].

Per domande o richieste di chiarimenti è possibile contattarmi con il form contatti di questo sito o tramite GitHub [1] [2].

 

Fonti e riferimenti

• [1] Repository del progetto del plugin wp-kkwriter-plugin su GitHub.
• [2] Repository del progetto del tema wp-kkwriter-theme su GitHub.
• [3] Sito di Michele Battaglino: primo sito realizzato con questo plugin e questo tema.
• [4] Progetto e libreria Bootstrap Italia.
• [5] Getting started with Bootstrap 5.3.