Opis konfiguracji..

Poznaj DXPR BuilderDokumentacja technicznaKonfiguracja i API

DXPR Builder przechowuje konfigurację w systemie konfiguracji Drupala. Ta strona wymienia każdy klucz zadeklarowany w config/schema/dxpr_builder.schema.yml z jego typem, dozwolonymi wartościami i wartością domyślną. Wymienia też klucz status każdego bytu konfiguracji i klucze ustawień, które kod czyta bez wpisu w schemacie. Pogrubione nazwy to etykiety formularza.

Moduł nie dostarcza pliku config/install/dxpr_builder.settings.yml. Domyślne wartości ustawia hook_install() i hooki aktualizacji w dxpr_builder.install albo stosowane są w kodzie, gdy klucza brakuje; kolumna Domyślnie mówi, które.

Ustawienia ogólne

Obiekt konfiguracji: dxpr_builder.settings

Ścieżka administracyjna: /admin/dxpr_studio/dxpr_builder/settings (src/Form/DxprBuilderSettingsForm.php)

Klucz Typ Dozwolone wartości Domyślnie Opis
json_web_token string Klucz produktu DXPR (JWT) puste Product key, tylko gdy api_key_storage to config. Czyszczone, gdy klucz przechowywany jest w module Key; aktualizacja 9026 czyści pozostawioną tam wartość.
api_key_storage string config (Configuration storage), key (Key module) nieustawione (traktowane jako config); key po przeniesieniu istniejącego klucza przez dxpr_builder_update_9020(). Storage method dla klucza produktu.
key_provider string ID bytu Key puste; aktualizacja 9020 ustawia dxpr_builder_jwt przy przenoszeniu istniejącego klucza Key trzymający klucz produktu, gdy api_key_storage to key.
bootstrap string 0, bs5 nieustawione (nie wczytano plików Bootstrap) Sideload Bootstrap files: 0 = None (theme provides Bootstrap), bs5 = Bootstrap 5. Aktualizacja 8040 przepisuje usunięte wartości 1 i bs4 na bs5.
cke_stylesset string Jeden wpis [label]=[element].[class] na linię puste (edytor używa wtedy stylów dostarczonych z DXPR Builder) Custom styles dla edytora tekstu, na przykład Sassy Title=h1.sassy-title.
editor_assets_source integer 0, 1, 2 nieustawione (0) Asset source: 0 = Cloud, 1 = Local (minified), 2 = Local (unminified). Pole pokazuje się tylko, gdy lokalna kompilacja istnieje w folderze dxpr_builder/ modułu. Przy zapisanym 0 taka kompilacja i tak jest używana, najpierw nieminifikowana.
format_filters boolean true, false nieustawione (wyłączone) 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)) albo ID przeglądarki Entity Browser media_library, gdy moduł Media Library jest zainstalowany, inaczej dxpr_builder_media_modal, gdy zainstalowany jest dxpr_builder_media, inaczej '' (ustawia hook_install()) Browser type używany przez pola obrazów.
offset_selector string Selektor CSS .dxpr-theme-header--sticky, .dxpr-theme-header--fixed (stosowane, gdy puste) Scroll offset selector dla przyklejonych nagłówków.
controls_layout string element (On each element), breadcrumb (One row) element (stosowane, gdy puste) Control bars w trybie edycji: pasek na każdym elemencie albo jeden wiersz nad elementem, na który wskazujesz. Profil i własne ustawienie użytkownika je przesłaniają. Ustawienie użytkownika nie jest konfiguracją: przechowywane jest przy koncie użytkownika (user.data, moduł dxpr_builder, nazwa controls_layout).

Ustawienia AI

Przechowywane w tym samym obiekcie dxpr_builder.settings.

Ścieżka administracyjna: /admin/dxpr_studio/dxpr_builder/ai_settings (src/Form/DxprBuilderAiSettingsForm.php)

