Referencia de configuración.

Aprende DXPR BuilderReferenciaConfiguración y API

DXPR Builder guarda su configuración en el sistema de configuración de Drupal. Esta página lista cada clave declarada en config/schema/dxpr_builder.schema.yml con su tipo, sus valores permitidos y su valor por defecto. También lista la clave status de cada entidad de configuración y las claves de ajustes que el código lee sin entrada de esquema. Los nombres en negrita son las etiquetas del formulario.

El módulo no incluye config/install/dxpr_builder.settings.yml. Los valores por defecto los fijan hook_install() y hooks de actualización en dxpr_builder.install, o se aplican en el código cuando falta una clave; la columna Valor por defecto indica cuál.

Ajustes generales

Objeto de configuración: dxpr_builder.settings

Ruta de administración: /admin/dxpr_studio/dxpr_builder/settings (src/Form/DxprBuilderSettingsForm.php)

Clave Tipo Valores permitidos Valor por defecto Descripción
json_web_token string Una clave de producto DXPR (JWT) empty Product key, solo cuando api_key_storage es config. Se borra cuando la clave se guarda en el módulo Key; la actualización 9026 borra un valor olvidado allí.
api_key_storage string config (Configuration storage), key (Key module) not set (se trata como config); key después de que dxpr_builder_update_9020() mueva una clave existente Storage method para la clave de producto.
key_provider string Un id de entidad Key empty; la actualización 9020 fija dxpr_builder_jwt cuando mueve una clave existente Key: entidad que guarda la clave de producto cuando api_key_storage es key.
bootstrap string 0, bs5 not set (no se cargan archivos Bootstrap) Sideload Bootstrap files: 0 = None (theme provides Bootstrap), bs5 = Bootstrap 5. La actualización 8040 reescribe los valores quitados 1 y bs4 a bs5.
cke_stylesset string Una entrada [label]=[element].[class] por línea empty (el editor usa entonces los estilos incluidos con DXPR Builder) Custom styles para el editor de texto, por ejemplo Sassy Title=h1.sassy-title.
editor_assets_source integer 0, 1, 2 not set (0) Asset source: 0 = Cloud, 1 = Local (minified), 2 = Local (unminified). El campo solo aparece cuando hay una compilación local en la carpeta dxpr_builder/ del módulo. Con 0 guardado, esa compilación se usa igualmente, primero la no minificada.
format_filters boolean true, false not set (off) Apply text format filters to frontend content.
media_browser string '' (Basic file upload), media_library (Media Library), media_library_acquia_dam (Media Library (Acquia DAM)), o un id de Entity Browser media_library cuando el módulo Media Library está instalado; si no, dxpr_builder_media_modal cuando dxpr_builder_media está instalado; si no, '' (lo fija hook_install()) Browser type usado por los campos de imagen.
offset_selector string Un selector CSS .dxpr-theme-header--sticky, .dxpr-theme-header--fixed (se aplica cuando está vacío) Scroll offset selector para encabezados fijos.
controls_layout string element (On each element), breadcrumb (One row) element (se aplica cuando está vacío) Control bars en modo de edición: una barra en cada elemento, o una fila encima del elemento que apuntas. Un perfil y el ajuste propio de una cuenta lo sobrescriben. El ajuste de la cuenta no es configuración: se guarda con la cuenta de usuario (user.data, módulo dxpr_builder, nombre controls_layout).

Ajustes de IA

Guardados en el mismo objeto dxpr_builder.settings.

Ruta de administración: /admin/dxpr_studio/dxpr_builder/ai_settings (src/Form/DxprBuilderAiSettingsForm.php)

