---
url: 'https://dxpr.com/es/hc/documentation/learn-dxpr-builder/reference/config-reference'
title: 'Referencia de configuración | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T00:59:52+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  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.
tags:
  - 'Configuratie en API'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T09:09:48+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Referencia de configuración'
      description: |-
        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.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T00:59:52+0000'
      dateModified: '2026-10-24T09:09:48+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/es/hc/documentation/learn-dxpr-builder/reference/config-reference'
      articleSection: 'Configuratie en API'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/es/hc/documentation/learn-dxpr-builder/reference/config-reference'
      description: |-
        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.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Inicio
            item: 'https://dxpr.com/es'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: es
---
[Help Center](/es/hc)/[Documentation](/es/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Reference](/hc/documentation/learn-dxpr-builder/reference) /[Configuratie en API](/hc/documentation/learn-dxpr-builder/reference/config-and-api) # Referencia de configuración.

 Learn DXPR BuilderReferenceConfiguratie en API

   ## In this guide

 Related guides

- [Introduce tu clave de producto y los ajustes generales del sitio](/es/hc/documentation/learn-dxpr-builder/admin/general-settings)
- [Cortafuegos y residencia de datos](/es/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)
- [Endpoints de API](/es/hc/documentation/learn-dxpr-builder/reference/api-endpoints)

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:

```bash
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?

- [Ajustes generales](/hc/documentation/learn-dxpr-builder/admin/general-settings): el formulario de ajustes
- [Cortafuegos y residencia de datos](/es/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall): las claves que controlan las conexiones salientes
- [Endpoints de API](/es/hc/documentation/learn-dxpr-builder/reference/api-endpoints): rutas que leen esta configuración