---
url: 'https://dxpr.com/it/hc/documentation/learn-dxpr-builder/reference/config-reference'
title: 'Riferimento alla configurazione | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-23T23:58:49+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  DXPR Builder salva la sua configurazione nel sistema di
  configurazione di Drupal. Questa pagina elenca ogni chiave
  dichiarata in config/schema/dxpr_builder.schema.yml
  con tipo, valori consentiti e valore predefinito. Elenca anche la
  chiave status di ogni entità di configurazione
  e le chiavi di impostazione lette dal codice senza
  voce di schema. I nomi in grassetto sono le etichette del form.
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: 'Riferimento alla configurazione'
      description: |-
        DXPR Builder salva la sua configurazione nel sistema di
        configurazione di Drupal. Questa pagina elenca ogni chiave
        dichiarata in config/schema/dxpr_builder.schema.yml
        con tipo, valori consentiti e valore predefinito. Elenca anche la
        chiave status di ogni entità di configurazione
        e le chiavi di impostazione lette dal codice senza
        voce di schema. I nomi in grassetto sono le etichette del form.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-23T23:58:49+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/it/hc/documentation/learn-dxpr-builder/reference/config-reference'
      articleSection: 'Configuratie en API'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/it/hc/documentation/learn-dxpr-builder/reference/config-reference'
      description: |-
        DXPR Builder salva la sua configurazione nel sistema di
        configurazione di Drupal. Questa pagina elenca ogni chiave
        dichiarata in config/schema/dxpr_builder.schema.yml
        con tipo, valori consentiti e valore predefinito. Elenca anche la
        chiave status di ogni entità di configurazione
        e le chiavi di impostazione lette dal codice senza
        voce di schema. I nomi in grassetto sono le etichette del form.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Home
            item: 'https://dxpr.com/it'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: it
---
[Help Center](/it/hc)/[Documentation](/it/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) # Riferimento alla configurazione.

 Learn DXPR BuilderReferenceConfiguratie en API

   ## In this guide

 Related guides

- [Inserisci la chiave prodotto e le impostazioni per l’intero sito](/it/hc/documentation/learn-dxpr-builder/admin/general-settings)
- [Firewall and data residency](/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)
- [Endpoint API](/it/hc/documentation/learn-dxpr-builder/reference/api-endpoints)

DXPR Builder salva la sua configurazione nel sistema di configurazione di Drupal. Questa pagina elenca ogni chiave dichiarata in `config/schema/dxpr_builder.schema.yml`con tipo, valori consentiti e valore predefinito. Elenca anche la chiave `status` di ogni entità di configurazione e le chiavi di impostazione lette dal codice senza voce di schema. I nomi in grassetto sono le etichette del form.

Il modulo non fornisce `config/install/dxpr_builder.settings.yml`. I valori predefiniti sono impostati da `hook_install()` e dagli hook di aggiornamento in `dxpr_builder.install`, o applicati nel codice quando una chiave manca; la colonna **Default**dice quale dei due.

## Impostazioni generali

Oggetto di configurazione: `dxpr_builder.settings`

Percorso admin: `/admin/dxpr_studio/dxpr_builder/settings`(`src/Form/DxprBuilderSettingsForm.php`)

