Pubblicare un plugin su WordPress con TortoiseSVN

Finalmente ho pubblicato il mio plugin RIACO Was This Helpful sul repository ufficiale di WordPress.

Il processo non è stato particolarmente complicato, ho usato il software con interfaccia grafica TortoiseSVN.

Ecco i passaggi che ho dovuto fare.

Installare TortoiseSVN

Per prima cosa, installa TortoiseSVN, l’interfaccia grafica che ho usato per poter caricare i file del plugin sfruttando il sistema di versioning come richiesto da WordPress.

Collegarsi al WordPress Subversion Repository

Ora che hai installato TortoiseSVN sul tuo pc, vai sul Desktop e crea una nuova cartella (oppure vai nella cartella dove vuoi che vengano scaricati i file dalla tua repository), chiamandola per esempio WordPress SVN.

Cliccai sopra con il tasto destro e seleziona SVN Checkout... .

Si aprirà una nuova schermata.

Nel campo URL of repository dovrai inserire l’url che ti è stato assegnato da WordPress e che ti è stato inviato via email.

Clicca su ok per iniziare a scaricare il contenuto della repository.

Inizialmente conterrà solo le cartelle di default assets, tags, trunks.

Abbiamo dovuto scaricare il contenuto del repository per sincronizzarci con quello remoto ed avere una copia sul nostro pc.

Poi caricheremo i file in queste cartelle ed infine invieremo tutto al repository remoto così da renderlo disponibile al mondo.

Prepara i file del plugin

Come abbiamo detto sono state scaricate queste tre cartelle:

• assets: per caricare gli screenshot, l’immagine di header del plugin i l’icona
• tags: conterrà il codice di ogni release (anche di quelle passate)
• trunk: conterrà il codice della versione di sviluppo del plugin, non per forza della versione stabile e distribuibile a tutti

Ora dobbiamo caricare tutti i file del plugin.

1. assets

Gli screenshot, l’icona e l’immagine di header vanno nella cartella assets, che non viene scaricata dagli utenti quando installano il plugin su lproprio sito WordPress.

2. trunk

Poi prendiamo tutti i file del plugin. Mi raccomando, solo i file interni alla cartella /nome-plugin/, senza la cartella.

Copiamoli dentro la cartella trunk.

3. tags

Infine carichiamo la release:

• copiamo l’intera cartella del plugin (non il file .zip) ad esempio /nome-plugin/
• incolliamola dentro la cartella tags
• rinominiamola con il nome della versione, solamente i numeri, senza aggiungere testo. Ad esempio per la versione 1.0.0, rinominiamo la cartella in 1.0.0 e non v1.0.0.

Ecco come si presenta la mia cartella degli assets:

Ecco come si presenta la mia cartella trunk:

Ed ecco la mia cartella tags:

Lo so, lo so, il mio plugin non inizia dalla versione 1.0.0 ma dalla 2.0.1, ci ho lavorato un bel po’ prima di pubblicarlo.

Carica i file del plugin

Sei pronto per caricare il tuo plugin sul server remoto?

• torna sul Desktop
• clicca con il tasto destro sulla cartella WordPress SVN che hai creato prima
• clicca su SVN Commit...

Si aprirà la schermata per fare il commit con di tutte le modifiche:

Seleziona i file che vuoi committare. Normalmente, dovrai committarli tutti, quindi clicca su All.

Nel campo Message Inserisci il messaggio da committare, ad esempio “Initial commit – First release of the plugin“.

Ora clicca su OK.

Dovrebbe iniziare a caricare tutti i file sul server e nel giro di qualche ora il tuo plugin sarà accessibile a tutto il mondo.

Happy coding!