Descarga la app ahora y pruébala gratis durante 10 días
Moneda Seleccionar idioma Seleccionar región

Objetivo del tutorial

En este tutorial importarás un diseño Bootstrap 5 existente en el CMS bluetronix. Descompondrás la página HTML original en encabezado, pie de página, plantillas de secciones individuales y el marco de diseño principal. Luego, podrás insertar, mover y reutilizar libremente las secciones de página en el editor.

Nota: Este tutorial trata el importación básica de diseño. El procesamiento adicional o la sustitución de imágenes se tratará en un tutorial posterior.

1. Abrir plantilla original bajo bx_Import

Abre en el administrador de archivos la carpeta bx_Import. Allí, el diseño importado se encuentra inicialmente en su estado original - por ejemplo, con las carpetas de imágenes y archivos HTML originales. En esta área trabajarás solo con los archivos originales existentes; los cambios no se guardarán en la plantilla original.

Para este ejemplo, abre el archivo index.html y cambia a Editar. Este archivo se descompondrá ahora en los componentes individuales del diseño del CMS.

Placeholder de captura de pantalla: Administrador de archivos con carpeta bx_Import abierta, carpetas de imágenes y archivos HTML originales – dev_bootstrap_import_bx_import_originaldateien.jpeg. Toma la imagen y luego inclúyela aquí.

Placeholder de captura de pantalla: index.html de bx_Import en el editor HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. Toma la imagen y luego inclúyela aquí.

2. Separar el encabezado de index.html

Busca en el código HTML con Ctrl + F header. En muchas plantillas de Bootstrap, el encabezado se puede encontrar rápidamente porque está marcado con un elemento HTML correspondiente. En algunas plantillas, el encabezado consiste simplemente en un área de div; en este caso, debes revisar la estructura más de cerca.

Selecciona toda el área del encabezado y cópiala. Es mejor trabajar con dos ventanas abiertas, para poder alternar entre la plantilla original y tu proyecto CMS.

Placeholder de captura de pantalla: Área del encabezado de index.html encontrada a través de la búsqueda y seleccionada para copiar – dev_bootstrap_import_header_markieren.jpeg. Toma la imagen y luego inclúyela aquí.

3. Transferir el encabezado al CMS

Vuelve a tu proyecto, abre el directorio principal y luego Encabezado → Código HTML. Pega allí el código de encabezado que copiaste anteriormente.

Luego, verifica las rutas locales. En muchos diseños, las referencias relativas y las rutas de imágenes deben tener una barra diagonal al principio para funcionar correctamente dentro de la estructura del CMS.

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

Importante: Usa Ctrl + H para buscar y reemplazar, pero no reemplaces rutas sin pensar. En particular, revisa URL externas, anclas, enlaces mailto: y rutas absolutas ya existentes.

Placeholder de captura de pantalla: Directorio principal → Encabezado → Código HTML con encabezado pegado – dev_bootstrap_import_header_html_einfuegen.jpeg. Toma la imagen y luego inclúyela aquí.

A continuación, busca el pie de página en el index.html original. Corta o copia toda el área del pie de página y pégala en el archivo de pie de página designado en el directorio principal de tu proyecto. También verifica allí todas las rutas locales href y src.

Placeholder de captura de pantalla: Archivo de pie de página en el directorio principal con el código de pie de página pegado – dev_bootstrap_import_footer_html_einfuegen.jpeg. Toma la imagen y luego inclúyela aquí.

5. Dividir la sección principal en plantillas de sección individuales

El contenido restante de la página después del encabezado y el pie de página no se copia directamente en el index.html de tu proyecto. En su lugar, abre bx_Layout → SectionTemplate.txt → Código HTML.

Pega la parte principal restante de la plantilla original al final de este archivo. Luego, divídela en las secciones individuales que estarán disponibles más tarde por separado en el editor.

Entre dos plantillas de sección, coloca exactamente el siguiente separador:

<!--__SP_SectionTemplate__-->

Cada sección separada de esta manera puede ser más tarde insertada como plantilla propia en el editor. Esto te permite organizar libremente secciones, reutilizarlas o omitirlas en una página.