| Chiave | Tipo | Valori consentiti | Valore predefinito | Descrizione |
|---|---|---|---|---|
| `json_web_token` | string | Una chiave prodotto DXPR (JWT) | vuoto | **Product key**, solo quando `api_key_storage` è `config`. Cancellato quando la chiave è salvata nel modulo Key; l’aggiornamento 9026 cancella un valore rimasto lì. |
| `api_key_storage` | string | `config` (**Configuration storage**), `key` (**Key module**) | non impostato (trattato come `config`); `key` dopo che `dxpr_builder_update_9020()` sposta una chiave esistente | **Storage method** per la chiave prodotto. |
| `key_provider` | string | Un id di entità Key | vuoto; l’aggiornamento 9020 imposta `dxpr_builder_jwt` quando sposta una chiave esistente | **Key**: l’entità che contiene la chiave prodotto quando `api_key_storage` è `key`. |
| `bootstrap` | string | `0`, `bs5` | non impostato (nessun file Bootstrap caricato) | **Sideload Bootstrap files**: `0` = **None (theme provides Bootstrap)**, `bs5` = **Bootstrap 5**. L’aggiornamento 8040 riscrive i valori rimossi `1` e `bs4` in `bs5`. |
| `cke_stylesset` | string | Una voce `[label]=[element].[class]` per riga | vuoto (l’editor usa allora gli stili forniti con DXPR Builder) | **Custom styles** per l’editor di testo, per esempio `Sassy Title=h1.sassy-title`. |
| `editor_assets_source` | integer | `0`, `1`, `2` | non impostato (`0`) | **Asset source**: `0` = **Cloud**, `1` = **Local (minified)**, `2` = **Local (unminified)**. Il campo compare solo quando esiste una build locale nella cartella `dxpr_builder/` del modulo. Con `0` salvato, tale build è comunque usata, prima quella non minificata. |
| `format_filters` | boolean | `true`, `false` | non impostato (spento) | **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 Entity Browser | `media_library` quando il modulo Media Library è installato, altrimenti `dxpr_builder_media_modal` quando `dxpr_builder_media` è installato, altrimenti `''` (impostato da `hook_install()`) | **Browser type** usato dai campi immagine. |
| `offset_selector` | string | Un selettore CSS | `.dxpr-theme-header--sticky, .dxpr-theme-header--fixed` (applicato quando vuoto) | **Scroll offset selector** per header fissi. |
| `controls_layout` | string | `element` (**On each element**), `breadcrumb` (**One row**) | `element` (applicato quando vuoto) | **Control bars** in modalità modifica: una barra su ogni elemento, o una riga sopra l’elemento indicato. Un profilo e l’impostazione propria di un utente lo sovrascrivono. L’impostazione dell’utente non è configurazione: è salvata con l’account utente (`user.data`, modulo `dxpr_builder`, nome `controls_layout`). |

### Impostazioni AI

Salvate nello stesso oggetto `dxpr_builder.settings`.

Percorso admin: `/admin/dxpr_studio/dxpr_builder/ai_settings`(`src/Form/DxprBuilderAiSettingsForm.php`)

