Prodotto vBulletin: Modalità Debug

La creazione di un nuovo prodotto vBulletin si divide in una serie di operazioni preliminari, impostazione del sistema, pianificazione e programmazione (scrittura di codice), verifiche e prove, creazione di procedure di installazione, aggiunte e modifiche grafiche e infine la pubblicazione e manutenzione.


In questo capitolo vediamo come predisporre vBulletin alla creazione di nuovi prodotti e plugin e come controllare alcuni aspetti tecnici normalmente nascosti, fra di questi la modalità Debug.

Prima di tutto dobbiamo attivare il sistema dei plugin e prodotti nelle opzioni di vBulletin. Per questo andiamo nell'ACP nelle opzioni e accediamo al Sistema Plugin/Hook:


L'unica opzione finora disponibile è l'abilitazione del sistema dei prodotti e plugin, da impostare a 'Sì'. E' anche il luogo dove disabilitare globalmente tutte le aggiunte qualora si presentano problemi di entità catastrofali:


A questo punto, vBulletin è pronto per la programmazione.

Passiamo subito alla prova pratica di questo sistema, creandoci un'utilità che non deve mancare nel toolkit del programmatore vBulletin: L'interruttore della modalità Debug. Questa modalità ci permette di controllare alcuni aspetti di vbulletin che normalmente sono nascosti e non dovranno rimanere attivi nell'ambiente di produzione!

Andiamo nel menu ai Plugin & Prodotti, Gestione Prodotti:


Si apre la maschera dove sono presenti una serie di prodotti già installati. Qualora siano sbarrati, indicano lo stato disattivato. La disattivazione è un modo temporaneo per non utilizzare un prodotto:


In basso si trova il collegamento per creare nuovi prodotti ... e entriamo! Nella finestra che si apre, al riquadro Aggiungi Nuovo Prodotto, inseriamo i parametri che definiscono la nostra utilità:


Per i prodotti che funzionano soltanto per una versione specifica di vBulletin, suggeriamo di usare un id di prodotto con una sigla specifica, ad esempio dbg4. Nel nostro caso l'utilità funziona su tutte le versioni. In ogni caso, deve essere diversa da qualunque altra sigla usata nel nostro forum e una combinazione di 3 o 4 lettere è più che sufficiente ... non usare termini troppo espliciti per altri motivi tecnici.

L'inserimento del titolo, della versione e della descrizione sono a discrezione del programmatore, ma per convenzione, la versione è composta da 3 numeri separati da punti. Se indirizzato a un pubblico più ampio, si dovrebbero tradurre tutti i parametri in Inglese.

Dopo il salvataggio, il nostro prodotto appare in lista, in questo caso sotto vBulletin CMS:


Al fine di aggiungere la funzionalità desiderata, è necessario creare un Plugin associato a questo prodotto:


Nella maschera selezioniamo il nostro prodotto vBulletin Debug dalla lista, admin_global dalla lista della Locazione del Hook, inseriamo Debug Mode: Admin CP nel titolo, lasciamo l'ordine di esecuzione a 5, e inseriamo infine il codice PHP, che modifica vBulletin e definisce la funzionalità aggiuntiva:

Ricordiamoci anche di attivare il plugin e salvare. Dal momento che il plugin è attivo e salvato, è anche subito attivo. Quando la modalità debug è attiva, tutte le pagine nell'ACP portano in basso delle informazioni aggiuntive, quali le query eseguite e la memoria richiesta per completare la pagina:


Siamo certi che c'è ora molto da scoprire ...

Ricordiamoci che alla fine delle nostre esplorazioni a disabilitare questo gioello della tecnologia!