Come inviare plugin al repository di WordPress.org

L'hosting di un plug-in nel repository di WordPress.org è uno dei modi più popolari (ed efficaci) per avviare un business freemium di successo. Se è la prima volta che invii un plug-in al repository, alcuni passaggi potrebbero essere poco chiari o confusi, motivo per cui ho delineato il processo per guidarti. Consiglierei anche di aggiungere questa pagina ai segnalibri se è necessario farvi riferimento in futuro.

Preparazione per la presentazione

Prima di tutto, devi ottenere l'approvazione dal team di revisione dei plug-in per ospitare il tuo prodotto nel repository. Per questo, devi avere un account su WordPress.org. Non ne hai uno? Nessun problema: puoi registrarti qui.

Creazione del file Readme.txt del plug-in

Successivamente, devi creare un file readme.txt in formato markdown che verrà utilizzato per la pagina di elenco del tuo plug-in su WordPress.org. Deve contenere le seguenti informazioni:

• Nome del plug-in
• Collaboratori (il tuo ID utente di WordPress.org)
• Tag dei plug-in
• Richiede almeno (versione WordPress)
• Testato fino a (versione WordPress)
• Tag stabile (versione plug-in)
• Licenza (GPLv2 o successiva)
• URI della licenza: www.gnu.org/licenses/gpl-2.0.html
• Descrizione (descrizione completa del tuo plugin)
• Domande frequenti
• Schermate
• Registro delle modifiche

Per riferimento, ecco un modello di file readme.txt standard.

Per assicurarti di aver formattato e strutturato correttamente il file readme.txt del tuo plugin, usa il Validatore Readme di WordPress.

Scegli con attenzione il nome del tuo plugin

È importante prendersi il tempo necessario per scegliere il nome del plug-in "giusto" prima dell'invio iniziale poiché influirà sull'URL dell'elenco del plug-in, che influirà sulla SEO dell'elenco di WordPress.org e, infine, sull'esposizione e sulla crescita organica del plug-in.

Ecco la sezione pertinente che copre l'impatto del nome dalla pagina di invio del plug-in:

L'URL del tuo plug-in verrà popolato in base al valore di Plugin Name nel file del plug-in principale (quello con le intestazioni del plug-in). Se imposti il ​​tuo come Plugin Name: Boaty McBoatface , il tuo URL sarà https://wordpress.org/plugins/boaty-mcboatface e il tuo slug sarà, ad esempio boaty-mcboatface . Se esiste un plugin esistente con il tuo nome, allora sarai boaty-mcboatface-2 e così via. Si comporta esattamente come i nomi dei post di WordPress.

Quindi, quando scegli il nome iniziale, pensa a ottimizzarlo per la SEO piuttosto che per il branding. Chiediti quali parole chiave vorresti scegliere come target ed estrapolare il nome da esso. Puoi trovare alcuni suggerimenti per la denominazione qui.

Ricorda, puoi sempre cambiare il nome del plugin dopo l'invio iniziale, quindi anche se scegli un nome che non ti piace, puoi cambiarlo in seguito (e tutte le volte che vuoi). Quello che non puoi cambiare è lo slug del plugin, quindi la denominazione iniziale è importante.

Si noti inoltre che lo slug viene creato dal nome del plug-in nel file del plug-in principale, che può essere diverso dal valore del nome del plug-in nel file readme.txt.

Invio del tuo plugin

Una volta stabilito un buon nome SEO, e il tuo plug-in e il file readme.txt sono pronti, vai alla pagina Aggiungi il tuo plug-in e invialo per la revisione.

Il processo di revisione è manuale e può richiedere da 1 a 10 giorni, a seconda della coda di revisione e della complessità del plug-in. Se vengono rilevati problemi, riceverai un'e-mail con i dettagli di tali problemi e come risolverli.

Una volta risolti i problemi (se presenti), riceverai l'approvazione via email. Il tuo plug-in non è pubblico a questo punto, ma puoi comunque caricare, modificare ed eliminare file tramite la riga di comando o un client SVN.

Suggerimento: per assicurarti di non perdere email importanti, ti consiglio di inserire nella whitelist [email protected] , l'indirizzo email utilizzato dal team di revisione dei plugin di WordPress.org per la comunicazione con gli sviluppatori di plugin.

Caricamento del plug-in

Ora che ti è stato concesso l'accesso al repository SVN, il passaggio successivo è caricare il tuo plug-in nel repository di WordPress.org. Prima di farlo, ti consigliamo di familiarizzare con le basi dell'utilizzo di Subversion con WordPress.

Sto andando con l'interfaccia della riga di comando per questo tutorial. Se non ne sei un fan e preferisci lavorare con un client visivo, considera TortoiseSVN per Windows e Cornerstone per Mac.

Prima di poter caricare i file del plug-in nel repository SVN, è necessario creare una cartella locale in cui verranno archiviati i file e le risorse. Questo comando creerà una directory locale:

$ mkdir my-awesome-plugin

Per coerenza, è buona norma assegnare un nome alla cartella e al file PHP principale del plug-in in base allo slug che ti è stato assegnato dopo l'invio iniziale. In questo esempio, presumo che il nome del tuo plugin sia My Awesome Plugin e che il tuo slug approvato sia my-awesome-plugin .

Ora, per vedere e scaricare il repository predefinito:

$ svn checkout https://plugins.svn.wordpress.org/my-awesome-plugin local/path/to/my-awesome-plugin

Questo darà il seguente ritorno:

A my-awesome-plugin/branches
A my-awesome-plugin/tags
A my-awesome-plugin/trunk
Checked out revision #####

