Baixe o app agora e teste gratuitamente por 10 dias
Moeda Selecionar idioma Selecionar região

Objetivo do tutorial

Neste tutorial, você irá importar um layout existente do Bootstrap-5 para o CMS bluetronix. Durante isso, você dividirá a página HTML original em cabeçalho, rodapé, modelos de seção individuais e o próprio quadro de layout. Em seguida, você poderá inserir, mover e reutilizar livremente as seções da página no editor.

Aviso: Este tutorial aborda a importação básica de layout. A edição adicional ou substituição de imagens será abordada em um tutorial posterior.

1. Abrir o modelo original em bx_Import

Abra o gerenciador de arquivos e acesse a pasta bx_Import. O layout importado está inicialmente em seu estado original – por exemplo, com as pastas de imagens e arquivos HTML originais. Neste espaço, você trabalha apenas com os arquivos originais disponíveis; alterações não são salvas de volta no modelo original.

Para este exemplo, abra o arquivo index.html e mude para Editar. Este arquivo será agora dividido nos componentes individuais do layout do CMS.

Placeholder de captura de tela: Gerenciador de arquivos com a pasta bx_Import aberta, pastas de imagem e arquivos HTML originais – dev_bootstrap_import_bx_import_originaldateien.jpeg. Capturar a imagem e depois incorporar aqui.

Placeholder de captura de tela: index.html do bx_Import no editor HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. Capturar a imagem e depois incorporar aqui.

2. Isolar o cabeçalho do index.html

Pesquise no código HTML com Ctrl + F por header. Em muitos modelos do Bootstrap, o cabeçalho pode ser facilmente encontrado, pois está marcado com um elemento HTML correspondente. Em alguns modelos, o cabeçalho consiste apenas em uma área div; nesse caso, você deve examinar a estrutura mais de perto.

Selecione toda a área do cabeçalho e copie-a. É melhor trabalhar com duas janelas abertas, para que você possa alternar entre o modelo original e seu projeto CMS.

Placeholder de captura de tela: Área do cabeçalho do index.html encontrada pela pesquisa e marcada para cópia – dev_bootstrap_import_header_markieren.jpeg. Capturar a imagem e depois incorporar aqui.

3. Transferir o cabeçalho para o CMS

Volte ao seu projeto, abra o diretório principal e depois Cabeçalho → Código HTML. Cole o código do cabeçalho copiado anteriormente.

Em seguida, verifique os caminhos locais. Em muitos layouts, referências relativas e caminhos de imagem devem ser prefixados com uma barra inicial para funcionar corretamente dentro da estrutura do CMS.

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

Importante: Use Ctrl + H para buscar e substituir, mas não substitua caminhos cegamente. Verifique especialmente URLs externas, âncoras, links mailto: e já caminhos absolutos.

Placeholder de Captura de Tela: Diretório Principal → Cabeçalho → Código HTML com cabeçalho inserido – dev_bootstrap_import_header_html_einfuegen.jpeg. Capture a imagem e depois insira-a aqui.

Em seguida, procure o rodapé no index.html original. Corte ou copie a área completa do rodapé e cole-a no arquivo de rodapé apropriado no diretório principal do seu projeto. Verifique também todos os caminhos href e src locais.

Placeholder de Captura de Tela: Arquivo de Rodapé no Diretório Principal com o código de rodapé inserido – dev_bootstrap_import_footer_html_einfuegen.jpeg. Capture a imagem e depois insira-a aqui.

5. Dividir a seção principal em modelos de seção individuais

O conteúdo da página restante após o cabeçalho e rodapé não é copiado diretamente para o seu index.html. Em vez disso, abra bx_Layout → SectionTemplate.txt → Código HTML.

Insira a área Main restante do template original no final deste arquivo. Depois, divida-a nas diferentes áreas que deverão estar disponíveis separadamente no editor.

Entre dois templates de seção, você deve inserir exatamente o seguinte separador:

<!--__SP_SectionTemplate__-->

Cada seção separada pode mais tarde ser inserida como um template próprio no editor. Assim, você pode organizar as seções livremente, reutilizá-las várias vezes ou omiti-las em uma página.

