Sobrepor modelos do DXPR Builder.
O DXPR Builder apresenta os elementos no navegador, a partir de modelos compilados no editor. Não há modelo de elemento para copiar para um tema. O módulo traz quatro modelos Twig para as próprias páginas, e esses sobrepõem-se da forma normal do Drupal. Esta página enumera-os, explica por que a marcação de elementos não pode ser sobreposta, e aponta para as rotas que o módulo suporta.
Modelos Twig que pode sobrepor
Os modelos vivem na pasta templates/ do módulo:
| Template | Used for | Variables |
|---|---|---|
dxpr-license-info.html.twig |
O resumo de utilização nas páginas User Licenses e Content items, e License info, o bloco | used_count, total_count, limit, block_label, total_label, used_label, more_info_link |
page--dxpr-builder--media-library.html.twig |
O invólucro de página do diálogo Media Library em /dxpr_builder/media-library |
as variáveis page padrão |
html--dxpr-builder--media-library.html.twig |
O invólucro <html> do mesmo diálogo |
as variáveis html padrão |
page--people-list.html.twig |
Um ponto de partida para a página People (/admin/people) com um resumo de licença |
as variáveis page padrão mais user_license |
Os três primeiros funcionam como estão. O Drupal não carrega page--people-list.html.twig a partir do módulo. O DXPR Builder só adiciona a sugestão page__people_list e a variável user_license na página People. Para mostrar lá o resumo, copie o ficheiro para o tema de administração.
Para sobrepor um modelo:
- Copie o ficheiro de
modules/contrib/dxpr_builder/templates/para a pastatemplates/do tema que o apresenta. As páginas de administração e o diálogo Media Library usam o tema de administração. O bloco License info usa o tema da região onde o colocou. - Edite a cópia.
- Limpe as caches com
drush cr.
Por que a marcação de elementos não pode ser sobreposta
A marcação de cada elemento é um modelo twig.js em dxpr_builder/templates/, por exemplo elements/alert/alert.twig.html. A compilação compila estes modelos em dxpr_builder/dxpr_templates.js. O editor apresenta-os no navegador e guarda o HTML resultante no campo. Seguem-se duas coisas:
- Um modelo alterado precisa de uma reconstrução do editor. Os sites que carregam o editor da CDN da DXPR não podem usar um modelo alterado.
- As páginas guardadas mantêm o HTML com que foram guardadas. Um modelo novo só afeta elementos apresentados após a alteração.
Por isso, o módulo não oferece sobreposição por site de modelos de elemento. Use uma das rotas abaixo.
Rotas de personalização suportadas
| Goal | Route |
|---|---|
| Esquemas reutilizáveis para editores | Modelos de página e Modelos de utilizador, ambos escolhidos no construtor |
| Mudar o aspeto dos elementos | CSS personalizado no tema, apontado às classes próprias ou às classes az-* do construtor |
| Dar aos editores estilos nomeados | Classes utilitárias do .info.yml do tema, e estilos personalizados para o editor de texto |
| Conjuntos de ícones extra | Bibliotecas de ícones |
| Novos tipos de elemento | Criar elementos personalizados |
O que se segue?
- Modelos de página: o sistema de modelos que os editores usam.
- Temas no DXPR Builder: como o CSS do construtor e o tema combinam.