Placeholder de captura de pantalla: bx_Layout → SectionTemplate.txt con varias secciones y el separador <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Toma la imagen y luego inclúyela aquí.

6. Transferir el marco de diseño a 00_layout

Después de separar el encabezado, pie de página y secciones principales, queda el marco HTML propiamente dicho, que incluye DOCTYPE, la sección head y otros elementos de diseño de nivel superior. Copia este código restante.

Luego, abre la gestión de la base de datos y edita la base de datos 00_layout. Allí ya están disponibles plantillas de diseño. Puedes editar una plantilla existente o crear un nuevo diseño.

Pega el marco copiado bajo LayoutHTML. En las posiciones originales de encabezado, contenido principal y pie de página, utilizarás las marcas del CMS:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Al renderizar la página, estas marcas se sustituirán por el encabezado correspondiente, la página principal actual y el pie de página. El código PHP correspondiente bajo LayoutPHP se ejecutará automáticamente al cargar el diseño.

Placeholder de captura de pantalla: Base de datos 00_layout con LayoutHTML y las marcas para encabezado, principal y pie de página – dev_bootstrap_import_00_layout_layouthtml.jpeg. Toma la imagen y luego inclúyela aquí.

7. Revisar rutas de CSS, JavaScript y favicon

Revisa en el código del diseño todas las referencias a archivos CSS, JavaScript y favicon. Añade la barra diagonal inicial en las rutas locales. Para los archivos CSS y JavaScript, utiliza también la marca de versión del CMS.

Una llamada a JavaScript puede verse así:

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

La marca __FV_...__ permite al sistema considerar la versión de archivo o la fecha de modificación al renderizar. Esto permite que el navegador cargue el archivo CSS o JavaScript actual después de los cambios, sin que el usuario tenga que actualizar manualmente la caché de su navegador.

8. Limpiar el contenido del head y usar el HTML del encabezado

Revisa el área head adoptada y elimina contenido que ya ha sido establecido por el CMS o que se carga en otro lugar. También puedes eliminar un título de página fijo si este es generado automáticamente por el sistema.

El código del encabezado que necesita el editor y que no debe ser parte directa del LayoutHTML se guarda bajo Extras → Header-HTML. De esta manera, el editor puede tener en cuenta el contenido almacenado allí al editar la página.

Placeholder de captura de pantalla: Extras → Header-HTML con el código de encabezado movido allí – dev_bootstrap_import_extras_header_html.jpeg. Captura la imagen y luego inclúyela aquí.

9. Seleccionar el diseño importado para la página

Si has creado un nuevo diseño en 00_layout, abre en el editor la Configuración de página y selecciona tu diseño importado. Solo así se mostrará la página correspondiente con este marco de diseño.

Placeholder de captura de pantalla: Configuración de página con selección del diseño recién importado – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Captura la imagen y luego inclúyela aquí.

10. Componer la página de inicio a partir de las secciones importadas

Haz clic en tu página en Editar. La página de inicio puede aparecer inicialmente vacía. Es normal, ya que aún no se han insertado ninguna de las nuevas secciones en la página.

Selecciona Insertar → Sección de página. Allí deberían aparecer las áreas que separaste previamente en SectionTemplate.txt con el separador de secciones.

Inserta las secciones necesarias una por una y así reconstruye la página original. Puedes mover, omitir o insertar múltiples veces las secciones después.

Placeholder de captura de pantalla: Editor → Insertar → Sección de página con las plantillas de secciones importadas – dev_bootstrap_import_sections_einfuegen.jpeg. Captura la imagen y luego inclúyela aquí.

11. Usar la página original como referencia

Bajo Archivos → bx_Import puedes abrir la original index.html como vista previa. Úsala como referencia mientras ensamblas tu nueva página del CMS a partir de las secciones individuales.

Si faltan imágenes en algunas plantillas, su correcta transferencia se abordará en un tutorial posterior.

12. Revisar rutas y editabilidad de todas las secciones

Revisa al final nuevamente Secciones → Plantilla de Sección y verifica todas las rutas locales. Para muchas rutas similares, puedes realizar los cambios de manera eficiente en un editor de texto con Ctrl + H.

Luego, prueba cada sección importada en el editor. Verifica si todos los contenidos se muestran correctamente y si los textos y elementos previstos son editables.

