구성 참조.

DXPR Builder 배우기참조설정과 API

DXPR Builder는 Drupal의 구성 시스템에 구성을 저장합니다. 이 페이지에서는 config/schema/dxpr_builder.schema.yml에 선언된 모든 키를 타입, 허용 값, 기본값과 함께 나열합니다. 또한 각 구성 엔티티의 status 키와 스키마 항목 없이 코드에서 읽는 설정 키도 나열합니다. 굵은 이름은 양식 라벨입니다.

모듈에는 config/install/dxpr_builder.settings.yml이 포함되어 있지 않습니다. 기본값은 hook_install()과 dxpr_builder.install의 업데이트 훅에서 설정되며, 키가 누락된 경우 코드에서 적용됩니다. 어느 경우인지는 Default 열에 표시됩니다.

일반 설정

구성 객체: dxpr_builder.settings

관리 경로: /admin/dxpr_studio/dxpr_builder/settings (src/Form/DxprBuilderSettingsForm.php)

키 타입 허용 값 기본값 설명
json_web_token string DXPR 제품 키(JWT) 비어 있음 Product key이며, api_key_storage가 config인 경우에만 해당합니다. 키가 Key 모듈에 저장되면 삭제됩니다. 업데이트 9026은 그곳에 남아 있는 값을 삭제합니다.
api_key_storage string config (Configuration storage), key (Key module) 설정되지 않음(config로 취급되며, dxpr_builder_update_9020()이 기존 키를 이동한 뒤에는 key). Storage method 제품 키의 저장 방식입니다.
key_provider string Key 엔티티 ID 비어 있음. 업데이트 9020은 기존 키를 이동할 때 다음을 설정합니다: dxpr_builder_jwt. Key 제품 키를 보유하는 Key 엔티티입니다(조건: api_key_storage가 key인 경우).
bootstrap string 0, bs5 설정되지 않음(Bootstrap 파일을 로드하지 않음) Sideload Bootstrap files: 0 = None (theme provides Bootstrap), bs5 = Bootstrap 5. 업데이트 8040은 제거된 1 및 bs4 값을 bs5로 다시 씁니다.
cke_stylesset string 줄당 하나의 [label]=[element].[class] 항목 비어 있음(그러면 에디터는 DXPR Builder에 포함된 스타일을 사용합니다) Custom styles 텍스트 에디터용 사용자 정의 스타일입니다(예: Sassy Title=h1.sassy-title).
editor_assets_source integer 0, 1, 2 설정되지 않음(0) Asset source: 0 = Cloud, 1 = Local (minified), 2 = Local (unminified). 이 필드는 모듈의 dxpr_builder/ 폴더에 로컬 빌드가 있을 때만 표시됩니다. 0이 저장된 경우에도 해당 빌드가 사용되며, 압축되지 않은 빌드가 우선합니다.
format_filters boolean true, false 설정되지 않음(꺼짐) 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)), 또는 Entity Browser ID media_library(Media Library 모듈이 설치된 경우), dxpr_builder_media_modal(dxpr_builder_media가 설치된 경우), 그 외에는 ''(hook_install()에서 설정) Browser type 이미지 필드에서 사용하는 브라우저 타입입니다.
offset_selector string CSS 선택자 .dxpr-theme-header--sticky, .dxpr-theme-header--fixed (비어 있으면 적용됨) Scroll offset selector 고정 헤더용 스크롤 오프셋 선택자입니다.
controls_layout string element (On each element), breadcrumb (One row) element (비어 있으면 적용됨) Control bars 편집 모드의 컨트롤 표시줄입니다. 각 요소의 컨트롤 표시줄, 또는 가리키는 요소 위의 한 행입니다. 프로필과 사용자 자체 설정이 이를 재정의합니다. 사용자 설정은 구성이 아니며 사용자 계정과 함께 저장됩니다(user.data, 모듈 dxpr_builder, 이름 controls_layout).

AI 설정

동일한 dxpr_builder.settings 객체에 저장됩니다.

관리 경로: /admin/dxpr_studio/dxpr_builder/ai_settings (src/Form/DxprBuilderAiSettingsForm.php)

