9 errori da evitare durante lo sviluppo di plugin o temi di WordPress

Stai cercando di creare un plugin o un tema per WordPress? Tieni presente che lo sviluppo di plugin e temi di successo include alcuni tentativi ed errori. Anche gli sviluppatori più esperti occasionalmente incasinano il loro codice e, anche se è impossibile evitare del tutto gli errori, ci sono alcuni errori comuni che puoi facilmente evitare. Per aiutarti, ho raccolto nove errori comuni da evitare durante lo sviluppo del tuo plugin o tema WordPress.

Errore n. 1: sacrificare la qualità a favore di soluzioni rapide

Alcuni sviluppatori cercano di trovare una scorciatoia durante lo sviluppo di un piccolo plugin o tema. Codificano in modo incoerente e cercano di trovare le soluzioni più semplici e veloci.

Tuttavia, la verità è che non esiste un modo semplice per sviluppare un plugin o un tema avanzato e ben funzionante. Alcuni plugin e temi possono essere sviluppati in modo relativamente semplice e veloce. Ad esempio, non ci vorrà molto tempo per sviluppare un plug-in che nasconda tutti gli avvisi dell'amministratore o un plug-in che inserisca uno snippet JavaScript. Tuttavia, quando si tratta di plugin o temi più complessi, "imbrogliare" o copiare può comportare una scarsa funzionalità, oltre a causare vari errori e difetti di prestazioni.

È fondamentale seguire le migliori pratiche di codifica organizzata anche se stai solo costruendo un prototipo di plugin/tema. Ricorda, molti dei prodotti più popolari sono nati come prototipi. Se segui un approccio "quick & dirty", inizierai ad accumulare debiti tecnici sin dal primo giorno.

Lo sviluppo di codice pulito, ben scritto e ottimizzato aumenterà i tempi di sviluppo del 10-30%, ma nel lungo periodo ne vale sicuramente la pena. Alla fine della giornata, otterrai un plugin o un tema manutenibile, ben funzionante e funzionale.

Errore n. 2: non riuscire a tenere traccia delle modifiche al codice

Non riuscire a tenere traccia delle modifiche al codice è un altro errore comune che tutti gli sviluppatori di WordPress dovrebbero evitare. Tutti i temi e i plug-in devono essere gestiti sotto il controllo della versione, indipendentemente dal fatto che tu sia l'unico sviluppatore del progetto o meno.

Tutti i temi e i plugin devono essere gestiti sotto il controllo della versione, indipendentemente dal fatto che tu sia l'unico sviluppatore del progetto o meno.Tweet

I sistemi di controllo della versione ti aiutano registrando e tenendo traccia di tutte le modifiche. Ciò consente a te e ad altri sviluppatori di lavorare sullo stesso progetto mentre un tema o un plug-in si sviluppa ulteriormente. Inoltre, i sistemi di controllo della versione, come Git, registrano tutte le modifiche apportate da ciascuno degli sviluppatori, il che è particolarmente conveniente quando si lavora su un progetto di grandi dimensioni. Se scegli di utilizzare Git, ti consiglio di utilizzare GitFlow come flusso di lavoro di ramificazione sano per la gestione dei rilasci.

Errore n. 3: mancato utilizzo degli spazi dei nomi

Gli spazi dei nomi sono utili se è necessario creare regioni separate per gruppi di variabili, classi e funzioni. Ciò previene i conflitti di plugin che erano presenti prima delle versioni PHP 5.6 e successive che non potevano essere controllati utilizzando gli spazi dei nomi.

Ecco un esempio di codice sorgente che illustra lo spazio dei nomi chiamato geometria per JavaScript. Questa definizione di pacchetto permette di differenziare la classe Circle da altre classi che potrebbero essere definite da altri programmatori.

namespace Geometry;

class Circle {
    private $radius;

    public circle($r) {
        $radius = $r;
    }

    public get_radius() {
        return $radius;
    }
   
    public get_area() {
        return pi() * $radius * $radius;
    }
}

Errore n. 4: non utilizzare i nonce di WordPress

Seguire le moderne pratiche di sicurezza è importante tanto quanto garantire la funzionalità del tuo plugin o tema. WordPress utilizza i nonce per fornire un certo livello di protezione per convalidare l'autenticità delle richieste. I nonce sono particolarmente utili per prevenire attacchi Cross-Site Request Forgery (CSRF).

Per creare un nonce, utilizzare la seguente funzione.

$nonce= wp_create_nonce( 'name');

Dai un'occhiata a questo riferimento al codice WordPress se non hai familiarità con i nonce.

Iscriviti e prendi una copia gratuita del nostro

Libro di affari del plugin di WordPress

Esattamente come creare una prospera attività di plugin per WordPress nell'economia degli abbonamenti.

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 "The WordPress Plugin Business Book". . 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 "The WordPress Plugin Business Book" a .

