El editor no aparece.

Aprende DXPR BuilderGestionar el sitioResolver un problema

Abres una página y no pasa nada cuando apuntas al contenido, o los controles aparecen pero el diálogo de ajustes nunca se abre. Sigue las causas de abajo en orden. Las cuatro primeras cubren la mayoría de casos.

Estoy en el formulario de edición del nodo

El editor funciona en la propia página, no en el formulario de edición. Guarda el nodo, abre la página y apunta al área de contenido. El editor también queda apagado en páginas de revisión, como /node/12/revisions/34/view.

La página muestra un mensaje de clave de producto o licencia

El editor queda apagado mientras aparece uno de estos mensajes:

  • «DXPR Builder needs a product key to work». No hay clave de producto. Ve a DXPR Studio > DXPR Builder > Ajustes generales (/admin/dxpr_studio/dxpr_builder/settings) y rellena la sección Licencia.
  • «Oops, the no-code editor is not loading here». El mensaje nombra la causa: pocas licencias de usuario, el límite de elementos de contenido de tu plan, o una cuenta sin dirección de correo válida. Sigue Errores de licencia y clave de producto.
  • «Access to DXPR Builder is blocked because of a payment or licensing problem». DXPR bloqueó el dominio del sitio. Contacta con DXPR desde el enlace del mensaje.

La consola muestra errores 401 o 403 de cdn2.dxpr.com

Con Origen de recursos en Nube, los scripts del editor cargan desde cdn2.dxpr.com con tu clave de producto en la URL. Un 401 o 403 significa que la CDN rechazó la clave. Revisa la sección Licencia de los ajustes generales y sigue Errores de licencia y clave de producto. Si las peticiones agotan el tiempo de espera, un cortafuegos bloquea la CDN; lee Usar DXPR Builder tras un cortafuegos.

El editor se detuvo tras una actualización

  1. Ejecuta drush updb -y (o visita /update.php).
  2. Ejecuta drush cr.
  3. Abre una página del constructor y guárdala de nuevo.

Si el registro informa de un archivo ausente dentro de la carpeta del módulo, el código en el servidor está incompleto. Reinstala el código:

  1. Borra la carpeta modules/contrib/dxpr_builder.
  2. Ejecuta composer require drupal/dxpr_builder.
  3. Ejecuta drush cr.

Importante: nunca desinstales el módulo para restablecerlo. Desinstalar borra plantillas guardadas, perfiles y ajustes.

Los controles aparecen, pero los diálogos de ajustes nunca se abren

La consola muestra bootstrap is not defined, o un error sobre getOrCreateInstance. Los diálogos del editor usan el JavaScript de Bootstrap 5. La página no tiene ninguno, o el tema carga Bootstrap 3 o 4 en su lugar.

  1. Ve a los ajustes generales y abre la sección Bootstrap.
  2. Si tu tema no carga Bootstrap 5, pon Cargar archivos Bootstrap en Bootstrap 5 y haz clic en Guardar ajustes.
  3. Si tu tema carga JavaScript de Bootstrap 3 o 4, deja de cargarlo o cambia a un tema Bootstrap 5.

La consola muestra un error de JavaScript de otro script

Otro script de la página está rompiendo el editor. En tickets de soporte los culpables fueron banners de consentimiento de cookies, gestores de etiquetas, un embed de MailChimp y un agente de navegador de New Relic. Los temas también lo causaron, con un bundle de Webpack o su propio JavaScript de Bootstrap 3 o 4, y también los minificadores de JavaScript.

  1. Ve a Configuración > Desarrollo > Rendimiento y desactiva la agregación de JavaScript. Recarga.
  2. Desactiva módulos de consentimiento, analítica y monitorización de uno en uno. Recarga tras cada uno.
  3. Cambia a un tema del núcleo como Olivero para una prueba.

Lo que te dice el resultado:

  • Lo arregla el paso 1: la causa es un minificador. Las bibliotecas de ayuda del editor, como Sortable, se agregan con el resto de la página, así que Sortable is not defined con la agregación activada apunta aquí. Con Advanced CSS/JS Aggregation, cambia el minificador de JSqueeze a JSMin.
  • Lo arregla el paso 2: deja ese módulo desactivado en páginas de edición, o informa del conflicto a su responsable.
  • Lo arregla el paso 3: la causa es el JavaScript del tema. Deja de cargar JavaScript de Bootstrap 3 o 4 desde el tema, y pon Cargar archivos Bootstrap en Bootstrap 5.

La página muestra «The website encountered an unexpected error»

El registro muestra una traza que pasa por DxprBuilderService y nombra una vista o una clase de bloque de otro módulo.

Para el equipo de edición, el constructor lista cada pantalla de vista y plugin de bloque para que los añadas a las páginas. Para cada visitante, muestra los bloques y vistas puestos en la página. Una vista o bloque roto que lanza un error en cualquier paso tumba la página.

  1. Abre Informes > Mensajes recientes del registro y encuentra la vista o el módulo nombrado en la traza.
  2. Arregla o borra esa vista, o desactiva ese módulo.
  3. Vacía todas las cachés.

El editor nunca aparece en un tipo de contenido

  1. Ve a Estructura > Tipos de contenido > (tipo) > Gestionar visualización.
  2. Pon el formato del campo del constructor en DXPR Builder.
  3. Repite para cada modo de vista que muestra el campo, no solo Por defecto.

Nota: el editor necesita un campo con valor al que unirse. Cuando guardas un nodo, DXPR Builder rellena un campo vacío que usa el formato DXPR Builder en la visualización Por defecto. Un nodo guardado antes de que cambiaras el formato queda vacío: edítalo y guárdalo una vez.

Solo algunas cuentas ven el editor

Revisa esto para la cuenta que no ve el editor:

  1. En Personas > Permisos (/admin/people/permissions), el rol tiene Editar con DXPR Builder.
  2. El rol también puede editar ese contenido, por ejemplo Página básica: editar cualquier contenido. El editor solo carga para cuentas que pueden actualizar la página.
  3. La cuenta tiene una dirección de correo válida. Las licencias la necesitan.
  4. En el formulario de edición de la cuenta, Excluir de la edición con DXPR builder no está marcado.
  5. En DXPR Studio > DXPR Builder > Perfiles de usuario, el perfil de ese rol tiene Iniciar el editor al cargar la página marcado. Cuando está desactivado, los controles solo aparecen tras un clic en el icono de ojo de los controles del contenedor.

Otra persona que edita bloqueó el contenido

Un aviso dice que el contenido «está bloqueado por» un colega, y el contenedor solo muestra un botón Bloqueado. Esa persona entró en el contenedor y aún no guardó; el bloqueo se quita cuando guarda. Pídele que guarde, o haz clic en Bloqueado y confirma para tomar el control. Si ambas siguen editando, gana el último guardado.

Confirma el arreglo

Recarga en una ventana privada y apunta al área de contenido. La barra del contenedor muestra Modo de vista, Más y Guardar, y la consola no muestra errores rojos.

¿Qué sigue?

Problemas tras actualizar si el editor se rompió justo tras una versión.