Clave Tipo Valores permitidos Valor por defecto Descripción
ai_enabled boolean true, false true cuando falta; fijado por la actualización 9008 Enable text editing assistant.
ai_page_enabled boolean true, false true cuando falta; fijado por la actualización 9012 Enable page creation assistant.
ai_image_enabled boolean true, false true cuando falta; fijado por la actualización 9015 Enable image generation.
ai_user_model_selection boolean true, false true cuando falta; fijado por la actualización 9016 Allow users to choose model. Solo aparece cuando ai_provider_dxpr no está instalado.
ai_model string dxai_kavya_m1, dxai_kavya_m1_eu, dxai_kavya_m1_fast dxai_kavya_m1 (AiModelConstants::getDefaultModel()) Default model. Los nombres de API son kavya-m1, kavya-m1-eu y kavya-m1-fast. Solo aparece y se guarda cuando ai_provider_dxpr no está instalado.
ai_provider_selection_mode string automatic (Automatic), manual (Manual priority) automatic Service providers mode. manual usa el orden de ai_providers. Solo se guarda cuando ai_provider_dxpr no está instalado.
ai_providers sequence of mappings keyed by provider id Claves: anthropic, gemini, mistral, openai, xai. Cada una tiene enabled (boolean), weight (integer) and region (enabled or disabled) empty (el formulario lista entonces las cinco como activadas) Tabla de prioridad de proveedores para el modo manual. region es la sección de tabla donde va la fila, no una región geográfica.
tone_of_voice_vocabulary string Un id de vocabulario de taxonomía ai_tone_of_voice (vocabulario creado por hook_install() cuando Taxonomía está activada, y por la actualización 9007) Tone of voice vocabulary. La actualización 9025 devuelve el valor a ai_tone_of_voice cuando el vocabulario guardado ya no existe.
enable_taxonomy_tones boolean true, false true cuando hay vocabulario de tonos Se fija a true con el vocabulario, por hook_install(), las actualizaciones o el formulario. Sin campo de formulario, y ningún código lo lee.
commands_vocabulary string Un id de vocabulario de taxonomía ai_agent_commands (creado por hook_install() cuando Taxonomía está activada, y por la actualización 9007, solo cuando la clave está vacía) Commands vocabulary.
enable_taxonomy_commands boolean true, false true cuando hay vocabulario de comandos Se fija a true con el vocabulario, por hook_install(), la actualización 9007 o el formulario. Sin campo de formulario, y ningún código lo lee.
ai_output_allowed_domains text Dominios, uno por línea (se permiten comodines como *.wikipedia.org); * permite todos; vacío bloquea todas las URL externas unsplash.com, images.unsplash.com, pexels.com, images.pexels.com, pixabay.com, promptahuman.com (set by hook_install() and update 9013) Allowed domains. Desmarcar Filter AI output en el formulario guarda *.
ai_output_allowed_tags text Nombres de etiquetas HTML, uno por línea Una lista de etiquetas comunes de texto, listas, tablas, en línea, medios y formularios (div a rp) aplicada en el formulario cuando falta la clave Allowed HTML tags; las etiquetas no listadas pierden su marcado pero conservan su texto.
ai_output_stripped_tags text Nombres de etiquetas HTML, uno por línea script, style Blocked tags, quitadas con su contenido. Desmarcar Filter AI output guarda script y style por defecto.

Claves leídas por el código sin campo de formulario

Estas claves no están en el esquema, pero el módulo las lee de dxpr_builder.settings. Fíjalas con drush config:set o una sobrescritura de configuración en settings.php.

Clave Tipo Valor por defecto cuando falta Descripción
record_analytics boolean true Envía analíticas de uso del editor a tuur.dxpr.com cuando es verdadero.
notifications boolean true Muestra avisos de DXPR en el editor cuando es verdadero.
cloud_url string https://cdn2.dxpr.com/VERSION/ URL base de CDN para recursos del editor; VERSION se cambia por la versión del módulo.
license_endpoint string https://dxpr.com/api/central-user-storage/ Endpoint para la sincronización de cuentas con licencia.

Plantillas de página

Objetos de configuración: dxpr_builder.page_template.* (tipo de entidad dxpr_builder_page_template)

Ruta de administración: /admin/dxpr_studio/dxpr_builder/page_template

Clave Tipo Valores permitidos Valor por defecto Descripción
id string Nombre de sistema required Identificador.
label label Cualquier texto required Label: nombre mostrado en el selector de plantillas.
status boolean true, false true Enabled. El editor solo ofrece y carga plantillas activadas.
category text Cualquier texto empty (el formulario lo exige) Category bajo la que se agrupa la plantilla.
template string HTML de DXPR Builder empty (el formulario lo exige) Template: marcado.
weight integer Cualquier entero empty (el editor lo lee como 0) Weight: orden de clasificación.
date integer Marca de tiempo Unix lo fija el formulario de edición en cada guardado Hora de última modificación.
image string Contenidos de imagen codificados en Base64 empty Image: miniatura.
uuid string UUID generated Id único universal.

El módulo incluye cinco plantillas de página en config/install: about_me, about_us, homepage_basic, split_content_and_buttons y text_columns.

Perfiles de usuario

Objetos de configuración: dxpr_builder.dxpr_builder_profile.* (tipo de entidad dxpr_builder_profile)

Ruta de administración: /admin/dxpr_studio/dxpr_builder/profile

En un perfil nuevo el formulario marca cada elemento, bloque, vista, plantilla de página activada, plantilla global de usuario activada y juego de iconos, además de un juego por defecto de botones del editor de texto. Los valores por defecto de abajo son los valores propios de la entidad.