키 타입 허용 값 기본값 설명
ai_enabled boolean true, false true 누락된 경우. 업데이트 9008에서 설정합니다 Enable text editing assistant.
ai_page_enabled boolean true, false true 누락된 경우. 업데이트 9012에서 설정합니다 Enable page creation assistant.
ai_image_enabled boolean true, false true 누락된 경우. 업데이트 9015에서 설정합니다 Enable image generation.
ai_user_model_selection boolean true, false true 누락된 경우. 업데이트 9016에서 설정합니다 Allow users to choose model. ai_provider_dxpr이 설치되지 않은 경우에만 표시됩니다.
ai_model string dxai_kavya_m1, dxai_kavya_m1_eu, dxai_kavya_m1_fast dxai_kavya_m1 (AiModelConstants::getDefaultModel()) Default model. API 이름은 다음과 같습니다: kavya-m1, kavya-m1-eu 및 kavya-m1-fast. ai_provider_dxpr이 설치되지 않은 경우에만 표시되고 저장됩니다.
ai_provider_selection_mode string automatic (Automatic), manual (Manual priority) automatic Service providers 모드입니다. manual은 ai_providers의 순서를 사용합니다. ai_provider_dxpr이 설치되지 않은 경우에만 저장됩니다.
ai_providers 제공업체 ID를 키로 하는 매핑 시퀀스 키: anthropic, gemini, mistral, openai, xai. 각 항목에는 다음이 있습니다: enabled(불리언), weight(정수), region(enabled 또는 disabled) 비어 있음(그러면 양식에 5개가 모두 활성화된 것으로 표시됩니다) 제공업체 우선순위 테이블입니다(모드: manual). region은 행이 속한 테이블 섹션이지 지리적 리전이 아닙니다.
tone_of_voice_vocabulary string 택소노미 보캐벌러리 ID ai_tone_of_voice(Taxonomy가 활성화된 경우 hook_install()에서 생성되며 업데이트 9007에서도 생성되는 보캐벌러리) Tone of voice vocabulary. 업데이트 9025는 저장된 보캐벌러리가 더 이상 존재하지 않으면 값을 다음으로 되돌립니다: ai_tone_of_voice.
enable_taxonomy_tones boolean true, false true 톤 보캐벌러리가 설정된 경우 보캐벌러리와 함께 true로 설정됩니다(설정 주체: hook_install(), 업데이트, 양식). 양식 필드가 없으며 읽는 코드도 없습니다.
commands_vocabulary string 택소노미 보캐벌러리 ID ai_agent_commands(Taxonomy가 활성화된 경우 hook_install()에서 생성되며, 키가 비어 있는 경우에만 업데이트 9007에서도 생성) Commands vocabulary.
enable_taxonomy_commands boolean true, false true 명령 보캐벌러리가 설정된 경우 보캐벌러리와 함께 true로 설정됩니다(설정 주체: hook_install(), 업데이트 9007, 양식). 양식 필드가 없으며 읽는 코드도 없습니다.
ai_output_allowed_domains text 줄당 하나의 도메인(*.wikipedia.org 같은 와일드카드 허용). *는 모두 허용합니다. 비어 있으면 모든 외부 URL을 차단합니다 unsplash.com, images.unsplash.com, pexels.com, images.pexels.com, pixabay.com, promptahuman.com (hook_install() 및 업데이트 9013에서 설정) Allowed domains. 양식에서 Filter AI output을 선택 해제하면 *이 저장됩니다.
ai_output_allowed_tags text 줄당 하나의 HTML 태그 이름 일반적인 텍스트, 목록, 테이블, 인라인, 미디어, 양식 태그 목록(div부터 rp까지). 키가 누락된 경우 양식에서 적용됩니다 Allowed HTML tags. 나열되지 않은 태그는 마크업을 잃지만 텍스트는 유지합니다.
ai_output_stripped_tags text 줄당 하나의 HTML 태그 이름 script, style Blocked tags이며 콘텐츠와 함께 제거됩니다. 양식에서 Filter AI output을 선택 해제하면 기본값인 script, style이 저장됩니다.

