---
url: 'https://dxpr.com/pl/hc/dokumentacja/nauka-dxpr-builder/referencja/opis-konfiguracji'
title: 'Opis konfiguracji. | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T02:48:27+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  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.
tags:
  - 'Configuration and API'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T17:19:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Opis konfiguracji.'
      description: |-
        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.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T02:48:27+0000'
      dateModified: '2026-10-24T17:19:22+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/pl/hc/dokumentacja/nauka-dxpr-builder/referencja/opis-konfiguracji'
      articleSection: 'Konfiguracja i API'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/pl/hc/dokumentacja/nauka-dxpr-builder/referencja/opis-konfiguracji'
      description: |-
        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.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 'Strona Główna'
            item: 'https://dxpr.com/pl'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: pl
---
[Centrum pomocy](/pl/hc)/[Dokumentacja](/pl/hc/dokumentacja) /[Poznaj DXPR Builder](/pl/hc/documentation/learn-dxpr-builder) /[Dokumentacja techniczna](/pl/hc/documentation/learn-dxpr-builder/reference) /[Konfiguracja i API](/pl/hc/documentation/learn-dxpr-builder/reference/config-and-api) # Opis konfiguracji..

 Poznaj DXPR BuilderDokumentacja technicznaKonfiguracja i API

   ## W tym przewodniku

 Powiązane przewodniki

- [Wpisz klucz produktu i ustawienia całej witryny](/pl/hc/dokumentacja/nauka-dxpr-builder/administracja/ustawienia-ogolne)
- [Zapora sieciowa i przechowywanie danych](/pl/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)
- [Punkty końcowe API.](/pl/hc/dokumentacja/nauka-dxpr-builder/referencja/punkty-koncowe-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:

```bash
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?

- [Ustawienia ogólne](/pl/hc/dokumentacja/nauka-dxpr-builder/administracja/ustawienia-ogolne): formularz ustawień
- [Zapora sieciowa i rezydencja danych](/pl/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall): klucze sterujące połączeniami wychodzącymi
- [Punkty końcowe API](/pl/hc/dokumentacja/nauka-dxpr-builder/referencja/punkty-koncowe-api): trasy czytające tę konfigurację