| Chiave | Tipo | Valori consentiti | Valore predefinito | Descrizione |
|---|---|---|---|---|
| `ai_enabled` | boolean | `true`, `false` | `true` quando manca; impostato dall’aggiornamento 9008 | **Enable text editing assistant**. |
| `ai_page_enabled` | boolean | `true`, `false` | `true` quando manca; impostato dall’aggiornamento 9012 | **Enable page creation assistant**. |
| `ai_image_enabled` | boolean | `true`, `false` | `true` quando manca; impostato dall’aggiornamento 9015 | **Enable image generation**. |
| `ai_user_model_selection` | boolean | `true`, `false` | `true` quando manca; impostato dall’aggiornamento 9016 | **Allow users to choose model**. Mostrato solo quando `ai_provider_dxpr` non è installato. |
| `ai_model` | string | `dxai_kavya_m1`, `dxai_kavya_m1_eu`, `dxai_kavya_m1_fast` | `dxai_kavya_m1` (`AiModelConstants::getDefaultModel()`) | **Default model**. I nomi API sono `kavya-m1`, `kavya-m1-eu` e `kavya-m1-fast`. Mostrato e salvato solo quando `ai_provider_dxpr` non è installato. |
| `ai_provider_selection_mode` | string | `automatic` (**Automatic**), `manual` (**Manual priority**) | `automatic` | **Service providers**. La modalità `manual` usa l’ordine in `ai_providers`. Salvato solo quando `ai_provider_dxpr` non è installato. |
| `ai_providers` | sequence of mappings keyed by provider id | Chiavi: `anthropic`, `gemini`, `mistral`, `openai`, `xai`. Ciascuna ha `enabled` (boolean), `weight` (integer) e `region` (`enabled` o `disabled`) | vuoto (il form elenca allora tutti e cinque come attivi) | Tabella di priorità dei provider per la modalità `manual`. `region` è la sezione di tabella in cui sta la riga, non un’area geografica. |
| `tone_of_voice_vocabulary` | string | Un id di vocabolario di tassonomia | `ai_tone_of_voice` (vocabolario creato da `hook_install()` quando Taxonomy è attivo, e dall’aggiornamento 9007) | **Tone of voice vocabulary**. L’aggiornamento 9025 riporta il valore a `ai_tone_of_voice` quando il vocabolario salvato non esiste più. |
| `enable_taxonomy_tones` | boolean | `true`, `false` | `true` una volta impostato un vocabolario di toni | Impostato su `true` con il vocabolario, da `hook_install()`, dagli aggiornamenti o dal form. Nessun campo di form e nessun codice lo legge. |
| `commands_vocabulary` | string | Un id di vocabolario di tassonomia | `ai_agent_commands` (creato da `hook_install()` quando Taxonomy è attivo, e dall’aggiornamento 9007, solo quando la chiave è vuota) | **Commands vocabulary**. |
| `enable_taxonomy_commands` | boolean | `true`, `false` | `true` una volta impostato un vocabolario di comandi | Impostato su `true` con il vocabolario, da `hook_install()`, dall’aggiornamento 9007 o dal form. Nessun campo di form e nessun codice lo legge. |
| `ai_output_allowed_domains` | text | Domini uno per riga (wildcard come `*.wikipedia.org` consentite); `*` consente tutto; vuoto blocca tutti gli URL esterni | `unsplash.com`, `images.unsplash.com`, `pexels.com`, `images.pexels.com`, `pixabay.com`, `promptahuman.com` (impostati da `hook_install()` e dall’aggiornamento 9013) | **Allowed domains**. Deselezionare **Filter AI output** nel form salva `*`. |
| `ai_output_allowed_tags` | text | Nomi di tag HTML uno per riga | Un elenco di comuni tag di testo, elenchi, tabelle, inline, media e form (da `div` a `rp`) applicato nel form quando la chiave manca | **Allowed HTML tags**; i tag non elencati perdono il markup ma conservano il testo. |
| `ai_output_stripped_tags` | text | Nomi di tag HTML uno per riga | `script`, `style` | **Blocked tags**, rimossi con i loro contenuti. Deselezionare **Filter AI output** salva i predefiniti `script` e `style`. |

### Chiavi lette dal codice senza campo di form

Queste chiavi non sono nello schema ma il modulo le legge da `dxpr_builder.settings`. Impostale con `drush config:set` o un override di configurazione in `settings.php`.

| Chiave | Tipo | Valore predefinito quando manca | Descrizione |
|---|---|---|---|
| `record_analytics` | boolean | `true` | Invia le analisi d’uso dell’editor a `tuur.dxpr.com` quando true. |
| `notifications` | boolean | `true` | Mostra le notifiche DXPR nell’editor quando true. |
| `cloud_url` | string | `https://cdn2.dxpr.com/VERSION/` | URL base CDN per gli asset dell’editor; `VERSION` è sostituito con la versione del modulo. |
| `license_endpoint` | string | `https://dxpr.com/api/central-user-storage/` | Endpoint per la sincronizzazione degli utenti con licenza. |

## Modelli di pagina

Oggetti di configurazione: `dxpr_builder.page_template.*`(tipo di entità `dxpr_builder_page_template`)

Percorso admin: `/admin/dxpr_studio/dxpr_builder/page_template`