Klucz Typ Dozwolone wartości Domyślnie Opis
ai_enabled boolean true, false true, gdy brak; ustawia aktualizacja 9008 Enable text editing assistant.
ai_page_enabled boolean true, false true, gdy brak; ustawia aktualizacja 9012 Enable page creation assistant.
ai_image_enabled boolean true, false true, gdy brak; ustawia aktualizacja 9015 Enable image generation.
ai_user_model_selection boolean true, false true, gdy brak; ustawia aktualizacja 9016 Allow users to choose model. Pokazywane tylko, gdy ai_provider_dxpr nie jest zainstalowany.
ai_model string dxai_kavya_m1, dxai_kavya_m1_eu, dxai_kavya_m1_fast dxai_kavya_m1 (AiModelConstants::getDefaultModel()) Default model. Nazwy API to kavya-m1, kavya-m1-eu i kavya-m1-fast. Pokazywane i zapisywane tylko, gdy ai_provider_dxpr nie jest zainstalowany.
ai_provider_selection_mode string automatic (Automatic), manual (Manual priority) automatic Service providers (tryb). manual używa kolejności z ai_providers. Zapisywane tylko, gdy ai_provider_dxpr nie jest zainstalowany.
ai_providers sekwencja mapowań kluczowanych ID dostawcy Klucze: anthropic, gemini, mistral, openai, xai. Każdy ma enabled (boolean), weight (integer) i region (enabled albo disabled) puste (formularz wymienia wtedy wszystkie pięć jako włączone) Tabela priorytetów dostawców dla trybu manual. region to sekcja tabeli, w której stoi wiersz, nie region geograficzny.
tone_of_voice_vocabulary string ID słownika taksonomii ai_tone_of_voice (słownik utworzony przez hook_install(), gdy włączona jest Taxonomy, oraz przez aktualizację 9007) Tone of voice vocabulary. Aktualizacja 9025 kieruje wartość z powrotem na ai_tone_of_voice, gdy przechowywany słownik już nie istnieje.
enable_taxonomy_tones boolean true, false true, gdy ustawiony jest słownik tonów Ustawiane na true wraz ze słownikiem przez hook_install(), aktualizacje albo formularz. Bez pola formularza, żaden kod go nie czyta.
commands_vocabulary string ID słownika taksonomii ai_agent_commands (utworzony przez hook_install(), gdy włączona jest Taxonomy, oraz przez aktualizację 9007, tylko gdy klucz jest pusty) Commands vocabulary.
enable_taxonomy_commands boolean true, false true, gdy ustawiony jest słownik poleceń Ustawiane na true wraz ze słownikiem przez hook_install(), aktualizację 9007 albo formularz. Bez pola formularza, żaden kod go nie czyta.
ai_output_allowed_domains text Domeny po jednej na linię (dozwolone wieloznaczniki, na przykład *.wikipedia.org); * pozwala na wszystkie; puste blokuje wszystkie zewnętrzne URLe unsplash.com, images.unsplash.com, pexels.com, images.pexels.com, pixabay.com, promptahuman.com (ustawia hook_install() i aktualizacja 9013) Allowed domains. Odznaczenie Filter AI output w formularzu zapisuje *.
ai_output_allowed_tags text Nazwy tagów HTML po jednej na linię Lista popularnych tagów tekstu, list, tabel, liniowych, multimediów i formularzy (od div do rp), stosowana w formularzu, gdy klucza brakuje Allowed HTML tags; niewymienione tagi tracą markup, ale zachowują tekst.
ai_output_stripped_tags text Nazwy tagów HTML po jednej na linię script, style Blocked tags, usuwane wraz z zawartością. Odznaczenie Filter AI output zapisuje domyślne script i style.

Klucze czytane przez kod bez pola formularza

Tych kluczy nie ma w schemacie, ale moduł czyta je z dxpr_builder.settings. Ustaw je za pomocą drush config:set albo nadpisania konfiguracji w settings.php.

Klucz Typ Domyślnie, gdy brak Opis
record_analytics boolean true Wysyła analitykę użycia edytora do tuur.dxpr.com, gdy true.
notifications boolean true Pokazuje powiadomienia DXPR w edytorze, gdy true.
cloud_url string https://cdn2.dxpr.com/VERSION/ Bazowy URL CDN dla zasobów edytora; VERSION zastępowane jest wersją modułu.
license_endpoint string https://dxpr.com/api/central-user-storage/ Punkt końcowy synchronizacji licencjonowanych użytkowników.

Szablony stron

Obiekty konfiguracji: dxpr_builder.page_template.* (rodzaj bytu dxpr_builder_page_template)

Ścieżka administracyjna: /admin/dxpr_studio/dxpr_builder/page_template

Klucz Typ Dozwolone wartości Domyślnie Opis
id string Nazwa maszynowa wymagane Identyfikator.
label label Dowolny tekst wymagane Label: nazwa pokazywana w selektorze szablonów.
status boolean true, false true Enabled. Edytor oferuje i wczytuje tylko włączone szablony.
category text Dowolny tekst puste (formularz go wymaga) Category, pod którą grupowany jest szablon.
template string HTML z DXPR Builder puste (formularz go wymaga) Template: markup.
weight integer Dowolna liczba całkowita puste (edytor czyta je jako 0) Weight: kolejność sortowania.
date integer Uniksowy znacznik czasu ustawia formularz edycji przy każdym zapisie Czas ostatniej modyfikacji.
image string Zawartość obrazu zakodowana w base64 puste Image: miniatura.
uuid string UUID generowane Uniwersalny unikalny identyfikator.

Moduł dostarcza pięć szablonów stron w config/install: about_me, about_us, homepage_basic, split_content_and_buttons i text_columns.

Profile użytkowników

Obiekty konfiguracji: dxpr_builder.dxpr_builder_profile.* (rodzaj bytu dxpr_builder_profile)

Ścieżka administracyjna: /admin/dxpr_studio/dxpr_builder/profile

W nowym profilu formularz zaznacza każdy element, blok, wyświetlanie widoku, włączony szablon strony, włączony globalny szablon użytkownika i zestaw ikon, plus domyślny zestaw przycisków edytora tekstu. Domyślne poniżej to własne wartości bytu.

