Scarica l'app ora e prova gratuitamente per 10 giorni
Valuta Seleziona la lingua Seleziona regione

Obiettivo del tutorial

In questo tutorial importerai un layout Bootstrap 5 esistente nel CMS bluetronix. Scomporrai la pagina HTML originale in Header, Footer, singoli modelli di Sezione e il vero e proprio frame del layout. Successivamente, potrai inserire liberamente, spostare e riutilizzare i singoli segmenti di pagina nell'editor.

Nota: Questo tutorial tratta l'importazione base del layout. Altre modifiche o sostituzioni di immagini saranno trattate in un tutorial successivo.

1. Apri il template originale in bx_Import

Apri nella gestione file la cartella bx_Import. Qui il layout importato si presenta inizialmente nello stato originale - per esempio con le cartelle immagini e i file HTML originali. In quest'area lavorerai solo con i file originali esistenti; le modifiche non vengono salvate nel template originale.

Per questo esempio, apri il file index.html e passa a Modifica. Questo file verrà quindi scomposto nei singoli componenti del layout del CMS.

Segnaposto Screenshot: Gestore file con cartella bx_Import aperta, cartelle immagini e file HTML originali – dev_bootstrap_import_bx_import_originaldateien.jpeg. Prendi ancora il'immagine e poi incorporala qui.

Segnaposto Screenshot: index.html da bx_Import nell'editor HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. Prendi ancora il'immagine e poi incorporala qui.

2. Estrarre l'intestazione da index.html

Cerca nel codice HTML con Ctrl + F header. In molti template Bootstrap, l'intestazione può essere trovata rapidamente poiché è contrassegnata da un elemento HTML corrispondente. In alcuni template, l'intestazione è costituita solo da un'area div; in questo caso, devi esaminare più attentamente la struttura.

Seleziona l'intera area dell'intestazione e copiala. È meglio lavorare con due finestre aperte, in modo da poter passare tra il template originale e il tuo progetto CMS.

Segnaposto Screenshot: Area dell'intestazione di index.html trovata tramite la ricerca e contrassegnata per la copia – dev_bootstrap_import_header_markieren.jpeg. Prendi ancora il'immagine e poi incorporala qui.

3. Trasferire l'intestazione nel CMS

Torna al tuo progetto, apri la directory principale e poi Header → Codice HTML. Incolla lì il codice dell'intestazione copiata in precedenza.

Successivamente controlla i percorsi locali. In molti layout, i riferimenti relativi e i percorsi delle immagini devono avere uno slash iniziale affinché funzionino correttamente all'interno della struttura CMS.

href="css/style.css"   →   href="/css/style.css"
src="images/logo.jpg"  →   src="/images/logo.jpg"

Importante: Usa Ctrl + H per cerca e sostituisci, ma non sostituire i percorsi alla cieca. Controlla in particolare gli URL esterni, i link ancorati, i link mailto: e i percorsi già assoluti.

Segnaposto screenshot: Directory principale → Header → Codice HTML con header inserito – dev_bootstrap_import_header_html_einfuegen.jpeg. Registra ancora l'immagine e successivamente integra qui.

Cerca quindi il footer nel index.html originale. Taglia o copia l'intera sezione del footer e incollala nel file footer previsto nella directory principale del tuo progetto. Controlla anche lì tutti i percorsi locali href e src.

Segnaposto screenshot: File footer nella directory principale con codice footer inserito – dev_bootstrap_import_footer_html_einfuegen.jpeg. Registra ancora l'immagine e successivamente integra qui.

5. Suddividere la sezione principale in singoli modelli di sezione

Il contenuto della pagina rimanente dopo l'header e il footer non viene copiato direttamente nell'index.html del tuo progetto. Apri invece bx_Layout → SectionTemplate.txt → Codice HTML.

Incolla l'area principale rimanente del template originale alla fine di questo file. Successivamente, dividila nelle singole aree che dovranno essere disponibili separatamente nell'editor.

Tra due modelli di sezione, inserisci esattamente il seguente separatore:

<!--__SP_SectionTemplate__-->

Ogni sezione separata in questo modo può essere successivamente inserita come modello nell'editor. Questo ti consente di ordinare liberamente le sezioni, usarle più volte o ometterle in una pagina.

Segnaposto screenshot: bx_Layout → SectionTemplate.txt con più sezioni e il separatore <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Registra ancora l'immagine e successivamente integra qui.