Placeholder de Captura de Tela: bx_Layout → SectionTemplate.txt com várias Seções e o separador <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Capture a imagem e depois insira-a aqui.

6. Transferir o layout para 00_layout

Após destacar o cabeçalho, rodapé e seções principais, restará a estrutura HTML real, como por exemplo, com DOCTYPE, a área head e outros elementos de layout superiores. Copie este código restante.

Em seguida, abra o gerenciamento de banco de dados e edite o banco de dados 00_layout. Lá já existem templates de layout disponíveis. Você pode editar um template existente ou criar um novo layout.

Cole a estrutura copiada sob LayoutHTML. Nas posições originais do cabeçalho, conteúdo principal e rodapé, use as marcas do CMS:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Ao renderizar a página, estas marcas serão substituídas pelo respectivo cabeçalho, pela página principal atual e pelo rodapé. O código PHP correspondente sob LayoutPHP será executado automaticamente ao carregar o layout.

Placeholder de Captura de Tela: Banco de Dados 00_layout com LayoutHTML e as marcas para Cabeçalho, Main e Rodapé – dev_bootstrap_import_00_layout_layouthtml.jpeg. Capture a imagem e depois insira-a aqui.

7. Verificar os caminhos de CSS, JavaScript e Favicon

Verifique dentro do código de layout todas as referências a arquivos CSS, JavaScript e Favicon. Coloque a barra inicial necessária em caminhos locais. Para arquivos CSS e JavaScript, você também deve usar a marcação de versão do arquivo do CMS.

Uma chamada JavaScript pode, por exemplo, parecer assim:

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

A marcação __FV_...__ permite que o sistema considere a versão do arquivo ou a data de modificação ao ser renderizado. Isso permite que o navegador carregue o arquivo CSS ou JavaScript atual após alterações, sem que o usuário precise atualizar manualmente o cache do navegador.

8. Limpar o conteúdo do head e usar o HTML do cabeçalho

Verifique a área head importada e remova conteúdos que já tenham sido definidos pelo CMS ou carregados em outro lugar. Você também pode remover um título de página fixo, caso ele seja gerado automaticamente pelo sistema.

O código do cabeçalho que é necessário para o editor e não deve ser parte direta do LayoutHTML deve ser registrado sob Extras → Header-HTML. Assim, o editor poderá considerar os conteúdos registrados ali ao editar a página.

Placeholder de Captura de Tela: Extras → Header-HTML com o código de cabeçalho movido para lá – dev_bootstrap_import_extras_header_html.jpeg. Capture a imagem e depois insira-a aqui.

9. Selecionar o layout importado para a página

Se você criou um novo layout em 00_layout, abra no editor as Configurações da Página e selecione seu layout importado. Somente assim a respectiva página será apresentada com este quadro de layout.

Placeholder de Captura de Tela: Configurações da Página com seleção do novo layout importado – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Capture a imagem e depois insira-a aqui.

10. Montar a página inicial a partir das seções importadas

Clique em Editar na sua página. A página inicial pode parecer inicialmente vazia. Isso é normal, pois ainda nenhuma das novas seções foi inserida na página real.

Selecione Inserir → Seção da Página. Lá devem aparecer as áreas que você separou anteriormente em SectionTemplate.txt com o separador de seção.

Insira as seções necessárias uma a uma e recrie a página original. Você pode mover as seções, omití-las ou inseri-las várias vezes.

Placeholder de Captura de Tela: Editor → Inserir → Seção da Página com os templates de seção importados – dev_bootstrap_import_sections_einfuegen.jpeg. Capture a imagem e depois insira-a aqui.

11. Usar a página original como referência

Em Arquivos → bx_Import, você ainda pode abrir o original index.html como visualização. Use-o como referência enquanto monta sua nova página CMS a partir das seções individuais.

Se inicialmente faltarem imagens em alguns modelos, a correta inclusão delas será abordada em um tutorial posterior.

12. Verificar os caminhos e a editabilidade de todas as seções

Verifique novamente Seções → Modelo de Seção e revise todos os caminhos locais. Para muitos caminhos semelhantes, você pode fazer as alterações de forma eficiente em um editor de texto usando Ctrl + H.

