Gli sviluppatori sono i benvenuti e incoraggiati a creare le proprie estensioni per Easy Digital Downloads (EDD) e condividerle con altri proprietari di negozi. Alcune semplici linee guida mantengono la tua estensione facile da trovare, chiaramente separata dalle nostre funzionalità ufficiali e coerente con il resto dell'amministrazione EDD.
Questa guida copre come nominare la tua estensione, utilizzare il marchio EDD e posizionare le tue impostazioni.
Nota: Gli hook delle impostazioni in questa guida fanno parte di Easy Digital Downloads stesso. Puoi basarti su di essi con il plugin gratuito e senza pass. Questa guida è per sviluppatori. Se stai cercando funzionalità da aggiungere al tuo negozio, inizia con quelle ufficiali nel tuo menu Download » Estensioni.
Prima di iniziare, assicurati che Easy Digital Downloads sia installato e attivato sul sito WordPress su cui stai sviluppando.
Nominare la tua estensione
Un nome chiaro comunica immediatamente ai proprietari dei negozi che la tua estensione funziona con EDD e che proviene da te piuttosto che da noi.
Nomina le estensioni di terze parti utilizzando il formato "Nome Estensione per Easy Digital Downloads". Molti ecosistemi di plugin utilizzano questo stesso schema, quindi i proprietari dei negozi lo riconoscono già.
Per favore, non usare "Easy Digital Downloads – Nome Estensione". Quel formato è riservato alle nostre estensioni ufficiali e usarlo fa sembrare la tua estensione una delle nostre.
Utilizzo del marchio Easy Digital Downloads
Se la pagina, l'elenco o gli screenshot della tua estensione menzionano Easy Digital Downloads, utilizza i nostri loghi e colori ufficiali. Li troverai, insieme alle nostre linee guida sul marchio, sulla nostra pagina Press and Brand Assets.
Quella pagina copre anche come scrivere il nostro nome. Easy Digital Downloads è sempre composto da 3 parole, con la E, la D e la D maiuscole. Accorciarlo in EDD va bene lo stesso.
Seguire le linee guida dei plugin di WordPress.org
Ogni plugin deve seguire le linee guida ufficiali dei plugin di WordPress.org. Per le estensioni EDD, la più importante è Linea guida 17: I plugin devono rispettare marchi, copyright e nomi di progetto.
Questa linea guida non consente a uno slug di plugin di iniziare con il nome di un altro prodotto, a meno che tu non possieda o rappresenti tale prodotto. Uno slug come your-extension-for-easy-digital-downloads segue la regola e corrisponde al formato di denominazione sopra.
Aggiungere le tue impostazioni alla scheda Estensioni
I proprietari del negozio si aspettano di trovare le impostazioni dell'estensione in un unico posto. Posiziona le tue impostazioni specifiche per EDD nella loro sezione sotto Download » Impostazioni » Estensioni, piuttosto che aggiungere un menu o una pagina di impostazioni separata.
Ogni estensione che registra impostazioni ottiene il proprio link in cima alla scheda Estensioni. In questo esempio, 2 estensioni hanno aggiunto le proprie sezioni, chiamate Sconti Pro e Dropbox.
La scheda Estensioni appare solo una volta che almeno un'estensione ha registrato delle impostazioni. In un negozio senza estensioni, non vedrai affatto la scheda.
Dalla versione 3.7, EDD registra i propri hook tramite classi di sottoscrizione agli eventi, e la tua estensione può fare lo stesso. La tua classe di impostazioni si sottoscrive a 2 filtri:
edd_settings_sections_extensions: aggiunge il link della tua sezione alla scheda Estensioni. Aggiungi una voce all'array, usando una chiave univoca e l'etichetta che i proprietari del negozio vedranno.edd_settings_extensions: aggiunge le tue impostazioni alla scheda. Restituisci le tue impostazioni annidate sotto la stessa chiave che hai usato per la sezione, in modo che EDD le collochi nella tua sezione.
Le estensioni di terze parti dovrebbero posizionare le impostazioni specifiche di EDD sotto Download → Impostazioni → Estensioni → Nome della tua estensione. Per vedere un esempio di come registrare la tua sottosezione e le tue impostazioni, puoi fare riferimento a questo Gist:
EDD salva queste impostazioni con il resto delle sue opzioni. Per leggere un valore nel tuo codice, usa edd_get_option( 'myext_enable_feature' ).
Ogni impostazione richiede un id, un name e un type. I tipi comuni includono checkbox_toggle, text, textarea, select, rich_editor e header. Puoi anche impostare un valore predefinito con std.
Per copiare entrambi i file, vedi l'esempio Gist su GitHub.
Questo è tutto! Ora sai come nominare, marchiare e configurare la tua estensione in modo che si integri perfettamente con Easy Digital Downloads. Per saperne di più sulla creazione su EDD, consulta l'Introduzione per sviluppatori a Easy Digital Downloads.
FAQ sullo sviluppo di estensioni EDD
Di seguito, abbiamo risposto ad alcune delle domande più comuni sulla creazione di estensioni di terze parti per EDD.
Ho bisogno di un pass per creare un'estensione?
No. La scheda delle impostazioni e gli hook in questa guida fanno parte del plugin gratuito Easy Digital Downloads.
Perché non vedo una scheda Estensioni nelle mie impostazioni?
La scheda appare solo una volta che un'estensione registra almeno un'impostazione. Dopo che il tuo codice aggiunge una sezione e le sue impostazioni, la scheda Estensioni appare sotto Download » Impostazioni.
Il team di EDD supporterà la mia estensione?
No. Le estensioni di terze parti sono supportate dagli sviluppatori che le creano. I tuoi clienti hanno bisogno di un modo chiaro per raggiungerti per ricevere assistenza.
Posso iniziare il nome della mia estensione con Easy Digital Downloads?
Per favore, non farlo. I nomi che iniziano con "Easy Digital Downloads" sono riservati alle nostre estensioni ufficiali. WordPress.org inoltre non consente a uno slug di plugin di iniziare con il nome di un altro prodotto. Invece, usa il formato "Nome Estensione per Easy Digital Downloads".
