Configuratiereferentie.

Learn DXPR BuilderReferenceConfiguratie en API

DXPR Builder bewaart zijn configuratie in het configuratiesysteem van Drupal. Deze pagina toont elke sleutel gedeclareerd in config/schema/dxpr_builder.schema.yml met zijn type, toegestane waarden en standaard. Hij toont ook de status-sleutel van elke configuratie-entiteit en de instellingssleutels die code leest zonder schema-item. Vette namen zijn de formulierlabels.

De module levert geen config/install/dxpr_builder.settings.yml. Standaarden worden ingesteld door hook_install() en update-hooks in dxpr_builder.install, of toegepast in code wanneer een sleutel ontbreekt; de kolom Standaard vermeldt welke.

Algemene instellingen

Configuratieobject: dxpr_builder.settings

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

Sleutel Type Toegestane waarden Standaard Beschrijving
json_web_token string Een DXPR-productsleutel (JWT) leeg Productsleutel, alleen wanneer api_key_storage config is. Gewist wanneer de sleutel in de Key-module wordt bewaard; update 9026 wist een daar achtergebleven waarde.
api_key_storage string config (Configuratieopslag), key (Key-module) niet ingesteld (behandeld als config); key nadat dxpr_builder_update_9020() een bestaande sleutel verhuist Opslagmethode voor de productsleutel.
key_provider string Een Key-entiteits-id leeg; update 9020 stelt dxpr_builder_jwt in wanneer hij een bestaande sleutel verhuist Key entiteit met de productsleutel wanneer api_key_storage key is.
bootstrap string 0, bs5 niet ingesteld (geen Bootstrap-bestanden geladen) Bootstrap-bestanden sideloaden: 0 = Geen (thema levert Bootstrap), bs5 = Bootstrap 5. Update 8040 herschrijft de verwijderde waarden 1 en bs4 naar bs5.
cke_stylesset string Eén [label]=[element].[class]-ingang per regel leeg (de editor gebruikt dan de stijlen meegeleverd met DXPR Builder) Aangepaste stijlen voor de teksteditor, bijvoorbeeld Sassy Title=h1.sassy-title.
editor_assets_source integer 0, 1, 2 niet ingesteld (0) Bestandsbron: 0 = Cloud, 1 = Lokaal (geminified), 2 = Lokaal (niet-geminified). Het veld verschijnt alleen wanneer een lokale build bestaat in de map dxpr_builder/ van de module. Met 0 opgeslagen wordt zo’n build toch gebruikt, eerst de niet-geminifiede.
format_filters boolean true, false niet ingesteld (uit) Tekstnotatiefilters toepassen op frontendinhoud.
media_browser string '' (Eenvoudige bestandsupload), media_library (Mediabibliotheek), media_library_acquia_dam (Media Library (Acquia DAM)), of een Entity Browser-id media_library wanneer de module Mediabibliotheek is geïnstalleerd, anders dxpr_builder_media_modal wanneer dxpr_builder_media is geïnstalleerd, anders '' (ingesteld door hook_install()) Browsertype gebruikt door afbeeldingsvelden.
offset_selector string Een CSS-selector .dxpr-theme-header--sticky, .dxpr-theme-header--fixed (toegepast wanneer leeg) Scroll-offsetselector voor vaste headers.
controls_layout string element (Op elk element), breadcrumb (Eén rij) element (toegepast wanneer leeg) Besturingsbalken in bewerkingsmodus: een balk op elk element, of één rij boven het element waar je naar wijst. Een profiel en de eigen instelling van een gebruiker overrulen hem. De instelling van de gebruiker is geen configuratie: hij wordt bewaard bij het gebruikersaccount (user.data, module dxpr_builder, naam controls_layout).

AI-instellingen

Opgeslagen in hetzelfde dxpr_builder.settings-object.

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