Klucz Typ Dozwolone wartości Domyślnie Opis
id string Nazwa maszynowa wymagane Identyfikator.
label label Dowolny tekst wymagane Label: nazwa profilu.
uuid string UUID generowane Uniwersalny unikalny identyfikator.
status boolean true, false true User profile enabled. Wyłączone profile są pomijane przy dopasowywaniu ról użytkownika.
sidebar boolean true, false nieprzechowywane Klucz starszy (legacy): zadeklarowany w schemacie, ale nieeksportowany przez byt, więc nigdy nie jest zapisywany.
dxpr_editor boolean true, false true; aktualizacja 8008 ustawiła je w istniejących profilach Start editor when page loads. Gdy false, kontrolki pokazują się dopiero po kliknięciu ikony oka na kontrolkach głównego kontenera przez użytkownika.
controls_layout string default (Same as the site), element (On each element), breadcrumb (One row) default Control bars w trybie edycji dla tego profilu. Własne ustawienie użytkownika je przesłania.
weight integer -10 do 10 w formularzu. 0 Weight: gdy role użytkownika pasują do kilku włączonych profili, wygrywa najniższa waga.
roles sekwencja ciągów Nazwy maszynowe ról (formularz pomija anonymous i authenticated) puste Roles, do których obowiązuje profil.
elements sekwencja ciągów Nazwy maszynowe elementów (az_text, az_image, …) puste Dozwolone Elements.
all_elements boolean true, false false Check/Uncheck all Elements. Gdy true, każdy element jest dozwolony, a elements jest ignorowane.
blocks sekwencja ciągów az_block-<block plugin id>: wartości. puste Dozwolone Blocks.
all_blocks boolean true, false false Check/Uncheck all Blocks. Gdy true, każdy blok jest dozwolony, łącznie z dodanymi później.
views sekwencja ciągów az_view-<view id>-<display id>: wartości. puste Dozwolone wyświetlania Views.
all_views boolean true, false false Check/Uncheck all Views. Gdy true, każde wyświetlanie widoków jest dozwolone, łącznie z dodanymi później.
page_templates sekwencja ciągów UUID szablonów stron puste Dozwolone Page templates.
all_page_templates boolean true, false false Check/Uncheck all Page templates. Gdy true, każdy szablon strony jest dozwolony.
user_templates sekwencja ciągów UUID globalnych szablonów użytkowników puste Dozwolone Global user templates.
all_user_templates boolean true, false false Check/Uncheck all Global user templates. Gdy true, każdy globalny szablon użytkownika jest dozwolony.
icon_sets sekwencja ciągów ID zestawów ikon z plików *.dxpr_icon_sets.yml. puste Dozwolone Icon sets.
all_icon_sets boolean true, false nieustawione (liczy się jako true) Check/Uncheck all Icon sets. Gdy true albo brak, każdy zestaw ikon jest dozwolony.
inline_buttons sekwencja ciągów Nazwy przycisków CKEditor 5 puste Text editor buttons (inline editing). Aktualizacja 8036 migrowała nazwy CKEditor 4 na tej liście i w modal_buttons.
modal_buttons sekwencja ciągów Nazwy przycisków CKEditor 5 puste Text editor buttons (modal editing).

Szablony użytkowników

Obiekty konfiguracji: dxpr_builder.user_template.* (rodzaj bytu dxpr_builder_user_template)

Ścieżka administracyjna: /admin/dxpr_studio/dxpr_builder/user_templates

Klucz Typ Dozwolone wartości Domyślnie Opis
id string Nazwa maszynowa wymagane w formularzu Identyfikator.
label label Dowolny tekst wymagane Label: nazwa szablonu.
status boolean true, false true Bez pola formularza. Tylko włączone szablony można wczytać w edytorze albo skopiować do szablonu strony.
type string Rodzaj elementu data-azb, z którego zapisano szablon, na przykład section, row, az_block, az_view albo custom custom Type. Aktualizacja 9021 uzupełnia go z markupu; wartości az_block_* i az_view_* zwijają się do az_block i az_view.
template string HTML z DXPR Builder puste Template: markup. Aktualizacja 8013 przeniosła szablony użytkowników z tabeli bazy danych do konfiguracji.
uid integer ID użytkownika wymagane w formularzu UID: właściciel.
global boolean true, false true (żądanie zapisu edytora wysyła własną wartość) Global: true udostępnia szablon wszystkim użytkownikom (zależnie od profili); false zachowuje go prywatnie dla właściciela.
image string Zawartość obrazu zakodowana w base64 puste Image: miniatura.
uuid string UUID generowane Uniwersalny unikalny identyfikator.

Eksportowanie konfiguracji

Wyeksportuj całą konfigurację DXPR Builder:

drush config:export

Eksportuje to ustawienia, profile, szablony stron i szablony użytkowników jako pliki YAML w katalogu synchronizacji konfiguracji. Gdy api_key_storage to key, klucz produktu nie jest częścią dxpr_builder.settings. Mieszka w wybranym bycie Key i podąża za własnym dostawcą tego klucza, takim jak konfiguracja, plik albo zmienna środowiskowa.

Co dalej?