Prototipazione rapida: dal prototipo al codice, parte 2

Last updated Nov 9, 2022

Contenuto

Ora siamo organizzati (con un’eccezione)

Il post precedente dimostra molto lavoro nel prendere qualcosa che una volta era un prototipo rapido e portare quel prototipo al codice. Se non hai seguito insieme, abbiamo fatto quanto segue:

parlato e costruito un prototipo per un plugin,
schematizzato un approccio orientato agli oggetti può funzionare,
e rifattorizzato il nostro prototipo in codice reale.

A questo punto, ci sono alcune altre cose che possiamo fare per migliorare il nostro codice. Vale a dire, possiamo introdurre il concetto di namespace. Ciò porta l’organizzazione a fare un ulteriore passo avanti e può pagare dividendi per progetti più grandi.

Quindi, ecco uno sguardo a come questo si svolge nel nostro progetto attuale.

Prototipo da codificare: spazi dei nomi

Ho trattato in modo approfondito gli spazi dei nomi nei post precedenti. Se non l’hai letto, te lo consiglio. Quindi torna indietro e controlla il resto del post.

Se scegli di saltare l’articolo, ecco una breve definizione di spazio dei nomi :

I namespace sono progettati per risolvere due problemi che gli autori di librerie e applicazioni incontrano durante la creazione di elementi di codice riutilizzabili come classi o funzioni…

E l’idea generale è che organizziamo le nostre classi sulla base di una relazione logica che hanno tra loro.

Inoltre, organizziamo anche i file all’interno di directory che corrispondono allo spazio dei nomi. Questo non è qualcosa che deve essere fatto, ma trovo che aiuti avere le classi organizzate logicamente sul disco nel modo in cui sono organizzate virtualmente nello spazio dei nomi.

Detto questo, organizziamo i file.

Organizzare i file

Invece di iniziare con il file del plugin principale, iniziamo prima con l’organizzazione dei nostri file.

I file Meta Box e Meta Box Display risiederanno in una directory chiamata Display. Questo è completamente arbitrario, ma poiché è quello che fanno quei file, sembra avere senso che sia lì che risiedono.
Possiamo anche inserire i file message-description.php e no-post-list.php in quella directory, ma inserirli in una sottodirectory chiamata Views. Potresti chiamarlo Modelli o Parziali o qualcosa di simile.
Successivamente, abbiamo le classi responsabili dell’interrogazione del database e la classe responsabile del coordinamento della messaggistica. Mettiamo ognuno di questi in Utility. Ci sono altri posti in cui potrebbero andare, certo, ma ricorda che lo scopo è dimostrare come utilizzare gli spazi dei nomi. Quindi, se ti senti così incline, sentiti libero di adattare i tuoi file a tuo piacimento.

Se hai seguito quello che abbiamo sopra, dovresti avere una struttura di directory simile a questa:

Un modo per organizzare i tuoi file.

Ora è il momento di definire gli spazi dei nomi per ciascuna delle classi. Dal momento che li abbiamo organizzati tutti nelle loro directory, sarà facile specificare uno spazio dei nomi; tuttavia, è importante riconoscere che dovremo usare la parola chiave use quando utilizziamo classi che si trovano in altri spazi dei nomi.

Esaminiamo ciascuno dei nostri file iniziando con i file in Utility. Innanzitutto, inizieremo con Post Messenger :

Noterai che lo spazio dei nomi del file appare nell’intestazione insieme a una dichiarazione per utilizzare la classe Post Query che abbiamo creato. Ho aggiunto il nome della classe alla fine dello spazio dei nomi, quindi non devo usarlo in tutta la codebase.

Notare che il costruttore ora appare così :

Ho aggiunto un argomento $plugin_dir perché dobbiamo usarlo per visualizzare correttamente i risultati della query. E poiché ora risiedono in un’area di differenza dell’applicazione, le funzioni sono simili a questa :

Quindi, diamo un’occhiata alla classe Post Query. Non è cambiato molto in questa classe tranne che gli abbiamo assegnato uno spazio dei nomi e abbiamo anche aggiornato la query solo per recuperare tre post (come da questo commento ).

Nota nel codice, ho anche prefissato WP_Query con una barra perché fa parte dello spazio dei nomi globale.

Spostiamoci nella directory Display e diamo un’occhiata alla classe Meta Box. A questo è stato anche assegnato uno spazio dei nomi e utilizza anche il nome completo della classe Meta Box Display che esamineremo momentaneamente.

Notare che questo costruttore accetta anche la directory del plugin come argomento e la passa anche alla classe Meta Box Display. Questo perché le funzioni responsabili della visualizzazione dei messaggi possono essere trovate correttamente nella loro posizione nella directory Views.

Infine, esaminiamo la classe Meta Box Display. Questa è una classe semplice che include lo spazio dei nomi e fa riferimento al Post Messenger che abbiamo esaminato sopra.

A questo punto, abbiamo chiuso il cerchio attraverso il plugin. Con un’eccezione: il file bootstrap. Abbiamo aggiunto uno spazio dei nomi e dobbiamo aggiornare il modo in cui è stato istanziato :

Vale a dire, abbiamo:

definito lo spazio dei nomi,
fare riferimento alla posizione della classe Meta Box ,
aggiornato i percorsi per includere dove trovare i file (che alla fine può essere fatto con un caricatore automatico),
e aggiornato la chiamata add_action.

Ecco il problema della chiamata ad azione aggiuntiva: poiché WordPress deve individuare questa funzione e la funzione risiede in uno spazio dei nomi, il nome completo della funzione deve essere identificato in modo che WordPress possa richiamarla. Da qui la necessità di NAMESPACE nel nome della funzione.

Ora siamo organizzati (con un’eccezione)

Come puoi vedere, gli spazi dei nomi e le directory che li corrispondono aggiungono molta organizzazione a un progetto. È più facile da seguire, più facile capire dove vanno le cose (sia per i file esistenti che per quelli nuovi). E dà meno sensazione di accumulare molti file in un unico posto.

Anche se una classe è un po’ un monolito, può comunque essere organizzata in modo tale da semplificare la manutenzione.

Detto questo, c’è ancora qualcosa che cambierei su questo plugin: passare nella directory del plugin in questo modo non è qualcosa che aiuta con una bassa coesione e accoppia più strettamente le classi perché il file bootstrap deve passare un valore in una classe che lo passa a un’altra classe che lo utilizza per caricare file e così via.

Quindi ci sono modi per risolvere questo problema? Assolutamente. E forse daremo un’occhiata a questo nel post finale.

Fino ad allora, ricorda che la versione più recente del plugin è disponibile sul ramo master, etichettato come 0.3.0, su GitHub.

Messaggi di serie

Fonte di registrazione: tommcfarlin.com