Gli standard di codifica di WordPress un'introduzione

Quando si tratta di creare prodotti basati su WordPress, siamo un po 'maledetti (o benedetti, a seconda di come lo vedete), con un'arma a doppio taglio: poiché WordPress è scritto in PHP, è relativamente facile ottenere WordPress - o progetto stesso: fare tutto ciò che vogliamo fare per tutto evitando le migliori pratiche.

Ma questo solleva la domanda: qual è il punto di un API o di standard di codifica formale se li ignoreremo semplicemente?

Abbiamo scritto un bel po 'sulle API di WordPress negli articoli precedenti, e abbiamo toccato gli standard di codifica di WordPress, ma non abbiamo mai veramente approfondito gli standard di codifica, comprendendone ogni aspetto e perché importa.

Quindi in questa serie, faremo proprio questo.

Perché preoccuparsi degli standard di codifica?

Prima di dare un'occhiata a tutto ciò che tratteremo, penso sia importante capire perché anche gli standard di codifica siano importanti.

WordPress è ampiamente utilizzato da Un sacco di persone che usano Un sacco di siti. C'è un sacco di codice in uso là fuori che è tutto costruito sull'applicazione principale. Ciò significa che ci sono sviluppatori e designer che stanno lavorando per mantenere quelle basi di codice.

La sfida arriva quando la persona che non ha originariamente scritto il codice è bloccata nel migliorare, gestire e correggere i bug per il progetto. Diciamo che la prima persona non ha seguito gli standard di codifica, ma la persona che ora sta mantenendo il codice è abituata a seguire le migliori pratiche.

Ora hanno a che fare con codice che non somiglia a come dovrebbe apparire il codice WordPress.

E questo è davvero il nocciolo della questione: il codice che compone i nostri temi, i nostri plugin e nelle nostre applicazioni dovrebbe idealmente apparire come un singolo sviluppatore ha scritto il codice.

Quello è quali standard di codifica si applicano.

Sfortunatamente, gli standard sono ignorati o non sono sufficientemente evangelizzati nonostante siano ben documentati. È qui che entra in gioco questa serie di articoli: osserveremo ciascuno degli standard in modo approfondito per evangelizzare, capire e incoraggiarsi l'un l'altro a iniziare a fare un lavoro migliore.

Uno sguardo agli standard di codifica

Questa serie includerà sette articoli oltre a questo pezzo introduttivo.

Ecco dove siamo diretti con questa particolare serie:

Convenzioni di denominazione e argomenti di funzione - Daremo un'occhiata a come dovremmo nominare le nostre variabili, metodi e classi in modo che siano chiari, facili da capire e seguiremo per noi stessi e altri sviluppatori.
L'uso di singole virgolette e doppie virgolette - Le virgolette singole e le doppie virgolette danno come risultato un comportamento diverso in PHP e c'è un tempo e un posto per quando usare quale in WordPress. In questo articolo, daremo un'occhiata agli esempi di ciascuna e alla logica di ciò che stiamo facendo.
Indentazione, utilizzo dello spazio e spazi finali - Lo spazio bianco ha un ruolo importante nello scrivere il codice basato su WordPress. Questo articolo esplorerà i motivi per cui rientri indentazione e spazio, nonché quando utilizzare le schede e quando utilizzare gli spazi.
Stile di brace, espressioni regolari e tag PHP - Diversi linguaggi in stile C usano una sintassi diversa. Questo articolo esaminerà il modo corretto per posizionare le parentesi nel codice basato su WordPress. Esamineremo anche il modo corretto di includere espressioni regolari, nonché alcuni dei trucchi e delle best practice relativi all'uso dei tag PHP.
L'operatore ternario e le condizioni Yoda - Le dichiarazioni condizionali sono una pietra miliare della programmazione e vengono utilizzate liberamente in WordPress. PHP offre una scorciatoia per le istruzioni if / else e WordPress opta per valutare i condizionali in modo diverso rispetto a quello che altre lingue spesso supportano. Qui, daremo un'occhiata a quanto sopra.
Query di database e query SQL di formattazione - C'è un'API completa per eseguire query sul database di WordPress, ma esistono anche modi per eseguire SQL raw. Se hai bisogno di seguire questa strada, c'è un modo giusto per farlo. Questo articolo darà un'occhiata esattamente a questo.
Portare tutto insieme - Infine, riassumeremo tutto ciò che abbiamo discusso in tutta la serie per assicurarci che siamo tutti sulla stessa pagina e per spronarci ad andare avanti con un lavoro migliore di aderenza agli standard.

Conclusione

Quando si parla di blog, spesso si presume che l'autore sia un esperto del tema in questione, ma la verità è che io credo fermamente che dovremmo seguire gli standard di codifica e che cerco di aderire al meglio delle mie capacità. , Sto imparando cose ogni settimana.

Ho violato molte volte gli standard di codifica e sono sicuro che anche alcuni di voi lo hanno fatto.

Il punto di questa serie è quello di esaminare gli standard insieme in modo che tutti noi potremmo apparire come sviluppatori migliori una volta che abbiamo finito.

Codice