Sleutel Type Toegestane waarden Standaard Beschrijving
ai_enabled boolean true, false true wanneer ontbreekt; ingesteld door update 9008 Assistent voor tekstbewerking inschakelen.
ai_page_enabled boolean true, false true wanneer ontbreekt; ingesteld door update 9012 Assistent voor pagina’s aanmaken inschakelen.
ai_image_enabled boolean true, false true wanneer ontbreekt; ingesteld door update 9015 Afbeeldingsgeneratie inschakelen.
ai_user_model_selection boolean true, false true wanneer ontbreekt; ingesteld door update 9016 Gebruikers model laten kiezen. Alleen getoond wanneer ai_provider_dxpr niet is geïnstalleerd.
ai_model string dxai_kavya_m1, dxai_kavya_m1_eu, dxai_kavya_m1_fast dxai_kavya_m1 (AiModelConstants::getDefaultModel()) Standaardmodel. De API-namen zijn kavya-m1, kavya-m1-eu en kavya-m1-fast. Alleen getoond en bewaard wanneer ai_provider_dxpr niet is geïnstalleerd.
ai_provider_selection_mode string automatic (Automatisch), manual (Handmatige prioriteit) automatic Dienstverleners-modus. manual gebruikt de volgorde in ai_providers. Alleen bewaard wanneer ai_provider_dxpr niet is geïnstalleerd.
ai_providers reeks mappings gesleuteld op provider-id Sleutels: anthropic, gemini, mistral, openai, xai. Elk heeft enabled (boolean), weight (integer) en region (enabled of disabled) leeg (het formulier toont dan alle vijf als ingeschakeld) Providerprioriteitstabel voor de manual-modus. region is de tabelsectie waarin de rij staat, geen geografische regio.
tone_of_voice_vocabulary string Een taxonomie-vocabulaire-id ai_tone_of_voice (vocabulaire aangemaakt door hook_install() wanneer Taxonomie is ingeschakeld, en door update 9007) Tone-of-voice-vocabulaire. Update 9025 wijst de waarde terug naar ai_tone_of_voice wanneer het bewaarde vocabulaire niet meer bestaat.
enable_taxonomy_tones boolean true, false true zodra een toonvocabulaire is ingesteld Op true gezet met het vocabulaire, door hook_install(), de updates of het formulier. Geen formulierveld, en geen code leest hem.
commands_vocabulary string Een taxonomie-vocabulaire-id ai_agent_commands (aangemaakt door hook_install() wanneer Taxonomie is ingeschakeld, en door update 9007, alleen wanneer de sleutel leeg is) Commandovocabulaire.
enable_taxonomy_commands boolean true, false true zodra een commandovocabulaire is ingesteld Op true gezet met het vocabulaire, door hook_install(), update 9007 of het formulier. Geen formulierveld, en geen code leest hem.
ai_output_allowed_domains text Domeinen één per regel (wildcards zoals *.wikipedia.org toegestaan); * staat alles toe; leeg blokkeert alle externe URL’s unsplash.com, images.unsplash.com, pexels.com, images.pexels.com, pixabay.com, promptahuman.com (ingesteld door hook_install() en update 9013) Toegestane domeinen. Filter AI-uitvoer uitvinken op het formulier bewaart *.
ai_output_allowed_tags text HTML-tagnamen één per regel Een lijst veelvoorkomende tekst-, lijst-, tabel-, inline-, media- en formuliertags (div tot rp) toegepast in het formulier wanneer de sleutel ontbreekt Toegestane HTML-tags; niet-vermelde tags verliezen hun markup maar behouden hun tekst.
ai_output_stripped_tags text HTML-tagnamen één per regel script, style Geblokkeerde tags, verwijderd met hun inhoud. Filter AI-uitvoer uitvinken bewaart de standaard script en style.

Sleutels gelezen door code zonder formulierveld

Deze sleutels staan niet in het schema maar de module leest ze uit dxpr_builder.settings. Stel ze in met drush config:set of een configuratie-override in settings.php.

Sleutel Type Standaard bij ontbreken Beschrijving
record_analytics boolean true Stuurt editorgebruiksanalyse naar tuur.dxpr.com wanneer true.
notifications boolean true Toont DXPR-meldingen in de editor wanneer true.
cloud_url string https://cdn2.dxpr.com/VERSION/ CDN-basis-URL voor editorbestanden; VERSION wordt vervangen door de moduleversie.
license_endpoint string https://dxpr.com/api/central-user-storage/ Eindpunt voor synchronisatie van gelicentieerde gebruikers.

Paginasjablonen

Configuratieobjecten: dxpr_builder.page_template.* (entiteittype dxpr_builder_page_template)

Adminpad: /admin/dxpr_studio/dxpr_builder/page_template

Sleutel Type Toegestane waarden Standaard Beschrijving
id string Machinenaam vereist Identificatie.
label label Willekeurige tekst vereist Label: naam getoond in de sjabloonkiezer.
status boolean true, false true Ingeschakeld. De editor biedt en laadt alleen ingeschakelde sjablonen.
category text Willekeurige tekst leeg (het formulier vereist hem) Categorie waaronder het sjabloon is gegroepeerd.
template string DXPR Builder HTML leeg (het formulier vereist hem) Sjabloonmarkup.
weight integer Willekeurig geheel getal leeg (de editor leest hem als 0) Gewicht: sort order.
date integer Unix-tijdstempel ingesteld door het bewerkingsformulier bij elke keer bewaren Tijdstip laatste wijziging.
image string Base64-gecodeerde afbeeldingsinhoud leeg Afbeelding: miniatuur.
uuid string UUID gegenereerd Universeel unieke id.

De module levert vijf paginasjablonen in config/install: about_me, about_us, homepage_basic, split_content_and_buttons and text_columns.

Gebruikersprofielen

Configuratieobjecten: dxpr_builder.dxpr_builder_profile.* (entiteittype dxpr_builder_profile)

Adminpad: /admin/dxpr_studio/dxpr_builder/profile

Op een nieuw profiel vinkt het formulier elk element, blok, view-weergave, ingeschakeld paginasjabloon, ingeschakeld globaal gebruikerssjabloon en pictogrammenset aan, plus een standaardset teksteditorknoppen. De standaarden hieronder zijn de eigen waarden van de entiteit.