6. Trasferire il frame del layout in 00_layout

Dopo aver separato header, footer e sezioni principali, rimane il vero e proprio telaio HTML, ad esempio con DOCTYPE, la sezione head e ulteriori elementi di layout superiori. Copia questo codice rimanente.

Apri quindi la gestione del database e modifica il database 00_layout. Sono già disponibili modelli di layout lì. Puoi modificare un modello esistente o crearne uno nuovo.

Incolla il telaio copiato sotto LayoutHTML. Nelle posizioni originali di header, contenuto principale e footer utilizzi i marchi CMS:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Durante il rendering della pagina, questi marchi vengono sostituiti dall'header pertinente, dalla pagina principale attuale e dal footer. Il relativo codice PHP sotto LayoutPHP viene eseguito automaticamente al caricamento del layout.

Segnaposto screenshot: Database 00_layout con LayoutHTML e i marchi per Header, Main e Footer – dev_bootstrap_import_00_layout_layouthtml.jpeg. Registra ancora l'immagine e successivamente integra qui.

7. Controllare i percorsi di CSS, JavaScript e Favicon

Controlla all'interno del codice layout tutti i riferimenti a file CSS, JavaScript e Favicon. Imposta lo slash iniziale necessario per i percorsi locali. Per i file CSS e JavaScript, usa anche il marcatore di versione del file CMS.

Una chiamata JavaScript potrebbe apparire in questo modo:

<script src="__FV_/bx_script/core.min.js__"></script>

Il marchio __FV_...__ consente al sistema di tenere conto della versione del file o della data di modifica durante il rendering. Questo permette al browser di caricare il file CSS o JavaScript attuale dopo le modifiche, senza che l'utente debba aggiornare manualmente la cache del browser.

8. Ripulire i contenuti dell'head e utilizzare l'HTML dell'intestazione

Controlla la sezione head assunta ed elimina i contenuti già impostati dal CMS o caricati altrove. Puoi anche rimuovere un titolo di pagina fisso se questo viene generato automaticamente dal sistema.

Il codice header necessario all'editor e che non deve essere direttamente parte di LayoutHTML deve essere archiviato sotto Extras → Header-HTML. In questo modo l'editor può considerare i contenuti archiviati lì durante la modifica della pagina.

Segnaposto screenshot: Extras → Header-HTML con il codice header spostato lì – dev_bootstrap_import_extras_header_html.jpeg. Registra ancora l'immagine e successivamente integra qui.

9. Selezionare il layout importato per la pagina

Se hai creato un nuovo layout in 00_layout, apri nell'editor le Impostazioni della pagina e seleziona il layout importato. Solo allora la pagina pertinente verrà visualizzata con questo telaio di layout.

Segnaposto screenshot: Impostazioni della pagina con selezione del layout appena importato – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Registra ancora l'immagine e successivamente integra qui.

10. Ricomporre la homepage dalle sezioni importate

Fai clic su Modifica nella tua pagina. La home page potrebbe apparire inizialmente vuota. Questo è normale, poiché non sono ancora stati inseriti nella pagina effettiva nessuno dei nuovi segmenti di pagina.

Seleziona Inserisci → Sezione della pagina. Qui dovrebbero apparire le aree che hai precedentemente separate in SectionTemplate.txt con il separatore Section.

Inserisci le sezioni necessarie una dopo l'altra per ricreare la pagina originale. Puoi successivamente spostare, omettere o inserire nuovamente le sezioni a piacimento.

Placeholder screenshot: Editor → Inserisci → Sezione pagina con i modelli di sezione importati – dev_bootstrap_import_sections_einfuegen.jpeg. Cattura ancora l'immagine e incorporala successivamente in questo punto.

11. Utilizzare la pagina originale come riferimento

Sotto File → bx_Import, puoi aprire ancora in anteprima il index.html originale. Usalo come riferimento mentre compili la tua nuova pagina CMS dalle singole sezioni.

Se inizialmente mancano immagini in alcuni modelli, il corretto trasferimento verrà trattato in un tutorial successivo.

12. Controllare i percorsi e la modificabilità di tutte le sezioni

Controlla infine ancora una volta Sezioni → Modello sezione e verifica tutti i percorsi locali. Per molti percorsi simili, puoi eseguire le modifiche in un editor di testo usando Ctrl + H in modo efficace.