Clave Tipo Valores permitidos Valor por defecto Descripción
id string Nombre de sistema required Identificador.
label label Cualquier texto required Label: nombre del perfil.
uuid string UUID generated Id único universal.
status boolean true, false true User profile enabled. Los perfiles desactivados se saltan al asignar los roles de una cuenta.
sidebar boolean true, false not stored Clave heredada: declarada en el esquema pero no exportada por la entidad, así que nunca se guarda.
dxpr_editor boolean true, false true; la actualización 8008 lo fijó en perfiles existentes Start editor when page loads. Cuando es false, los controles solo aparecen tras hacer clic en el icono de ojo en los controles del contenedor principal.
controls_layout string default (Same as the site), element (On each element), breadcrumb (One row) default Control bars en modo de edición para este perfil. El ajuste propio de una cuenta lo sobrescribe.
weight integer -10 a 10 en el formulario 0 Weight: cuando los roles de una cuenta coinciden con varios perfiles activados, gana el peso menor.
roles sequence of strings Nombres de sistema de roles (el formulario excluye anonymous y authenticated) empty Roles a los que se aplica el perfil.
elements sequence of strings Nombres de sistema de elementos (az_text, az_image, ...) empty Permitidos: Elements.
all_elements boolean true, false false Check/Uncheck all Elements. Cuando es true, cada elemento está permitido y elements se ignora.
blocks sequence of strings az_block-<block plugin id> values empty Permitidos: Blocks.
all_blocks boolean true, false false Check/Uncheck all Blocks. Cuando es true, cada bloque está permitido, incluidos los añadidos después.
views sequence of strings az_view-<view id>-<display id> values empty Pantallas permitidas de Views.
all_views boolean true, false false Check/Uncheck all Views. Cuando es true, cada pantalla de vistas está permitida, incluidas las añadidas después.
page_templates sequence of strings UUID de plantillas de página empty Permitidas: Page templates.
all_page_templates boolean true, false false Check/Uncheck all Page templates. Cuando es true, cada plantilla de página está permitida.
user_templates sequence of strings UUID de plantillas globales de usuario empty Permitidas: Global user templates.
all_user_templates boolean true, false false Check/Uncheck all Global user templates. Cuando es true, cada plantilla global de usuario está permitida.
icon_sets sequence of strings ID de juegos de iconos de los archivos *.dxpr_icon_sets.yml correspondientes empty Permitidos: Icon sets.
all_icon_sets boolean true, false not set (cuenta como true) Check/Uncheck all Icon sets. Cuando es true o falta, cada juego de iconos está permitido.
inline_buttons sequence of strings Nombres de botones de CKEditor 5 empty Text editor buttons (inline editing). La actualización 8036 migró nombres de CKEditor 4 en esta lista y en modal_buttons.
modal_buttons sequence of strings Nombres de botones de CKEditor 5 empty Text editor buttons (modal editing).

Plantillas de usuario

Objetos de configuración: dxpr_builder.user_template.* (tipo de entidad dxpr_builder_user_template)

Ruta de administración: /admin/dxpr_studio/dxpr_builder/user_templates

Clave Tipo Valores permitidos Valor por defecto Descripción
id string Nombre de sistema required Identificador.
label label Cualquier texto required Label: nombre de la plantilla.
status boolean true, false true Sin campo de formulario. Solo las plantillas activadas se pueden cargar en el editor o copiar en una plantilla de página.
type string El tipo de elemento data-azb del que se guardó la plantilla, por ejemplo section, row, az_block, az_view o custom custom Type. La actualización 9021 lo rellena desde el marcado; los valores az_block_* y az_view_* colapsan a az_block y az_view.
template string HTML de DXPR Builder empty Template: marcado. La actualización 8013 movió las plantillas de usuario de una tabla de base de datos a configuración.
uid integer ID de cuenta required (en el formulario) UID: la cuenta propietaria.
global boolean true, false true (la petición de guardado del editor envía su propio valor) Global: true deja la plantilla al alcance de todas las cuentas (según perfiles); false la deja privada (solo la ve la cuenta propietaria).
image string Contenidos de imagen codificados en Base64 empty Image: miniatura.
uuid string UUID generated Id único universal.

Exportar la configuración

Exporta toda la configuración de DXPR Builder:

drush config:export

Esto exporta ajustes, perfiles, plantillas de página y plantillas de usuario como archivos YAML en el directorio de sincronización de configuración. Cuando api_key_storage es key, la clave de producto no forma parte de dxpr_builder.settings. Vive en la entidad Key elegida y sigue al proveedor de esa clave, como configuración, un archivo o una variable de entorno.

¿Qué sigue?