Sleutel Type Toegestane waarden Standaard Beschrijving
id string Machinenaam vereist Identificatie.
label label Willekeurige tekst vereist Label: profielnaam.
uuid string UUID gegenereerd Universeel unieke id.
status boolean true, false true Gebruikersprofiel ingeschakeld. Uitgeschakelde profielen worden overgeslagen wanneer de rollen van een gebruiker worden gematcht.
sidebar boolean true, false niet bewaard Legacysleutel: gedeclareerd in het schema maar niet geëxporteerd door de entiteit, dus hij wordt nooit bewaard.
dxpr_editor boolean true, false true; update 8008 stelde hem in op bestaande profielen Editor starten wanneer pagina laadt. Wanneer false, verschijnen de besturingselementen pas nadat de gebruiker op het oogpictogram op de hoofdbesturing van de container klikt.
controls_layout string default (Zelfde als de site), element (Op elk element), breadcrumb (Eén rij) default Besturingsbalken in bewerkingsmodus voor dit profiel. De eigen instelling van een gebruiker overrult hem.
weight integer -10 tot 10 in het formulier 0 Gewicht: wanneer de rollen van een gebruiker met meerdere ingeschakelde profielen matchen, wint het laagste gewicht.
roles reeks strings Rolmachinenamen (het formulier laat anonymous en authenticated weg) leeg Rollen waarop het profiel van toepassing is.
elements reeks strings Elementmachinenamen (az_text, az_image, ...) leeg Toegestane Elementen.
all_elements boolean true, false false Alle Elementen aan-/uitvinken. Wanneer true, is elk element toegestaan en wordt elements genegeerd.
blocks reeks strings az_block-<block plugin id>-waarden leeg Toegestane Blokken.
all_blocks boolean true, false false Alle Blokken aan-/uitvinken. Wanneer true, is elk blok toegestaan, inclusief later toegevoegde.
views reeks strings az_view-<view id>-<display id>-waarden leeg Toegestane Views-weergaven.
all_views boolean true, false false Alle Views aan-/uitvinken. Wanneer true, is elke viewsweergave toegestaan, inclusief later toegevoegde.
page_templates reeks strings Paginasjabloon-UUID’s leeg Toegestane Paginasjablonen.
all_page_templates boolean true, false false Alle Paginasjablonen aan-/uitvinken. Wanneer true, is elk paginasjabloon toegestaan.
user_templates reeks strings Globale gebruikerssjabloon-UUID’s leeg Toegestane Globale gebruikerssjablonen.
all_user_templates boolean true, false false Alle Globale gebruikerssjablonen aan-/uitvinken. Wanneer true, is elk globaal gebruikerssjabloon toegestaan.
icon_sets reeks strings Pictogrammenset-id’s uit *.dxpr_icon_sets.yml-bestanden leeg Toegestane Pictogrammensets.
all_icon_sets boolean true, false niet ingesteld (telt als true) Alle Pictogrammensets aan-/uitvinken. Wanneer true of ontbrekend, is elke pictogrammenset toegestaan.
inline_buttons reeks strings CKEditor 5-knopnamen leeg Teksteditorknoppen (inline bewerken). Update 8036 migreerde CKEditor 4-namen in deze lijst en in modal_buttons.
modal_buttons reeks strings CKEditor 5-knopnamen leeg Teksteditorknoppen (modaal bewerken).

Gebruikerssjablonen

Configuratieobjecten: dxpr_builder.user_template.* (entiteittype dxpr_builder_user_template)

Adminpad: /admin/dxpr_studio/dxpr_builder/user_templates

Sleutel Type Toegestane waarden Standaard Beschrijving
id string Machinenaam vereist Identificatie.
label label Willekeurige tekst vereist Label: template name.
status boolean true, false true Geen formulierveld. Alleen ingeschakelde sjablonen kunnen in de editor worden geladen of naar een paginasjabloon worden gekopieerd.
type string Het data-azb-elementtype waarvan het sjabloon is bewaard, bijvoorbeeld section, row, az_block, az_view of custom custom Type. Update 9021 vult hem terug uit de markup; az_block_*- en az_view_*-waarden vallen samen tot az_block en az_view.
template string DXPR Builder HTML leeg Sjabloonmarkup. Update 8013 verhuisde gebruikerssjablonen van een databasetabel naar configuratie.
uid integer Gebruikers-id vereist in het formulier UID: de eigenaar.
global boolean true, false true (het bewaarverzoek van de editor stuurt zijn eigen waarde) Globaal: true maakt het sjabloon beschikbaar voor alle gebruikers (onderhevig aan profielen); false houdt het privé voor de eigenaar.
image string Base64-gecodeerde afbeeldingsinhoud leeg Afbeelding: miniatuur.
uuid string UUID gegenereerd Universeel unieke id.

Configuratie exporteren

Exporteer alle DXPR Builder-configuratie:

drush config:export

Dit exporteert instellingen, profielen, paginasjablonen en gebruikerssjablonen als YAML-bestanden in de config-syncmap. Wanneer api_key_storage key is, maakt de productsleutel geen deel uit van dxpr_builder.settings. Hij leeft in de geselecteerde Key-entiteit en volgt de eigen provider van die sleutel, zoals configuratie, een bestand of een omgevingsvariabele.

Wat nu?