| Chiave | Tipo | Valori consentiti | Valore predefinito | Descrizione |
|---|---|---|---|---|
| `id` | string | Machine name | obbligatorio | Identificatore. |
| `label` | label | Qualsiasi testo | obbligatorio | **Label**: nome mostrato nella scelta dei modelli. |
| `status` | boolean | `true`, `false` | `true` | **Enabled**. L’editor offre e carica solo modelli attivi. |
| `category` | text | Qualsiasi testo | vuoto (il form lo richiede) | **Category** sotto cui è raggruppato il modello. |
| `template` | string | HTML DXPR Builder | vuoto (il form lo richiede) | **Template**: il markup. |
| `weight` | integer | Qualsiasi intero | vuoto (l’editor lo legge come `0`) | **Weight**: ordine di ordinamento. |
| `date` | integer | Timestamp Unix | impostato dal form di modifica a ogni salvataggio | Ora dell’ultima modifica. |
| `image` | string | Contenuti immagine codificati in base64 | vuoto | **Image**: miniatura. |
| `uuid` | string | UUID | generato | Id universalmente unico. |

Il modulo fornisce cinque modelli di pagina in `config/install`: `about_me`, `about_us`, `homepage_basic`, `split_content_and_buttons` e `text_columns`.

## Profili utente

Oggetti di configurazione: `dxpr_builder.dxpr_builder_profile.*`(tipo di entità `dxpr_builder_profile`)

Percorso admin: `/admin/dxpr_studio/dxpr_builder/profile`

In un nuovo profilo il form seleziona ogni elemento, blocco, visualizzazione, modello di pagina attivo, modello utente globale attivo e set di icone, più un set predefinito di pulsanti dell’editor di testo. I valori sotto sono quelli propri dell’entità.

| Chiave | Tipo | Valori consentiti | Valore predefinito | Descrizione |
|---|---|---|---|---|
| `id` | string | Machine name | obbligatorio | Identificatore. |
| `label` | label | Qualsiasi testo | obbligatorio | **Label**: nome del profilo. |
| `uuid` | string | UUID | generato | Id universalmente unico. |
| `status` | boolean | `true`, `false` | `true` | **User profile enabled**. I profili disattivati sono saltati quando si abbinano i ruoli di un utente. |
| `sidebar` | boolean | `true`, `false` | non salvato | Chiave precedente: dichiarata nello schema ma non esportata dall’entità, quindi non viene mai salvata. |
| `dxpr_editor` | boolean | `true`, `false` | `true`; l’aggiornamento 8008 lo ha impostato sui profili esistenti | **Start editor when page loads**. Quando `false`, i controlli compaiono solo dopo che l’utente fa clic sull’icona occhio sui controlli del contenitore principale. |
| `controls_layout` | string | `default` (**Same as the site**), `element` (**On each element**), `breadcrumb` (**One row**) | `default` | **Control bars** in modalità modifica per questo profilo. L’impostazione propria di un utente lo sovrascrive. |
| `weight` | integer | `-10` a `10` nel form | `0` | **Weight**: quando i ruoli di un utente corrispondono a più profili attivi, vince il peso più basso. |
| `roles` | sequence of strings | Machine name di ruolo (il form esclude `anonymous` e `authenticated`) | vuoto | **Roles** a cui si applica il profilo. |
| `elements` | sequence of strings | Machine name di elemento (`az_text`, `az_image`, …) | vuoto | Gli **Elements** consentiti. |
| `all_elements` | boolean | `true`, `false` | `false` | **Check/Uncheck all Elements**. Quando `true`, ogni elemento è consentito e `elements` è ignorato. |
| `blocks` | sequence of strings | `az_block-<id plugin di blocco>` ammessi | vuoto | I **Blocks** consentiti. |
| `all_blocks` | boolean | `true`, `false` | `false` | **Check/Uncheck all Blocks**. Quando `true`, ogni blocco è consentito, compresi quelli aggiunti in seguito. |
| `views` | sequence of strings | `az_view-<id vista>-<id visualizzazione>` ammessi | vuoto | Visualizzazioni **Views** consentite. |
| `all_views` | boolean | `true`, `false` | `false` | **Check/Uncheck all Views**. Quando `true`, ogni visualizzazione è consentita, comprese quelle aggiunte in seguito. |
| `page_templates` | sequence of strings | UUID di modelli di pagina | vuoto | I **Page templates** consentiti. |
| `all_page_templates` | boolean | `true`, `false` | `false` | **Check/Uncheck all Page templates**. Quando `true`, ogni modello di pagina è consentito. |
| `user_templates` | sequence of strings | UUID di modelli utente globali | vuoto | I **Global user templates** consentiti. |
| `all_user_templates` | boolean | `true`, `false` | `false` | **Check/Uncheck all Global user templates**. Quando `true`, ogni modello utente globale è consentito. |
| `icon_sets` | sequence of strings | Id di set di icone: i file `*.dxpr_icon_sets.yml`. | vuoto | Gli **Icon sets** consentiti. |
| `all_icon_sets` | boolean | `true`, `false` | non impostato (conta come `true`) | **Check/Uncheck all Icon sets**. Quando `true` o mancante, ogni set di icone è consentito. |
| `inline_buttons` | sequence of strings | Nomi di pulsanti CKEditor 5 | vuoto | **Text editor buttons (inline editing)**. L’aggiornamento 8036 ha migrato in questo elenco e in `modal_buttons` i nomi di CKEditor 4. |
| `modal_buttons` | sequence of strings | Nomi di pulsanti CKEditor 5 | vuoto | **Text editor buttons (modal editing)**. |