Em seguida, teste cada seção importada no editor. Verifique se todo o conteúdo é exibido corretamente e se os textos e elementos previstos podem ser editados.

Se, por exemplo, um texto não puder ser editado, verifique a estrutura HTML dele. Se o texto normal estiver diretamente em um contêiner div, pode ser útil, dependendo da estrutura, mover o texto para um elemento p apropriado.

Placeholder de Screenshot: Página inicial montada após a inserção e ordenação das seções – dev_bootstrap_import_pagina_inicial_pronta.jpeg. Capture a imagem e depois a insira aqui.

13. Por que o layout é dividido

Com a separação do cabeçalho, rodapé, estrutura de layout e seções individuais, você não precisa copiar esses componentes da arquivo Bootstrap original toda vez que cria novas páginas.

O cabeçalho e o rodapé centrais podem ser reutilizados, enquanto as seções individuais estão disponíveis como modelos flexíveis no editor. Assim, você pode montar diferentes páginas a partir de um modelo Bootstrap e alterar a ordem dos conteúdos a qualquer momento.

Resumo

Para a importação do Bootstrap-5, você utiliza os arquivos originais em bx_Import como modelo. O cabeçalho e o rodapé são transferidos separadamente para as áreas designadas do CMS, a área principal é dividida em modelos individuais através de SectionTemplate.txt e o restante da estrutura HTML é salvo em 00_layout → LayoutHTML.

Em seguida, você seleciona o layout nas configurações da página e monta a página a partir das seções importadas através de Inserir → Seção da Página. Por fim, verifique todos os caminhos, referências CSS e JavaScript, bem como a editabilidade das seções individuais.

FAQ

o que os clientes nos perguntam frequentemente

Por que o template Bootstrap original permanece em bx_Import?

A pasta bx_Import serve como ponto de partida e referência para o template original importado. Os componentes necessários são extraídos dela para as respectivas áreas do CMS.

Qual arquivo eu uso para a primeira importação?

Neste tutorial, o arquivo index.html é usado como ponto de partida. A partir dele, cabeçalho, rodapé, seções principais e a estrutura restante são separados.

Como posso encontrar rapidamente o cabeçalho e o rodapé no código HTML?

Use Ctrl + F e procure, por exemplo, por cabeçalho ou rodapé. Para modelos sem as tags HTML correspondentes, você deve examinar mais de perto as estruturas div ao redor.

Onde as seções individuais da página são armazenadas?

Os modelos são armazenados em bx_Layout no SectionTemplate.txt e são separados pelo delimitador <!--__SP_SectionTemplate__-->.

Quais marcas são necessárias para o LayoutHTML?

Nos locais das áreas separadas, você usa __DB_Layout_Header__, __DB_Layout_Main__ e __DB_Layout_Footer__.

Por que arquivos CSS e JavaScript são marcados com __FV_?

Isso permite que o CMS considere a versão do arquivo ou a data de modificação ao renderizar. Após uma alteração, o navegador pode carregar o arquivo atual, em vez de usar uma versão antiga do cache.

Por que a página inicial está inicialmente vazia após a importação do layout?

O layout fornece apenas a estrutura no início. As seções reais da página devem ser inseridas na página através de Inserir → Seção da Página.

Posso reutilizar uma seção da página importada várias vezes?

Sim. Os modelos de seção separados podem ser inseridos, movidos e reutilizados no editor conforme necessário.

O que faço se caminhos de imagens ou links relativos não funcionarem?

Verifique os caminhos href e src locais e adicione uma barra inicial, se necessário. Com Ctrl + H você pode substituir caminhos recorrentes, mas não deve alterar URLs externas, âncoras e outros caminhos especiais indiscriminadamente.

O que posso fazer se um texto não puder ser editado no editor?

Verifique a estrutura HTML da seção em questão. Se o texto normal estiver diretamente em um contêiner div, pode ser apropriado usar um elemento p, dependendo da estrutura.

Como posso comparar a página original ao reconstruí-la?

Abra o arquivo index.html original em Arquivos → bx_Import através da visualização e use-o como referência para a ordem e estrutura das seções.

CMS