Vista sviluppatore e aree di sistema nel CMS bluetronix
Con un accesso sviluppatore ottieni accesso a funzionalità aggiuntive, cartelle di sistema, tabelle di database e aree sorgente del CMS bluetronix. In questo tutorial scoprirai quali aree sono disponibili e come separare le tue estensioni dalle file di sistema in modo che siano aggiornabili.
Funzionalità aggiuntive con accesso sviluppatore
Con un accesso sviluppatore nel CMS bluetronix hai a disposizione funzionalità aggiuntive che non sono visibili nella normale vista utente.
Questo include ulteriori cartelle per sviluppatori nella gestione dei file, l'accesso al codice PHP delle pagine, ulteriori tabelle del database per sviluppatori, oltre a script di sistema, modelli di layout e moduli.
Modifica del codice PHP delle pagine
Nella normale vista CMS puoi modificare il codice HTML di una pagina. Con l'accesso sviluppatore hai a disposizione anche il pulsante PHP Code.
Con questo puoi inserire codice PHP personalizzato in una pagina CMS, ad esempio per query di database, contenuti dinamici, sostituzioni all'interno di $LayoutHTML, funzioni CMS o tue funzioni PHP.
Tabelle di database aggiuntive
Con un accesso sviluppatore, nella gestione del database vengono visualizzate ulteriori tabelle di sistema. Queste includono ad esempio tabelle per layout, gestione pagine, configurazioni di sistema e ulteriori funzioni interne del CMS.
Queste tabelle di sistema e per sviluppatori sono contrassegnate in rosso all'interno della gestione del database.
La struttura delle tabelle del database per sviluppatori contrassegnate in rosso non può essere modificata. Non è consentito eliminare, aggiungere o rinominare colonne, modificare tipi di dati o adattare strutture di sistema. Queste tabelle possono essere aggiornate o sostituite durante un aggiornamento del sistema.
Cartelle per sviluppatori nella gestione file
Con l'accesso sviluppatore, vengono visualizzate ulteriori cartelle di sistema all'interno della gestione dei file. Queste cartelle per sviluppatori sono rappresentate in rosso e iniziano sempre con bx_.
Le cartelle più importanti includono bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script e bx_style.
bx_doc
Nella cartella bx_doc si trovano file e documenti di esempio preinstallati. Questi possono includere ad esempio documenti PDF utilizzati all'interno di pagine o modelli di esempio.
bx_fonts
Nella cartella bx_fonts si trovano i caratteri forniti o installati dal CMS bluetronix. Questi font possono essere utilizzati all'interno dei diversi design e layout del CMS.
bx_Img
La cartella bx_Img contiene le immagini standard del set di temi attualmente utilizzato.
Come sviluppatore, puoi scegliere un altro set di immagini per il tema. I diversi set di immagini per il tema utilizzano gli stessi nomi di file definiti e funzionano quindi come un modello uniforme. La struttura HTML non deve essere modificata quando si cambia un set di immagini per il tema.
bx_Import
La cartella bx_Import è utilizzata per importare siti web esterni. Ad esempio, i siti web Bootstrap-5 possono essere preparati per l'importazione e archiviati in questo settore. I file vengono quindi analizzati e integrati nella struttura del CMS bluetronix.
bx_Layout
Nella cartella bx_Layout si trovano i modelli di pagina e sezione del CMS. Questi modelli sono disponibili per l'utente, ad esempio tramite Inserisci → Sezione pagina.
Come sviluppatore, puoi creare i tuoi modelli per sezioni hero, aree di testo, aree prodotto, aree contatto, elementi teaser e ulteriori sezioni di pagina personalizzate. Il cliente finale può quindi inserire questi elementi tramite l'editor normale, senza dover programmare HTML.
bx_script
Nella cartella bx_script si trovano i file JavaScript forniti dal CMS bluetronix. Questo include tra l'altro BxHeadScript.js e BxScript.js.
A seconda delle lingue attivate, possono essere generate anche versioni dipendenti dalla lingua, ad esempio BxScript_en.js, BxScript_de.js o BxScript_fr.js.
All'interno della cartella script si trova inoltre una directory Source. Qui sono presenti singoli file sorgente o componenti da cui vengono generati i file principali utilizzati successivamente.
bx_style
Analogamente a bx_Script, bx_style contiene gli stili centrali del CMS bluetronix. Da qui vengono generate, tra l'altro, le file CSS utilizzati dal sistema. Anche qui possono essere presenti file sorgente, da cui vengono assemblati i file CSS finali.
Cartelle di sistema e aggiornamenti
Le cartelle di sistema bx_ contrassegnate in rosso appartengono al CMS bluetronix e possono essere sovrascritte completamente o parzialmente durante un aggiornamento del sistema. Pertanto, le modifiche personali non devono essere salvate direttamente nei file di sistema normali.
I file personali all'interno delle aree di sistema devono essere contrassegnati con _own. Questa contrassegnazione segnala al CMS bluetronix che si tratta di un file specifico per il progetto.
Esempi sono config_own.php, MyScript_own.js, MyStyle_own.css o MyTemplate_own.txt. L'estensione del file non è rilevante. Ciò che conta è la contrassegnazione _own nel nome del file.
Pertanto, le modifiche personali all'interno delle cartelle di sistema rosse devono sempre essere create come file _own. In questo modo, questi file personali rimangono anche dopo un aggiornamento del CMS bluetronix.
Non modificare i file di sistema direttamente
Un file di sistema esistente quindi non dovrebbe essere modificato direttamente. Usalo come modello se necessario, copialo, contrassegna la copia con _own e poi esegui le tue modifiche in questo file.
bx_Mod
Nella cartella bx_Mod si trovano i moduli del CMS bluetronix. Questi possono includere, ad esempio, blog, negozi, ricerche, login e altri moduli del CMS.
Un modulo può contenere diversi file e aree, ad esempio configurazioni, elenchi, visualizzazioni dettagliate, script PHP e altri file di modulo.
Adatta i file del modulo
Anche per i file di modulo vale: il file di sistema originale non dovrebbe essere modificato direttamente. Puoi visualizzarlo, leggerlo, utilizzarlo come base e copiarlo. Per una versione personale crea quindi una copia con _own e apporta le tue modifiche lì.
Le regole principali per gli sviluppatori
1. Non modificare strutturalmente le tabelle del database contrassegnate in rosso.
2. Le cartelle di sistema bx_ contrassegnate in rosso possono essere sovrascritte durante gli aggiornamenti.
3. Non modificare direttamente i file di sistema per adattamenti personali.
4. Contrassegnare sempre i file personali all'interno delle aree di sistema con _own.
5. I file di sistema possono essere letti e copiati come modello.
6. Apportare successivamente le proprie modifiche all'interno del file _own.
Riepilogo
L'accesso per sviluppatori amplia il bluetronix CMS con funzionalità extra e aree di sistema come codice PHP, tabelle del database per sviluppatori, cartelle di sistema bx_, moduli, script, stili e modelli di layout.
È particolarmente importante la separazione tra file di sistema e proprie estensioni. Utilizzi i file di sistema originali come modello, mentre le tue modifiche le crei come file _own.
FAQ
cosa ci chiedono spesso i clienti
Quali funzionalità aggiuntive ottengo con un accesso per sviluppatori?
Hai accesso a cartelle per sviluppatori aggiuntive, al codice PHP delle pagine, a tabelle di sistema supplementari, nonché a script di sistema, modelli di layout e moduli.
Dove posso inserire il mio codice PHP per una pagina?
Con l'accesso per sviluppatori, su una pagina del CMS hai anche a disposizione il pulsante PHP Code.
Posso modificare strutturalmente le tabelle del database contrassegnate in rosso?
La struttura di queste tabelle per sviluppatori e di sistema non deve essere modificata. Non dovresti eliminare, aggiungere o rinominare colonne e non modificare tipi di dati o strutture di sistema.
Come riconosco le cartelle per sviluppatori?
Le cartelle per sviluppatori vengono visualizzate in rosso nella gestione dei file e iniziano sempre con bx_.
Qual è la funzione di bx_Layout?
In bx_Layout si trovano modelli di pagina e di sezione del CMS. Come sviluppatore puoi fornire lì i tuoi modelli, che il cliente finale potrà successivamente selezionare tramite Inserisci → Sezione pagina.
Perché non dovrei modificare direttamente i file di sistema?
I file di sistema e le cartelle di sistema possono essere sovrascritti durante un aggiornamento del bluetronix CMS. Le modifiche dirette potrebbero quindi andare perse.
Come posso creare file personali compatibili con gli aggiornamenti?
I file personali all'interno delle aree di sistema devono essere contrassegnati nel nome del file con _own, ad esempio MyScript_own.js o MyStyle_own.css.
Posso utilizzare file di sistema esistenti come modello?
Sì. Puoi visualizzare un file di sistema e utilizzarlo come base. Per modifiche personali dovresti copiarlo, contrassegnare la copia con _own e successivamente modificare solo quel file.