## Modelli utente

Oggetti di configurazione: `dxpr_builder.user_template.*`(tipo di entità `dxpr_builder_user_template`)

Percorso admin: `/admin/dxpr_studio/dxpr_builder/user_templates`

| Chiave | Tipo | Valori consentiti | Valore predefinito | Descrizione |
|---|---|---|---|---|
| `id` | string | Machine name | obbligatorio | Identificatore. |
| `label` | label | Qualsiasi testo | obbligatorio | **Label**: nome del modello. |
| `status` | boolean | `true`, `false` | `true` | Nessun campo di form. Solo i modelli attivi possono essere caricati nell’editor o copiati in un modello di pagina. |
| `type` | string | Il tipo di elemento `data-azb` da cui è stato salvato il modello, per esempio `section`, `row`, `az_block`, `az_view` o `custom` | `custom` | **Type**. L’aggiornamento 9021 lo ricostruisce dal markup; i valori `az_block_*` e `az_view_*` collassano in `az_block` e `az_view`. |
| `template` | string | HTML DXPR Builder | vuoto | **Template**: il markup. L’aggiornamento 8013 ha spostato i modelli utente da una tabella di database alla configurazione. |
| `uid` | integer | Id utente | obbligatorio nel form | **UID**: il proprietario. |
| `global` | boolean | `true`, `false` | `true` (la richiesta di salvataggio dell’editor invia il proprio valore) | **Global**: `true` rende il modello disponibile a tutti gli utenti (secondo i profili); `false` lo tiene privato al proprietario. |
| `image` | string | Contenuti immagine codificati in base64 | vuoto | **Image**: miniatura. |
| `uuid` | string | UUID | generato | Id universalmente unico. |

## Esportare la configurazione

Esporta tutta la configurazione DXPR Builder:

```bash
drush config:export

```

Questo esporta impostazioni, profili, modelli di pagina e modelli utente come file YAML nella directory di sync della configurazione. Quando `api_key_storage` è `key`, la chiave prodotto non fa parte di `dxpr_builder.settings`. Vive nell’entità Key selezionata e segue il provider di quella chiave, come configurazione, un file o una variabile d’ambiente.

## E adesso?

- [Impostazioni generali](/it/hc/documentation/learn-dxpr-builder/admin/general-settings): il form delle impostazioni
- [Firewall e residenza dei dati](/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall): le chiavi che controllano le connessioni in uscita
- [Endpoint API](/it/hc/documentation/learn-dxpr-builder/reference/api-endpoints): le route che leggono questa configurazione