Testa poi ciascuna sezione importata nell'editor. Controlla se tutti i contenuti vengono visualizzati correttamente e se i testi ed elementi previsti possono essere modificati.

Se, ad esempio, un testo non può essere modificato, controllane la struttura HTML. Se un testo normale si trova direttamente in un contenitore div, può avere senso spostarlo in un elemento p adeguato a seconda della struttura.

Placeholder screenshot: Homepage composta dopo l'inserimento e il posizionamento delle sezioni – dev_bootstrap_import_fertige_startseite.jpeg. Cattura ancora l'immagine e incorporala successivamente in questo punto.

13. Perché il layout viene suddiviso

Grazie alla separazione di intestazioni, piè di pagina, frame di layout e singole sezioni, non è necessario copiare continuamente questi componenti dal file Bootstrap originale per le nuove pagine.

L'intestazione e il piè di pagina centrali possono essere riutilizzati, mentre le singole sezioni delle pagine sono disponibili come modelli flessibili nell'editor. In questo modo, puoi assemblare diverse pagine da un modello Bootstrap e cambiare l'ordine dei contenuti in qualsiasi momento.

Riepilogo

Per l'importazione di Bootstrap 5, utilizzi i file originali sotto bx_Import come modello. L'intestazione e il piè di pagina vengono importati separatamente nelle rispettive aree CMS, l'area principale viene suddivisa in singoli modelli tramite SectionTemplate.txt e il frame HTML rimanente viene salvato sotto 00_layout → LayoutHTML.

Successivamente, seleziona il layout nelle impostazioni della pagina e compila la pagina tramite Inserisci → Sezione pagina dalle sezioni importate. Controlla infine tutti i percorsi, i riferimenti CSS e JavaScript e la modificabilità delle singole sezioni.

FAQ

cosa ci chiedono spesso i clienti

Perché il modello Bootstrap originale rimane sotto bx_Import?

La cartella bx_Import funge da punto di partenza e riferimento per il modello originale importato. I componenti necessari vengono quindi trasferiti nelle rispettive aree CMS.

Quale file utilizzo per il primo import?

In questo tutorial, si usa il index.html come punto di partenza. Da esso vengono separati intestazione, piè di pagina, sezioni principali e il frame di layout rimanente.

Come trovo rapidamente intestazione e piè di pagina nel codice HTML?

Usa Ctrl + F e cerca, ad esempio, header o footer. In modelli senza i tag HTML corrispondenti, devi esaminare più nel dettaglio le strutture div circostanti.

Dove vengono memorizzati i singoli blocchi di pagina?

I modelli vengono archiviati sotto bx_Layout in SectionTemplate.txt e separati l'uno dall'altro con il delimitatore <!--__SP_SectionTemplate__-->.

Quali marcatori richiede LayoutHTML?

Nei punti delle aree separate utilizzi __DB_Layout_Header__, __DB_Layout_Main__ e __DB_Layout_Footer__.

Perché i file CSS e JavaScript sono contrassegnati con __FV_?

In questo modo, il CMS può considerare la versione del file o la data di modifica durante il rendering. Dopo una modifica, il browser può quindi caricare il file attuale piuttosto che una versione cached obsoleta.

Perché la homepage appare vuota dopo l'importazione del layout?

Il layout fornisce inizialmente solo la cornice. Le sezioni vere e proprie devono essere inserite nella pagina tramite Inserisci → Sezione della pagina.

Posso riutilizzare una sezione della pagina importata più volte?

Sì. I modelli di sezione separati possono essere inseriti, spostati e riutilizzati più volte nell'editor a seconda delle necessità.

Cosa posso fare se i percorsi relativi per immagini o collegamenti non funzionano?

Controlla i percorsi locali href e src e, se necessario, aggiungi uno slash iniziale. Con Ctrl + H puoi sostituire percorsi ricorrenti, ma dovresti evitare di modificare in modo indiscriminato URL esterni, ancore e altri percorsi speciali.

Cosa posso fare se un testo non può essere modificato nell'editor?

Controlla la struttura HTML della sezione in questione. Se il testo normale si trova ad esempio direttamente all'interno di un contenitore div, potrebbe essere utile utilizzare un elemento p a seconda della struttura.

Come posso confrontare la pagina originale durante la ricostruzione?

Apri l'index.html originale sotto File → bx_Import tramite l'anteprima e utilizzala come riferimento per l'ordine e la struttura delle sezioni.

CMS