O editor não aparece.

Learn DXPR BuilderManage the siteEen probleem oplossen

Abre uma página e nada acontece quando aponta para o conteúdo, ou os controlos aparecem mas a caixa de diálogo de definições nunca abre. Percorra as causas abaixo por ordem. As quatro primeiras cobrem a maioria dos casos.

Estou no formulário de edição do nó

O editor corre na própria página, não no formulário de edição. Guarde o nó, abra a página e aponte para a área de conteúdo. O editor também fica desligado em páginas de revisão, como /node/12/revisions/34/view.

A página mostra uma mensagem de chave de produto ou licença

O editor fica desligado enquanto uma destas mensagens aparece:

  • "DXPR Builder needs a product key to work". Não há chave de produto definida. Vá a DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) e preencha a secção License.
  • "Oops, the no-code editor is not loading here". A mensagem indica a causa: poucas licenças de utilizador, o limite de conteúdos do seu plano ou uma conta sem endereço de e-mail válido. Siga Erros de licença e chave de produto.
  • "Access to DXPR Builder is blocked because of a payment or licensing problem". A DXPR bloqueou o domínio do site. Contacte a DXPR pela ligação na mensagem.

A consola mostra erros 401 ou 403 de cdn2.dxpr.com

Com Asset source definido como Cloud, os scripts do editor carregam de cdn2.dxpr.com com a sua chave de produto no URL. Um 401 ou 403 significa que a CDN rejeitou a chave. Verifique a secção License de General Settings e depois siga Erros de licença e chave de produto. Se os pedidos expirarem antes, uma firewall bloqueia a CDN; veja Usar o DXPR Builder atrás de uma firewall.

O editor parou depois de uma atualização

  1. Corra drush updb -y (ou visite /update.php).
  2. Corra drush cr.
  3. Abra uma página do construtor e guarde-a de novo.

Se o registo indica um ficheiro em falta dentro da pasta do módulo, o código no servidor está incompleto. Reinstale o código:

  1. Apague a pasta modules/contrib/dxpr_builder.
  2. Corra composer require drupal/dxpr_builder.
  3. Corra drush cr.

Importante: nunca desinstale o módulo para o repor. Desinstalar apaga modelos guardados, perfis e definições.

Os controlos aparecem, mas as caixas de diálogo de definições nunca abrem

A consola mostra bootstrap is not defined ou um erro sobre getOrCreateInstance. As caixas de diálogo do editor correm em JavaScript de Bootstrap 5. A página não tem nenhum ou o tema carrega Bootstrap 3 ou 4.

  1. Vá a General Settings e abra a secção Bootstrap.
  2. Se o seu tema não carrega Bootstrap 5, defina Sideload Bootstrap files como Bootstrap 5 e clique em Save settings.
  3. Se o seu tema carrega JavaScript de Bootstrap 3 ou 4, deixe de o carregar ou mude para um tema Bootstrap 5.

A consola mostra um erro JavaScript de outro script

Outro script na página está a fazer o editor falhar. Nos tickets de suporte, os culpados foram faixas de consentimento de cookies, gestores de etiquetas, um embed do MailChimp e um agente de navegador New Relic. Os temas também causaram isto, através de um pacote Webpack ou do seu próprio JavaScript de Bootstrap 3 ou 4, tal como minificadores de JavaScript.

  1. Vá a Configuration > Development > Performance e desligue a agregação de JavaScript. Recarregue.
  2. Desative módulos de consentimento, análise e monitorização um de cada vez. Recarregue após cada um.
  3. Mude para um tema do núcleo como Olivero para um teste.

O que o resultado indica:

  • Resolvido no passo 1: um minificador é a causa. As bibliotecas auxiliares do editor, como Sortable, são agregadas com o resto da página, por isso Sortable is not defined com a agregação ligada aponta para aqui. Com Advanced CSS/JS Aggregation, mude o minificador de JSqueeze para JSMin.
  • Resolvido no passo 2: mantenha esse módulo desativado nas páginas de edição ou reporte o conflito ao seu responsável.
  • Resolvido no passo 3: o JavaScript do tema é a causa. Deixe de carregar JavaScript de Bootstrap 3 ou 4 do tema e defina Sideload Bootstrap files como Bootstrap 5.

A página mostra "The website encountered an unexpected error"

O registo mostra um stack trace por DxprBuilderService que indica uma vista ou uma classe de bloco de outro módulo.

Para editores, o construtor lista todas as apresentações de vistas e plugins de blocos para os poder adicionar às páginas. Para cada visitante, apresenta os blocos e vistas colocados na página. Uma vista ou um bloco defeituoso que cause um erro em qualquer dos passos deita a página abaixo.

  1. Abra Reports > Recent log messages e encontre a vista ou módulo indicado no trace.
  2. Corrija ou apague essa vista, ou desative esse módulo.
  3. Limpe todas as caches.

O editor nunca aparece num tipo de conteúdo

  1. Vá a Structure > Content types > (tipo) > Manage display.
  2. Defina o formato do campo do construtor como DXPR Builder.
  3. Repita para todos os modos de vista que apresentam o campo, não apenas Default.

Nota: o editor precisa de um campo com valor para se ligar. Quando guarda um nó, o DXPR Builder preenche um campo vazio que usa o formato DXPR Builder na apresentação Default. Um nó guardado antes de mudar o formato fica vazio: edite-o e guarde-o uma vez.

Só alguns utilizadores veem o editor

Verifique isto para a conta que não vê editor:

  1. Em People > Permissions (/admin/people/permissions), a função tem Edit with DXPR Builder.
  2. A função também pode editar esse conteúdo, por exemplo Basic page: Edit any content. O editor só carrega para utilizadores que podem atualizar a página.
  3. A conta tem um endereço de e-mail válido. O licenciamento precisa de um.
  4. No formulário de edição do utilizador, Exclude from DXPR builder editing não está marcado.
  5. Em DXPR Studio > DXPR Builder > User Profiles, o perfil dessa função tem Start editor when page loads marcado. Quando está desligado, os controlos só aparecem após um clique no ícone de olho dos controlos do contentor.

Outro editor bloqueou o conteúdo

Um aviso diz "The content ... is locked by" um colega e o contentor mostra apenas um botão Locked. Esse editor clicou no contentor e ainda não guardou; o bloqueio limpa quando guardar. Peça-lhe para guardar ou clique em Locked e confirme para assumir. Se ambos continuarem a editar, fica a valer o que se guardou por último.

Confirmar a correção

Recarregue numa janela privada e aponte para a área de conteúdo. A barra do contentor mostra View mode, More e Save, e a consola não mostra erros vermelhos.

E a seguir?

Problemas depois de atualizar se o editor deixou de funcionar logo depois de um lançamento.