양식 필드 없이 코드에서 읽는 키

이러한 키는 스키마에 없지만 모듈이 dxpr_builder.settings에서 읽습니다. drush config:set이나 settings.php의 구성 재정의로 설정합니다.

키 타입 누락 시 기본값 설명
record_analytics boolean true true인 경우 에디터 사용 분석을 tuur.dxpr.com으로 전송합니다.
notifications boolean true true인 경우 에디터에 DXPR 알림을 표시합니다.
cloud_url string https://cdn2.dxpr.com/VERSION/ 에디터 애셋용 CDN 기본 URL입니다. 다음은 모듈 버전으로 대체됩니다: VERSION.
license_endpoint string https://dxpr.com/api/central-user-storage/ 라이선스 사용자 동기화용 엔드포인트입니다.

페이지 템플릿

구성 객체: dxpr_builder.page_template.* (엔티티 타입 dxpr_builder_page_template)

관리 경로: /admin/dxpr_studio/dxpr_builder/page_template

키 타입 허용 값 기본값 설명
id string 머신 이름 필수 식별자입니다.
label label 모든 텍스트 필수 Label: 템플릿 선택기에 표시되는 이름입니다.
status boolean true, false true Enabled. 에디터는 활성화된 템플릿만 제공하고 로드합니다.
category text 모든 텍스트 비어 있음(양식에서 필수) Category 템플릿이 그룹화되는 카테고리입니다.
template string DXPR Builder HTML 비어 있음(양식에서 필수) Template 마크업입니다.
weight integer 모든 정수 비어 있음(에디터는 0으로 읽음) Weight: 정렬 순서입니다.
date integer Unix 타임스탬프 저장할 때마다 편집 양식에서 설정됨 마지막 수정 시간입니다.
image string Base64로 인코딩된 이미지 콘텐츠 비어 있음 Image: 썸네일입니다.
uuid string UUID 자동 생성됨 범용 고유 ID입니다.

모듈의 config/install에는 다섯 가지 페이지 템플릿이 포함되어 있습니다: about_me, about_us, homepage_basic, split_content_and_buttons 및 text_columns.

사용자 프로필

구성 객체: dxpr_builder.dxpr_builder_profile.* (엔티티 타입 dxpr_builder_profile)

관리 경로: /admin/dxpr_studio/dxpr_builder/profile

새 프로필에서는 양식이 모든 요소, 블록, 뷰 디스플레이, 활성화된 페이지 템플릿, 활성화된 전역 사용자 템플릿, 아이콘 세트와 기본 텍스트 에디터 버튼 세트를 체크합니다. 아래 기본값은 엔티티 자체의 값입니다.

