Riferimento alla configurazione.

Learn DXPR BuilderReferenceConfiguratie en API

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:

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?