Creare un plugin WordPress non è solo una questione di programmazione, per avere successo ci sono anche diversi altri aspetti da tenere in considerazione. L’autore presenterà alcuni consigli utili per gli sviluppatori di plugin, sulla base dell’esperienza maturata nell’arco di oltre 6 anni a seguito della creazione e manutenzione di un plugin molto popolare. Perché imparare dagli errori degli altri è meglio che imparare dai propri.

1. 1
10 CONSIGLI IN
10 MINUTI PER
UN PLUGIN DI
SUCCESSO
WORDCAMP TORINO - 7 APRILE 2018

2. Marco Chiesi
» Ingegnere informatico
» Lead Engineer @ Black Studio
» Sviluppo siti web dal 1998
» WordPress lover dal 2010
2CHI SONO
@marcochiesi
marco@blackstudio.it

3. BLACK STUDIO TINYMCE WIDGET 3
6.900.000+
Downloads
4.8
Rating medio
900.000+
Installazione attive

4. 0. PREREQUISITI
Conoscenza di:
» Basi di programmazione
» PHP, JavaScript, HTML, CSS
» Documentazione per dev WP
» Plugin Handbook
» Codex
» Best practice sicurezza
4

5. “
... ma non è solo questione di
programmazione!
5

6. 1. IDEA
» Risolvere un problema di
interesse generale
» Soluzione migliore rispetto a
plugin esistenti
» Partire dalle proprie esigenze
» Consultare la sezione Ideas
di wordpress.org
6

7. 2. PRESENTAZIONE
» Nome
» Descrizione
» Tag
» Grafica / Branding
» Banner header
» Icone
» Screenshot
7

8. 3. USER EXPERIENCE
Prima user experience,
poi implementazione
» Trovare beta tester
» Non infastidire l'utente con
pubblicità, avvisi, etc
» Wizard post-installazione
(admin pointers)
8

9. “Most developers seemed to think about the
user experience only after most of the
development of their plugins was complete.
- Chris Lema
9

10. 10

11. 4. SUPPORTO E RECENSIONI
» Presidiare forum di supporto
» Concentrarsi su problemi di
interesse generale
» Prevenire le richieste
» Rispondere educatamente alle
recensioni negative
11

12. “If you help a friend in need, he is sure to
remember you - the next time he's in need.
- Cheit's Lament
(Murphy's Law, Arthur Bloch)
12

13. 13

14. 5. DOCUMENTAZIONE
» FAQ - Domande frequenti
» Istruzioni di installazione
» Guida risoluzione problemi
» Documentazione per dev
» Come contribuire al progetto
» Changelog versioni
» Commenti nel codice
14

15. “
Documentation is a love letter that you
write to your future self.
- Damian Conway
15

16. 6. INTERNAZIONALIZZAZIONE
Più del 50% dei download di WP
è in lingue diverse dall'inglese.
» Interfaccia del plugin
traducibile secondo gli
standard di WordPress
» Compatibilità con principali
plugin multilingua (WPML, etc)
16

17. 7. SVILUPPO APERTO
Non solo open-source,
anche open-development
» Utilizzare Git e GitHub
» Istruzioni per sviluppatori
che vogliono contribuire
» Tool di sviluppo disponibili
per tutte le piattaforme
17

18. 8. CODING STANDARDS
I coding standards permettono di:
» Evitare errori comuni
» Aumentare leggibilità codice
» Semplificare le modifiche
» Uniformare il codice come se
fosse stato scritto da una
singola persona
18

19. 9. COMPATIBILITÀ
» Compatibilità cross-browser
» Altri plugin e temi
» Diverse versioni di WordPress
» Diverse versioni di PHP
» Diverse configurazioni a livello
di sistema/server
» Accessibilità
19

20. 10. AGGIORNAMENTI
Nuove feature, bugfix, patch
» Dimostrare l'interesse dello
sviluppatore nel progetto
» Attestare compatibilità con
nuove versioni di WordPress
» Evitare avvisi sul repository
20

21. 21

22. CREDITS
Un ringraziamento speciale a:
» Organizzatori WordCamp Torino 2018
Materiali utilizzati per la presentazione:
» Template di SlidesCarnival
» Vignetta di Christian Mirra per CodeinWP
22
Slide disponibili su:
blackstudio.it/talks/