Si por ejemplo un texto no se puede editar, revisa su estructura HTML. Si un texto normal está directamente dentro de un contenedor div, puede ser útil, dependiendo de la estructura, mover el texto a un elemento p adecuado.

Placeholder de captura de pantalla: Página de inicio completamente ensamblada después de insertar y organizar las secciones – dev_bootstrap_import_fertige_startseite.jpeg. Captura la imagen y luego inclúyela aquí.

13. ¿Por qué se descompone el diseño?

Debido a la separación de encabezados, pies de página, marco de diseño y secciones individuales, no es necesario copiar estos elementos de nuevo desde el archivo Bootstrap original para nuevas páginas.

El encabezado y pie de página centrales pueden reutilizarse, mientras que las secciones de páginas individuales están disponibles como plantillas flexibles en el editor. Así puedes ensamblar diferentes páginas a partir de una plantilla Bootstrap y cambiar el orden de los contenidos en cualquier momento.

Resumen

Para la importación de Bootstrap 5, utiliza los archivos originales en bx_Import como plantilla. El encabezado y el pie de página se incorporan por separado en las áreas del CMS correspondientes, el área principal se descompone en plantillas individuales a través de SectionTemplate.txt y el marco HTML restante se guarda en 00_layout → LayoutHTML.

Luego seleccionas el diseño en la configuración de la página y ensamblas la página a partir de las secciones importadas a través de Insertar → Sección de página. Al final, verifica todas las rutas, referencias CSS y JavaScript, así como la editabilidad de las secciones individuales.

Preguntas Frecuentes

lo que los clientes nos preguntan con frecuencia

¿Por qué se mantiene la plantilla Bootstrap original en bx_Import?

La carpeta bx_Import sirve como punto de partida y referencia para la plantilla original importada. Los componentes necesarios se trasladan desde allí a las respectivas áreas del CMS.

¿Qué archivo utilizo para la primera importación?

En este tutorial se utiliza index.html como punto de partida. De ella se separan el encabezado, el pie de página, las secciones principales y el marco de diseño restante.

¿Cómo encuentro rápidamente el encabezado y el pie de página en el código HTML?

Usa Ctrl + F y busca, por ejemplo, header o footer. En plantillas sin las etiquetas HTML correspondientes, deberás examinar más de cerca las estructuras div circundantes.

¿Dónde se guardan las diferentes secciones de la página?

Las plantillas se almacenan en bx_Layout en SectionTemplate.txt y se separan con el delimitador <!--__SP_SectionTemplate__-->.

¿Qué marcas necesita LayoutHTML?

En las posiciones de las áreas separadas utilizas __DB_Layout_Header__, __DB_Layout_Main__ y __DB_Layout_Footer__.

¿Por qué se marcan los archivos CSS y JavaScript con __FV_?

De esta manera, el CMS puede tener en cuenta la versión del archivo o la fecha de modificación al renderizar. Después de un cambio, el navegador puede cargar el archivo actual en lugar de usar una versión en caché desactualizada.

¿Por qué la página de inicio está inicialmente vacía después de importar el diseño?

El diseño inicialmente solo proporciona el marco. Las secciones reales de la página deben insertarse a través de Insertar → Sección en la página.

¿Puedo usar varias veces una sección de página importada?

Sí. Las plantillas de sección separadas pueden insertarse, moverse y reutilizarse en el editor según sea necesario.

¿Qué hago si las rutas de imágenes o enlaces relativas no funcionan?

Verifica las rutas href y src locales y añade, si es necesario, una barra inclinada al principio. Con Ctrl + H puedes reemplazar rutas recurrentes, pero no debes cambiar ciegamente URLs externas, anclas y otras rutas especiales.

¿Qué puedo hacer si un texto no se puede editar en el editor?

Verifica la estructura HTML de la sección en cuestión. Si texto normal, por ejemplo, está directamente en un contenedor div, un elemento p adecuado puede ser sensato según la estructura.

¿Cómo puedo comparar la página original al recrearla?

Abre el index.html original en Archivos → bx_Import a través de la vista previa y utilízalo como referencia para el orden y la estructura de las secciones.

CMS