--- url: 'https://dxpr.com/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalacja' title: 'Zainstaluj DXPR Builder na swojej witrynie Drupal | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T01:34:34+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: 'Zainstaluj DXPR Builder na działającej witrynie Drupala, dodaj klucz produktu i przełącz jeden typ treści na kreator. Na końcu masz zapisaną stronę pokazującą kreator, gotową na twój pierwszy element. Zaczynasz zamiast tego nową witrynę? Instalacja DXPR CMS ustawia kreator, motyw i typy treści za jednym razem.' tags: - 'Install and update' 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: 'Zainstaluj DXPR Builder na swojej witrynie Drupal' description: 'Zainstaluj DXPR Builder na działającej witrynie Drupala, dodaj klucz produktu i przełącz jeden typ treści na kreator. Na końcu masz zapisaną stronę pokazującą kreator, gotową na twój pierwszy element. Zaczynasz zamiast tego nową witrynę? Instalacja DXPR CMS ustawia kreator, motyw i typy treści za jednym razem.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T01:34:34+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/pierwsze-kroki/instalacja' articleSection: 'Instalacja i aktualizacja' - '@type': WebPage '@id': 'https://dxpr.com/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalacja' description: 'Zainstaluj DXPR Builder na działającej witrynie Drupala, dodaj klucz produktu i przełącz jeden typ treści na kreator. Na końcu masz zapisaną stronę pokazującą kreator, gotową na twój pierwszy element. Zaczynasz zamiast tego nową witrynę? Instalacja DXPR CMS ustawia kreator, motyw i typy treści za jednym razem.' 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) /[Zacznij tutaj](/pl/hc/documentation/learn-dxpr-builder/start-here) /[Instalacja i aktualizacja](/pl/hc/documentation/learn-dxpr-builder/start-here/install) # Zainstaluj DXPR Builder na swojej witrynie Drupal. Poznaj DXPR BuilderZacznij tutajInstalacja i aktualizacja ## W tym przewodniku Powiązane przewodniki - [Zbuduj swoją pierwszą stronę](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/pierwsza-strona) - [Używaj DXPR Builder na swoich typach treści](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalowanie-na-istniejacych-typach-tresci) - [Aktualizuj DXPR Builder](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/aktualizowanie) Zainstaluj DXPR Builder na działającej witrynie Drupala, dodaj klucz produktu i przełącz jeden typ treści na kreator. Na końcu masz zapisaną stronę pokazującą kreator, gotową na twój pierwszy element. Zaczynasz zamiast tego nową witrynę? [Instalacja DXPR CMS](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalowanie-dxpr-cms) ustawia kreator, motyw i typy treści za jednym razem. Film na stronie [Instalacja na istniejących typach treści](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalowanie-na-istniejacych-typach-tresci) przechodzi kroki 2 do 8 z listy kontrolnej na końcu tej strony. ## Zanim zaczniesz - Drupal 10.2 albo nowszy, łącznie z Drupalem 11, z PHP 8.1 albo nowszym. [Wymagania](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/wymagania-systemowe) wymieniają resztę. - Composer i Drush w twoim projekcie. - Klucz produktu. DXPR Builder potrzebuje go do pracy; swój znajdziesz na [dxpr.com/getting-started](/pl/getting-started). ## Zainstaluj moduł 1. Pobierz DXPR Builder 3.x Composerem. Wersja 3 jest publikowana jako wydania beta, więc na nie zezwól: ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` Zwykłe `composer require drupal/dxpr_builder` instaluje zamiast tego stabilną serię 2.x. 2. Włącz moduł: ```bash drush en dxpr_builder ``` Drush włącza też moduł Key i moduły jądra potrzebne DXPR Builder: Field, Field UI, Views, Image i Block. ## Dodaj swój klucz produktu 1. Przejdź do **DXPR Studio** > **DXPR Builder** > **General Settings** (`/admin/dxpr_studio/dxpr_builder/settings`). 2. W sekcji **License** wybierz **Storage method**. 3. Dla **Configuration storage** wklej klucz do **Product key**. Dla **Key module** wybierz swój klucz w sekcji **Key**. 4. Kliknij **Save settings**. **Configuration storage** trzyma klucz w konfiguracji witryny, więc trafia do eksportów konfiguracji. **Key module** czyta go z klucza, który najpierw utworzysz na `/admin/config/system/keys`. Nadaj temu kluczowi provider **File** albo **Environment**, aby trzymać go poza eksportami. ## Dodaj submoduły (opcjonalne) DXPR Builder dostarcza trzy submoduły. Włącz jeden przez `drush en` i jego nazwę. | Submoduł | Co dodaje | Potrzebuje | |---|---|---| | `dxpr_builder_page` | Typ treści **Drag and drop Page**, już ustawiony na kreator | Moduł [Field Group](https://www.drupal.org/project/field_group) (wymagany) | | `dxpr_builder_block` | Typ bloku **Drag and Drop Block**, na treść kreatora w regionach bloków | Moduł **Block Content**, włączony najpierw | | `dxpr_builder_media` | Starsza przeglądarka mediów na Entity Browser; ukryta, a znajdziesz ją na stronie **Extend** w administracji | Entity Browser i Inline Entity Form | Większość witryn nie potrzebuje submodułu mediów. Gdy wbudowana **Media Library** jest włączona w czasie instalacji, kreator jej używa. W przeciwnym razie wybierz ją później w **Media** > **Browser type** na stronie ustawień. [Architektura submodułów](/pl/hc/dokumentacja/nauka-dxpr-builder/programowanie/submoduly) ma szczegóły. ## Włącz funkcje AI (opcjonalne) Tworzenie stron przez AI, tekst AI i obrazy AI działają przez moduł [AI](https://www.drupal.org/project/ai) i [DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr). 1. Pobierz oba moduły: ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. Włącz je: ```bash drush en ai ai_provider_dxpr ``` 3. Przejdź na `/admin/config/ai/providers/dxpr`, wybierz klucz trzymający twój klucz produktu w sekcji **DXPR API Key** i zapisz. 4. Przejdź na `/admin/dxpr_studio/dxpr_builder/ai_settings`. W sekcji **AI Features** wszystkie trzy pola są domyślnie zaznaczone. Odznacz każdą funkcję, której nie chcesz. Przewodnik [funkcji AI](/hc/documentation/learn-dxpr-builder/ai) wyjaśnia każde ustawienie. ## Zweryfikuj instalację Kreator pokazuje się na treściach, których pole tekstowe używa formatera **DXPR Builder**. Te kroki ustawiają go na typie treści z polem **Body**. Typ **Drag and drop Page** z `dxpr_builder_page` jest już ustawiony, więc tam pomiń kroki 2 do 5. 1. Przejdź do **DXPR Studio** > **DXPR Builder** > **General Settings** i sprawdź sekcję **License** pod kątem klucza produktu. 2. Przejdź do **Structure** > **Content types**. Otwórz menu obok typu treści z polem **Body** i kliknij **Manage display**. 3. Jeśli otworzy się przegląd trybów widoku, kliknij **Manage** dla **Default**. 4. Zmień **Format** pola Body na **DXPR Builder**. 5. Kliknij **Save**. 6. Utwórz treść tego typu i wpisz **Title**. 7. Kliknij **Save**. 8. Najedź na obszar treści. Pojawi się pasek narzędzi DXPR Builder. ## Co widzisz Zapisana strona pokazuje pusty kreator w miejscu, gdzie byłby tekst body. Oferuje prompt AI, wyszarzony, dopóki nie skonfigurowano AI, plus **Choose a template** i **Add Elements**. Kliknij **Add Elements**: selektor elementów otworzy się z zakładkami **Layout** i **Content**. DXPR Builder działa. ## Jeśli nie widać kreatora - **Strona pokazuje tekst body, ale nie kreator.** Pole nadal używa innego formatera. Ustaw jego **Format** na **DXPR Builder** w trybie widoku **Default** w **Structure** > **Content types** > **Manage display**. - **Formularz edycji pokazuje zwykły obszar tekstowy.** DXPR Builder działa na zapisanej stronie, nie na formularzu edycji. Zapisz treść i otwórz jej stronę. - **Kreator pokazuje się tylko dla administratora.** Innym rolom brakuje uprawnienia **Edit with DXPR Builder**. Nadaj je w **People** > **Permissions** (`/admin/people/permissions`). - **Drugi redaktor widzi „Only one account can use DXPR Builder on the DXPR Free tier”.** Darmowy próg pozwala na jednego redaktora. Wpisz klucz produktu z płatnej subskrypcji w sekcji **License**. - **Błąd mówi „Your product key is not valid”.** CDN DXPR odrzucił klucz. Wklej pełny klucz ponownie w sekcji **License** na `/admin/dxpr_studio/dxpr_builder/settings`. - **Błąd mówi „DXPR Builder cloud assets could not be loaded”.** Przeglądarka nie dociera do `cdn2.dxpr.com` ani `cdn.dxpr.com`. Zezwól na oba hosty, jak wyjaśnia [Zapora sieciowa i przechowywanie danych](/pl/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall). - **Prompt AI mówi „AI features require the AI module”.** Moduły AI nie są jeszcze ustawione. Podążaj za [Włącz funkcje AI](#turn-on-ai-features-optional) albo odznacz funkcje w sekcji **AI Features** na `/admin/dxpr_studio/dxpr_builder/ai_settings`. - **Zapis ustawień zgłasza „Invalid product key”.** Wklejony tekst to nie cały klucz albo klucz zrobiony dla DXPR Builder 1.x. Skopiuj ponownie swój aktualny klucz, bez spacji i podziałów wierszy. [Edytor się nie pojawia](/pl/hc/dokumentacja/nauka-dxpr-builder/rozwiazywanie-problemow/edytor-sie-nie-pojawia) opisuje więcej przyczyn. ## Co dalej? - [Twoja pierwsza strona](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/pierwsza-strona): zbuduj stronę z sekcji, wierszy i elementów. - [Instalacja na istniejących typach treści](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/instalowanie-na-istniejacych-typach-tresci): przełącz więcej typów treści albo dodaj pole kreatora. - [Aktualizacja DXPR Builder](/pl/hc/dokumentacja/nauka-dxpr-builder/pierwsze-kroki/aktualizowanie): utrzymuj moduł aktualny i uruchamiaj `drush updatedb` po każdej aktualizacji. - [Testuj warianty](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): testy A/B z modułem [Reinforcement Learning](https://www.drupal.org/project/rl).