Qui, A significa che le directory sono state aggiunte alla cartella locale dal repository centrale. Successivamente, devi copiare i file e le cartelle del tuo plug-in nella cartella del trunk :

$ rsync -r local/path/to/wordpress/wp-includes/plugins/my-awesome-plugin/* local/path/to/my-awesome-plugin/trunk

E aggiungili al repository.

$ svn add trunk/*

In cambio, ti verrà chiesto di autenticarti. Una volta effettuato l'accesso, riceverai una risposta simile a questa:

A trunk/my-awesome-plugin.php
A trunk/readme.txt

Importante: WordPress.org tratta la cartella del trunk come la cartella di primo livello del plug-in. Pertanto, non copiare l'intera cartella del plug-in così com'è, il trunk dovrebbe includere solo il contenuto del plug-in.

Evita questo: trunk/my-awesome-plugin/my-awesome-plugin.php

Dopo aver aggiunto tutti i file, ripristina le modifiche nel repository centrale:

$ svn commit -m 'My first plugin version'

Questo restituirà la seguente risposta:

Adding trunk/my-awesome-plugin.php
Adding trunk/readme.txt
Transmitting file data.
Committed revision 9999999.

Per caricare un'icona del plug-in, un banner e schermate, puoi creare una nuova cartella di risorse all'interno del tuo repository locale SVN:

$ mkdir local/path/to/my-awesome-plugin/assets

Puoi scoprire come funzionano le risorse del plug-in qui.

Una volta che hai le risorse pronte, aggiungi le risorse del plug-in al repository SVN:

$ svn add assets/*

Confermare nuovamente le modifiche:

$ svn commit -m 'Assets upload'

Questo è tutto! Il tuo plug-in è ora disponibile per il download e puoi iniziare a promuoverlo.

Pubblicazione di una nuova versione

Per la prossima versione di aggiornamento del tuo plug-in, i passaggi sono leggermente diversi. Prima di pubblicare la nuova versione, aggiorna il campo Stable Tag nel trunk/readme.txt file e il numero di versione nel commento dell'intestazione del plug-in. Una volta che hai i file del plugin pronti, copiali in una sottocartella di /tags e imposta il nome della sottocartella sulla nuova versione, come 1.0.1 .

$ svn copy trunk tags/1.0.1

  A tags/1.0.1

Conferma le modifiche.

$ svn commit -m 'Version 1.0.1 release'

  Adding tags/1.0.1
  Adding tags/1.0.1/my-awesome-plugin.php
  Adding tags/1.0.1/readme.txt
  Committed revision 999999.

E proprio così, la nuova versione del tuo plugin è pronta!

Suggerimenti per la gestione delle versioni

• Potresti notare un certo ritardo dal momento del rilascio di una nuova versione e quando diventa disponibile per il download nella pagina di elenco dei plug-in di WordPress.org. Dagli qualche ora e se ancora non lo vedi puoi inviare un'e-mail a [email protected] poiché il sistema ha problemi di tanto in tanto.
• Come regola generale, per ridurre i problemi di sincronizzazione, si consiglia che la versione del plug-in nella cartella del trunk sia identica alla versione del plug-in nell'ultima versione nella cartella dei tags .

Qual è il prossimo?

Per natura, gli sviluppatori di plugin gratuiti sono guidati e appassionati nel contribuire con cose utili al mondo. Soprattutto, vogliamo che i nostri prodotti risolvano problemi specifici che le persone potrebbero avere. Ma indipendentemente da quanto sia eccezionale il tuo plug-in, non sarà di grande aiuto se le persone non riescono a trovarlo.

Un buon passo successivo per migliorare la visibilità del tuo plugin gratuito è ottimizzare il file readme.txt per SEO, che è qualcosa che esploriamo qui.

Se stai pensando di guadagnare con il tuo plug-in, non è sufficiente avere il tuo prodotto online gratuitamente: vuoi che le persone lo scoprano, lo utilizzino, lo adorino e (si spera) aggiorni alla tua versione a pagamento! Al giorno d'oggi, uno sviluppatore di WordPress indossa molti cappelli, dal produttore di prodotti all'imprenditore fino al marketer, e per far vedere il tuo plugin alle persone giuste devi sviluppare e perfezionare le tue capacità di marketing.

Quale è un argomento che esploriamo in modo approfondito con il nostro Manuale di marketing per i creatori di prodotti WordPress. Consiglio vivamente anche di controllare il seguente cheat sheet per la vendita di plugin e temi WordPress: è una tabella di marcia concisa e attuabile per creare un business WordPress di successo, dall'ideazione al lancio fino alla crescita.

Prendi una copia gratuita del nostro

Cheat sheet per la vendita di temi e plugin

Una tabella di marcia per la crescita con suggerimenti concisi e attuabili per ogni pietra miliare dello sviluppo del prodotto WordPress.

Condividi con un amico

Inserisci l'indirizzo email del tuo amico. Gli invieremo solo questo libro via email, onore dello scout.

Grazie per aver condiviso

Fantastico: è stata appena inviata una copia di "Cheat sheet per la vendita di temi e plug-in". . Vuoi aiutarci a spargere la voce ancora di più? Vai avanti, condividi il libro con i tuoi amici e colleghi.

Grazie per esserti iscritto!

- abbiamo appena inviato la tua copia di "Cheat sheet per la vendita di temi e plugin" a .

Tweet Invia di nuovo e-mail

Hai un errore di battitura nella tua email? clicca qui per modificare l'indirizzo email e inviare nuovamente.

Scaricamento

Hai intenzione di inviare un plugin al repository di WordPress.org? Stai pensando di utilizzare il modello di business freemium? Suona nei commenti qui sotto!