키 타입 허용 값 기본값 설명
id string 머신 이름 필수 식별자입니다.
label label 모든 텍스트 필수 Label: 프로필 이름입니다.
uuid string UUID 자동 생성됨 범용 고유 ID입니다.
status boolean true, false true User profile enabled. 비활성화된 프로필은 사용자의 역할을 일치시킬 때 건너뜁니다.
sidebar boolean true, false 저장되지 않음 레거시 키: 스키마에 선언되었지만 엔티티에서 내보내지 않으므로 저장되는 일이 없습니다.
dxpr_editor boolean true, false true; 업데이트 8008은 기존 프로필에 이를 설정했습니다 Start editor when page loads. false인 경우 컨트롤은 사용자가 기본 컨테이너 컨트롤의 눈 아이콘을 클릭한 후에만 표시됩니다.
controls_layout string default (Same as the site), element (On each element), breadcrumb (One row) default Control bars 이 프로필의 편집 모드 컨트롤 표시줄입니다. 사용자 자체 설정이 이를 재정의합니다.
weight integer -10부터 10까지(양식에서) 0 Weight: 사용자의 역할이 여러 활성화된 프로필과 일치하면 가장 낮은 가중치가 우선합니다.
roles 문자열 시퀀스 역할 머신 이름(양식에서 다음 제외: anonymous, authenticated) 비어 있음 Roles 프로필이 적용되는 역할입니다.
elements 문자열 시퀀스 요소 머신 이름(az_text, az_image, ...) 비어 있음 허용된 Elements.
all_elements boolean true, false false Check/Uncheck all Elements. true인 경우 모든 요소가 허용되며 다음은 무시됩니다: elements.
blocks 문자열 시퀀스 az_block-<block plugin id> 값 비어 있음 허용된 Blocks.
all_blocks boolean true, false false Check/Uncheck all Blocks. true인 경우 모든 블록이 허용되며 나중에 추가된 블록도 포함됩니다.
views 문자열 시퀀스 az_view-<view id>-<display id> 값 비어 있음 허용된 Views 디스플레이입니다.
all_views boolean true, false false Check/Uncheck all Views. true인 경우 모든 뷰 디스플레이가 허용되며 나중에 추가된 디스플레이도 포함됩니다.
page_templates 문자열 시퀀스 페이지 템플릿 UUID 비어 있음 허용된 Page templates.
all_page_templates boolean true, false false Check/Uncheck all Page templates. true인 경우 모든 페이지 템플릿이 허용됩니다.
user_templates 문자열 시퀀스 전역 사용자 템플릿 UUID 비어 있음 허용된 Global user templates.
all_user_templates boolean true, false false Check/Uncheck all Global user templates. true인 경우 모든 전역 사용자 템플릿이 허용됩니다.
icon_sets 문자열 시퀀스 다음 파일의 아이콘 세트 ID: *.dxpr_icon_sets.yml. 비어 있음 허용된 Icon sets.
all_icon_sets boolean true, false 설정되지 않음(다음으로 간주: true) Check/Uncheck all Icon sets. true인 경우 또는 누락된 경우 모든 아이콘 세트가 허용됩니다.
inline_buttons 문자열 시퀀스 CKEditor 5 버튼 이름 비어 있음 Text editor buttons (inline editing). 업데이트 8036은 이 목록과 modal_buttons의 CKEditor 4 이름을 마이그레이션했습니다.
modal_buttons 문자열 시퀀스 CKEditor 5 버튼 이름 비어 있음 Text editor buttons (modal editing).

사용자 템플릿

구성 객체: dxpr_builder.user_template.* (엔티티 타입 dxpr_builder_user_template)

관리 경로: /admin/dxpr_studio/dxpr_builder/user_templates

키 타입 허용 값 기본값 설명
id string 머신 이름 필수 식별자입니다.
label label 모든 텍스트 필수 Label: 템플릿 이름입니다.
status boolean true, false true 양식 필드가 없습니다. 활성화된 템플릿만 에디터에서 로드하거나 페이지 템플릿에 복사할 수 있습니다.
type string 템플릿을 저장한 data-azb 요소 유형입니다. 예: section, row, az_block, az_view 또는 custom custom Type. 업데이트 9021은 마크업에서 이를 소급 입력합니다. az_block_* 및 az_view_* 값은 az_block 및 az_view로 축소됩니다.
template string DXPR Builder HTML 비어 있음 Template 마크업입니다. 업데이트 8013은 사용자 템플릿을 데이터베이스 테이블에서 구성으로 이동했습니다.
uid integer 사용자 ID 양식에서 필수 UID: 소유자입니다.
global boolean true, false true (에디터의 저장 요청이 자체 값을 전송합니다) Global: true는 템플릿을 모든 사용자가 사용할 수 있게 합니다(프로필 적용 대상). false는 소유자에게 비공개로 유지합니다.
image string Base64로 인코딩된 이미지 콘텐츠 비어 있음 Image: 썸네일입니다.
uuid string UUID 자동 생성됨 범용 고유 ID입니다.

구성 내보내기

모든 DXPR Builder 구성을 내보냅니다.

drush config:export

이 명령은 설정, 프로필, 페이지 템플릿, 사용자 템플릿을 구성 동기화 디렉터리의 YAML 파일로 내보냅니다. api_key_storage가 key인 경우 제품 키는 다음의 일부가 아닙니다: dxpr_builder.settings. 선택된 Key 엔티티에 있으며 해당 키 자체의 제공업체(예: 구성, 파일, 환경 변수)를 따릅니다.

다음 단계