Sustituye las plantillas de DXPR Builder.
DXPR Builder renderiza sus elementos en el navegador, desde plantillas compiladas en el editor. No hay ninguna plantilla de elemento que puedas copiar en un tema. El módulo sí trae cuatro plantillas Twig para sus propias páginas, y las sustituyes de la forma normal de Drupal. Esta página las enumera, explica por qué el marcado de elementos no puede sustituirse y apunta a las rutas que el módulo admite.
Plantillas Twig que puedes sustituir
Las plantillas viven en la carpeta templates/ del módulo:
| Plantilla | Usada para | Variables |
|---|---|---|
dxpr-license-info.html.twig |
El resumen de uso en las páginas User Licenses y Content items, y License info como bloque | used_count, total_count, limit, block_label, total_label, used_label, more_info_link |
page--dxpr-builder--media-library.html.twig |
El envoltorio de página del diálogo Media Library en /dxpr_builder/media-library |
las variables page estándar |
html--dxpr-builder--media-library.html.twig |
El envoltorio <html> del mismo diálogo |
las variables html estándar |
page--people-list.html.twig |
Un punto de partida para la página People (/admin/people) con un resumen de licencias |
las variables page estándar más user_license |
Las tres primeras funcionan tal como están. Drupal no carga page--people-list.html.twig desde el módulo. DXPR Builder solo añade la sugerencia page__people_list y la variable user_license en la página People. Para mostrar el resumen ahí, copia el archivo en tu tema de administración.
Para sustituir una plantilla:
- Copia el archivo de
modules/contrib/dxpr_builder/templates/en la carpetatemplates/del tema que la renderiza. Las páginas de administración y el diálogo Media Library usan el tema de administración. El bloque License info usa el tema de la región donde lo pusiste. - Edita la copia.
- Limpia cachés con
drush cr.
Por qué el marcado de elementos no puede sustituirse
El marcado de cada elemento es una plantilla twig.js en dxpr_builder/templates/, por ejemplo elements/alert/alert.twig.html. La compilación compila estas plantillas en dxpr_builder/dxpr_templates.js. El editor las renderiza en el navegador y guarda el HTML resultante en el campo. Siguen dos cosas:
- Una plantilla cambiada necesita una reconstrucción del editor. Los sitios que cargan el editor desde la CDN de DXPR no pueden usar una plantilla cambiada.
- Las páginas guardadas conservan el HTML con que se guardaron. Una plantilla nueva solo afecta a elementos renderizados tras el cambio.
Así que el módulo no ofrece sustitución por sitio de plantillas de elementos. Usa una de las rutas siguientes.
Rutas de personalización admitidas
| Objetivo | Ruta |
|---|---|
| Diseños reutilizables para quienes editan | Page templates y User templates, ambos escogidos en el constructor |
| Cambiar el aspecto de elementos | CSS personalizado en el tema, apuntado a tus propias clases o las clases az-* correspondientes |
| Dar estilos con nombre a quienes editan | Clases de utilidades desde el .info.yml del tema, y estilos personalizados para el editor de texto |
| Conjuntos de iconos extra | Bibliotecas de iconos |
| Nuevos tipos de elementos | Creación de elementos personalizados |
¿Qué sigue?
- Page templates: el sistema de plantillas que usan quienes editan.
- Aplicación de temas a DXPR Builder: cómo encajan el CSS del constructor y tu tema.