Integrare e personalizzare i moduli CMS
In questo tutorial personalizzi il modulo blog del CMS bluetronix: dall'attivazione e integrazione dell'elenco blog fino ai file di modulo personalizzati, valori di configurazione e file di lingua.
Requisiti e obiettivi del tutorial
Per questo tutorial hai bisogno di un accesso da sviluppatore al CMS bluetronix. Dovresti già sapere come funzionano le cartelle degli sviluppatori e perché i file personalizzati nelle cartelle di sistema sono contrassegnati con _own.
Utilizziamo il modulo News - Blog esistente come esempio. Attivi il modulo, integri la sua vista elenco in una pagina CMS e successivamente adatti deliberatamente un file di modulo personalizzato e la configurazione. I file originali rimangono invariati.
1. Attivare il modulo blog
Apri in CMS Moduli e seleziona News - Blog.
Attiva l'opzione Attiva modulo blog e conferma la richiesta di sicurezza con OK.
Dopodiché il configuratore del modulo è a tua disposizione. A sinistra ci sono le impostazioni tecniche, a destra i testi del modulo dipendenti dalla lingua.
2. Integrare la lista dei blog in una pagina CMS
Apri la pagina /Blog/index.html e scegli Codice HTML. La pagina del blog viene integrata tramite un breve tag CMS.
<!--bx_Mod/Blog/Modul-Blog-List-->
Il tag fa riferimento al modulo blog e alla sua vista elenco. Il CMS inserisce l'output generato del modulo in questo punto durante il rendering.
3. Aprire i file dei moduli centrali nel gestore file
La logica PHP e HTML effettiva dei moduli non si trova direttamente nell'HTML della pagina, ma centralmente nella cartella di sistema bx_Mod. Apri prima questa cartella nel file manager e poi la sottocartella Blog.
Nella cartella Blog trovi ad esempio Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, altri file di modulo e la sottocartella languages.
4. Visualizzare il file standard della lista dei blog
Seleziona Modul-Blog-List.php e aprila tramite Modifica.
Il file standard contiene la logica del programma per la vista elenco. Nel codice mostrato vengono inclusi, tra le altre cose, la configurazione del modulo e, se presente, il file specifico del progetto config_own.php.
In questo modo, un'unica inclusione del modulo può utilizzare la stessa logica centrale del programma su diverse pagine. Per i progetti che utilizzano il modulo standard, futuri aggiornamenti del CMS possono fornire modifiche a questo file.
Non modificare direttamente il file originale Modul-Blog-List.php. Appartiene al sistema e potrebbe essere sovrascritto durante un aggiornamento del CMS.
5. Creare una propria vista elenco con _own
Per modificare l'output, copia il file standard. La tua copia personale deve avere esattamente l'etichetta _own:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Apri il nuovo file Modul-Blog-List_own.php. In questa versione specifica del progetto puoi cambiare la logica PHP e l'output HTML senza toccare il file standard.
Nel nostro test, aggiungiamo alla intestazione la ben visibile stringa NEW!!!!. Il resto della vista elenco rimane invariato.
Salva il tuo file di modulo personale e ricarica la pagina del blog. Il CMS utilizza la variante _own appropriata, mentre il segnaposto in /Blog/index.html rimane invariato. Riconosci il file personale attivo dall'intestazione modificata NEW!!!! ARTICOLI PIÙ RECENTI.
6. Impostazioni del modulo e configurazione personale
Oltre all'output HTML, puoi anche modificare la configurazione del modulo. Lo screenshot mostra nel configuratore, ad esempio, per Modul-Blog-ShowCase il valore DS Repeats = 3.
Cambia il valore in 2 e salva l'impostazione. Questo stabilirà il numero desiderato per quest'area ShowCase. L'impostazione riguarda Modul-Blog-ShowCase e non deve essere automaticamente equiparata al numero totale di articoli della vista elenco del blog.
La tua configurazione personale si trova in bx_Mod/Blog/config_own.php. Seleziona questo file nel gestore dei file.
Il config_own.php mostrato sovrascrive il valore solo se l'area di modulo interessata Modul-Blog-ShowCase viene caricata:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
I valori di default provengono ancora da config.php. Pertanto, un file di configurazione personale non deve ripetere tutti i valori standard, ma può contenere solo le deviazioni desiderate.
7. Definire la tabella del database e le pagine del modulo
Nella configurazione standard bx_Mod/Blog/config.php puoi trovare, tra le altre cose, la tabella del database utilizzata e i percorsi per la vista dettagliata e l'elenco. Nell'esempio mostrato, i valori sono:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Se sviluppi una tua variante per uno scopo diverso basata sul modulo del blog, puoi ad esempio inserire una tabella del database diversa nella tua configurazione personale. Controlla se la nuova tabella contiene i campi previsti dal tuo file di modulo e se le pagine di lista e dettagli si adattano alla nuova variante.
8. File di lingua del modulo
Sotto bx_Mod/Blog/languages si trovano i file di lingua del modulo blog. Per le lingue esistenti ci sono file PHP separati, ad esempio de.php, en.php e fr.php.
Qui vengono gestiti i testi del modulo dipendenti dalla lingua. Utilizza il formato di file personale supportato dalla tua versione del modulo per modifiche specifiche del progetto, invece di sovrascrivere direttamente i file di lingua originali.
9. Distinguere il modulo standard dalla propria versione
La regola _own protegge le tue modifiche dalla sovrascrittura tramite aggiornamenti regolari. Allo stesso tempo, sei responsabile della manutenzione di questa versione individuale. Controlla durante futuri aggiornamenti del CMS se modifiche significative al file standard sono rilevanti anche per il tuo file personale.
10. Riepilogo
Attivi il modulo blog sotto Moduli → Notizie - Blog, integri la vista elenco tramite un tag CMS e gestisci la logica del programma centrale sotto bx_Mod/Blog. Per le modifiche personali, copi Modul-Blog-List.php in Modul-Blog-List_own.php. Le impostazioni che si discostano dallo standard, se necessario, possono essere archiviate in config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteIn questo modo è possibile estendere un modulo esistente in modo mirato, senza modificare i file di sistema originali.
FAQ
cosa ci chiedono spesso i clienti
Di quale accesso ho bisogno per personalizzare i moduli CMS?
Hai bisogno di un accesso sviluppatore al CMS bluetronix. Inoltre, dovresti conoscere le cartelle per sviluppatori e la regola _own.
Dove attivo il modulo del blog?
Apri Moduli, seleziona News - Blog e attiva Attiva modulo Blog. Conferma l'interrogazione di sicurezza.
Come inserisco l'elenco dei blog in una pagina CMS?
Apri il codice HTML della pagina desiderata e aggiungi il tag del modulo <!--bx_Mod/Blog/Modul-Blog-List-->.
Devo copiare l'intero codice PHP dell'elenco dei blog nella pagina?
No. La pagina contiene solo il tag del modulo. La logica corrispondente viene caricata centralmente dal modulo blog.
Dove si trova il file standard dell'elenco dei blog?
Lo trovi sotto bx_Mod/Blog/Modul-Blog-List.php nell'area sviluppatore del gestore di file.
Come adatto un file di modulo per gli aggiornamenti?
Copia il file standard e contrassegna la copia con _own, ad esempio Modul-Blog-List_own.php. Modifica solo questo file personale.
Devo cambiare il tag del modulo quando creo un file _own?
No. Per un file di modulo supportato dal CMS, la variante _own appropriata può essere utilizzata automaticamente, senza modificare l'integrazione del modulo esistente.
A cosa serve config_own.php?
Attraverso bx_Mod/Blog/config_own.php puoi sovrascrivere valori specifici per il progetto dalla configurazione standard.
Cosa comporta DS Repeats in questo esempio?
Nell'esempio mostrato, l'impostazione per Modul-Blog-ShowCase viene modificata da 3 a 2. Essa stabilisce il numero di ripetizioni di quest'area del modulo.
Dove è definito quale tabella del database utilizza il modulo blog?
Nella configurazione bx_Mod/Blog/config.php si trova nell'esempio $CF_DatabaseTable = "Blog";. L'assegnazione può essere adattata per una propria variante di modulo.
Dove trovo i file di lingua del modulo blog?
I file PHP dipendenti dalla lingua si trovano sotto bx_Mod/Blog/languages, ad esempio de.php e en.php.
Chi si occupa della manutenzione di un proprio file di modulo?
Il proprio file _own rimane al suo posto durante gli aggiornamenti regolari del CMS. Lo sviluppatore deve verificare autonomamente se è necessario integrare nuove correzioni o funzioni dal file standard.