Condividi con un amico Invia nuovamente l'e-mail

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

Scaricamento

Errore n. 5: non utilizzare le funzionalità principali di WordPress

Molti sviluppatori non riescono a sfruttare tutto il potenziale delle funzionalità principali di WordPress esistenti. Alcuni temi e plugin hanno file corrispondenti ai file core di WordPress, come Color Pickers e jQuery.

La creazione di file extra aumenterà la dimensione finale del pacchetto e il tempo di caricamento. Dovrai mantenere e aggiornare regolarmente questi file, il che richiede anche tempo e fatica.

Utilizzando ciò che WordPress ha da offrire, puoi creare temi o plug-in più leggeri e funzionali.

Errore n. 6: accodamento di file JavaScript e CSS

Accodare file JavaScript e CSS quando non sono necessari è un altro errore comune. Ciò può portare a tempi di caricamento più lenti e a un peggioramento del posizionamento nei motori di ricerca poiché ogni file accodato aggiunge una richiesta HTTP aggiuntiva.

Errore n. 7: inserire il codice JavaScript in un unico file principale per i temi avanzati

Se stai sviluppando un tema avanzato che contiene JavaScript, è meglio astenersi dal inserire il codice JavaScript in un unico file principale. Molti sviluppatori scelgono di inserire il codice JavaScript del tema WordPress in un file principale chiamato main.js, theme.js o custom.js. Ci sono diversi motivi per cui non vuoi farlo. Innanzitutto, man mano che il tuo tema aumenterà, anche la dimensione del file aumenterà. Poiché questo file verrà caricato in tutto il sito, il caricamento di ogni pagina richiederà più tempo.

In secondo luogo, la creazione di un singolo file renderà più difficile la gestione del codice. Ad esempio, non sarai in grado di posizionare funzioni, come wp_dequeue_script() per scaricare codice in alcune pagine al fine di migliorare la velocità.

Ecco un video che spiega un po' di più sull'argomento:

Tieni presente che questo errore è rilevante solo per temi avanzati con una struttura JavaScript complessa. Se il tuo tema è più semplice e leggero in JavaScript, inserire il codice JavaScript nel file principale non danneggerà la funzionalità del tuo tema.

Errore n. 8: non riuscire a creare opzioni aggiuntive per modificare il codice

Quando un aggiornamento automatico viene eseguito direttamente sul codice, tutte le modifiche manuali al codice andranno perse a meno che non vengano modificate tramite azioni e filtri. Ecco perché è così importante abilitare azioni e filtri per le alterazioni.

In questo modo, tu e altri sviluppatori sarete in grado di modificare le funzionalità senza modificare il plug-in stesso o il tema principale. Inoltre, sarai in grado di utilizzare i filtri e le azioni per aggiungere funzionalità extra come estensioni o componenti aggiuntivi al plug-in o al tema principale.

Errore n. 9: non utilizzare le moderne pratiche di progettazione del codice

Il mancato utilizzo delle corrette pratiche di progettazione del codice è l'errore finale che chiude la nostra lista. La giusta organizzazione del codice deve essere scelta in base alle dimensioni e alla natura del tuo plugin.

Se hai intenzione di creare un piccolo plug-in monouso che non richieda un'ulteriore estensione, in seguito, non è necessario utilizzare un'architettura complicata con varie classi.

Se stai creando un'estensione del plugin che funziona con altri plugin o un plugin che richiede molto codice, è meglio usare l'approccio di programmazione orientata agli oggetti (OOP). L'idea principale alla base di OOP è organizzare il codice in blocchi, come le classi per una migliore organizzazione.

Inoltre, non consiglio di mescolare insieme codice PHP e codice HTML. È meglio tenerli separati utilizzando il modello Model-View-Controller (MVC), soprattutto se il tuo plug-in è gestito da più sviluppatori.

Asporto

Come hai appreso sopra, gli errori più comuni sono in genere non intenzionali, ma possono portare a conseguenze piuttosto deludenti.

In rassegna, gli errori più comuni sono:

1. Sacrificare la qualità a favore di soluzioni rapide
2. Impossibile tenere traccia delle modifiche al codice
3. Mancato utilizzo degli spazi dei nomi
4. Non utilizzando nonce WordPress
5. Non utilizza le funzionalità principali di WordPress
6. Accodamento di file JavaScript e CSS
7. Inserimento del codice JavaScript in un unico file principale per i temi avanzati
8. Impossibile creare opzioni aggiuntive per modificare il codice
9. Mancato utilizzo delle moderne pratiche di progettazione del codice

Anche se commettere errori è inevitabile, ora che sai quali sono, sarà più facile evitarli.

Hai commesso altri errori durante la creazione del tuo tema o plugin? Per favore, condividi la tua esperienza nei commenti qui sotto e non perdere questi altri 5 errori da evitare.

Con il contributo di Alyse Falk.