--- url: 'https://dxpr.com/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/installatie' title: 'DXPR Builder installeren op je Drupal-site | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2023-11-06T06:21:39+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: 'Installeer DXPR Builder op een Drupal-site die je al beheert, voeg je productsleutel toe en schakel één inhoudstype om naar de builder. Aan het eind heb je een opgeslagen pagina die de builder toont, klaar voor je eerste element. Begin je juist een nieuwe site? DXPR CMS installeren zet de builder, het thema en inhoudstypen in één keer op.' 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: 'DXPR Builder installeren op je Drupal-site' description: 'Installeer DXPR Builder op een Drupal-site die je al beheert, voeg je productsleutel toe en schakel één inhoudstype om naar de builder. Aan het eind heb je een opgeslagen pagina die de builder toont, klaar voor je eerste element. Begin je juist een nieuwe site? DXPR CMS installeren zet de builder, het thema en inhoudstypen in één keer op.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2023-11-06T06:21:39+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/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/installatie' articleSection: 'Installeren en bijwerken' - '@type': WebPage '@id': 'https://dxpr.com/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/installatie' description: 'Installeer DXPR Builder op een Drupal-site die je al beheert, voeg je productsleutel toe en schakel één inhoudstype om naar de builder. Aan het eind heb je een opgeslagen pagina die de builder toont, klaar voor je eerste element. Begin je juist een nieuwe site? DXPR CMS installeren zet de builder, het thema en inhoudstypen in één keer op.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Home item: 'https://dxpr.com/nl' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: nl --- [Helpcentrum](/nl/hc)/[Documentatie](/nl/hc/documentatie) /[DXPR Builder leren](/nl/hc/documentation/learn-dxpr-builder) /[Begin hier](/nl/hc/documentation/learn-dxpr-builder/start-here) /[Installeren en bijwerken](/nl/hc/documentation/learn-dxpr-builder/start-here/install) # DXPR Builder installeren op je Drupal-site. DXPR Builder lerenBegin hierInstalleren en bijwerken ## In deze gids Gerelateerde gidsen - [Je eerste pagina](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/eerste-pagina) - [DXPR Builder gebruiken op je inhoudstypen](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/installeren-op-bestaande-inhoudstypen) - [DXPR Builder bijwerken](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/bijwerken) Installeer DXPR Builder op een Drupal-site die je al beheert, voeg je productsleutel toe en schakel één inhoudstype om naar de builder. Aan het eind heb je een opgeslagen pagina die de builder toont, klaar voor je eerste element. Begin je juist een nieuwe site? [DXPR CMS installeren](/nl/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms) zet de builder, het thema en inhoudstypen in één keer op. De video op [Installeren op bestaande inhoudstypen](/nl/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) loopt stappen 2 tot 8 van de controle onderaan deze pagina door. ## Voordat je begint - Drupal 10.2 of later, inclusief Drupal 11, met PHP 8.1 of later. [Vereisten](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/systeemvereisten) somt de rest op. - Composer en Drush in je project. - Een productsleutel. DXPR Builder heeft er een nodig om te werken; vind de jouwe op [dxpr.com/getting-started](/nl/getting-started). ## De module installeren 1. Download DXPR Builder 3.x met Composer. Versie 3 verschijnt als bèta-releases, dus sta ze toe: ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` Een kale `composer require drupal/dxpr_builder` installeert juist de stabiele 2.x-reeks. 2. Schakel de module in: ```bash drush en dxpr_builder ``` Drush schakelt ook de Keymodule en de coremodules in die DXPR Builder nodig heeft: Field, Field UI, Views, Image en Block. ## Je productsleutel toevoegen 1. Ga naar **DXPR Studio** > **DXPR Builder** > **Algemene instellingen** (`/admin/dxpr_studio/dxpr_builder/settings`). 2. Kies in de sectie **Licentie** een **Opslagmethode**. 3. Voor **Configuratieopslag** plak je de sleutel in **Productsleutel**. Voor **Keymodule** kies je je sleutel onder **Sleutel**. 4. Klik op **Instellingen opslaan**. **Configuratieopslag** bewaart de sleutel in de siteconfiguratie, dus hij komt in configuratie-exports. **Keymodule** leest hem uit een sleutel die je eerst aanmaakt op `/admin/config/system/keys`. Geef die sleutel de provider **Bestand** of **Omgeving** om hem ook uit exports te houden. ## Submodules toevoegen (optioneel) DXPR Builder levert drie submodules mee. Schakel er een in met `drush en` en zijn naam. | Submodule | Wat hij toevoegt | Nodig | |---|---|---| | `dxpr_builder_page` | De **Sleep-en-neerzetpagina**, al omgezet naar de builder | De [Field Group](https://www.drupal.org/project/field_group)module | | `dxpr_builder_block` | Het bloktype **Sleep-en-neerzetblok**, voor builderinhoud in blokregio's | De coremodule **Blokinhoud**, eerst ingeschakeld | | `dxpr_builder_media` | Een verouderde mediabrowser gebouwd op Entity Browser; verborgen op de **Uitbreiden**-pagina | Entity Browser en Inline Entity Form | De meeste sites hebben geen mediasubmodule nodig. Als core **Mediabibliotheek** bij installatie is ingeschakeld, gebruikt de builder hem. Kies hem anders later onder **Media** > **Browsertype** op de instellingenpagina. [Submodule-architectuur](/nl/hc/documentatie/dxpr-builder-leren/ontwikkeling/submodules) heeft de details. ## AI-functies inschakelen (optioneel) AI-pagina-aanmaak, AI-tekst en AI-afbeeldingen draaien via de module [AI](https://www.drupal.org/project/ai) en de [DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr). 1. Download beide modules: ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. Schakel ze in: ```bash drush en ai ai_provider_dxpr ``` 3. Ga naar `/admin/config/ai/providers/dxpr`, kies de sleutel met je productsleutel onder **DXPR API Key**, en sla op. 4. Ga naar `/admin/dxpr_studio/dxpr_builder/ai_settings`. Onder **AI-functies** staan alle drie de vakjes standaard aan. Haal het vinkje weg bij elke functie die je niet wilt. De handleiding [AI-functies](/hc/documentation/learn-dxpr-builder/ai) legt elke instelling uit. ## De installatie controleren De builder verschijnt op inhoud waarvan het tekstveld de formatter **DXPR Builder** gebruikt. Deze stappen zetten hem op een inhoudstype met een **Body**-veld. Het type **Sleep-en-neerzetpagina** uit `dxpr_builder_page` is al ingesteld, dus daar sla je stappen 2 tot 5 over. 1. Ga naar **DXPR Studio** > **DXPR Builder** > **Algemene instellingen** en controleer de sectie **Licentie** op je productsleutel. 2. Ga naar **Structuur** > **Inhoudstypen**. Open het menu naast een inhoudstype met een **Body**-veld en klik op **Weergave beheren**. 3. Als er een overzicht van weergavemodi opent, klik je op **Beheren** voor **Standaard**. 4. Zet het **Formaat** van Body op **DXPR Builder**. 5. Klik op **Opslaan**. 6. Maak inhoud van dat type en typ een **Titel**. 7. Klik op **Opslaan**. 8. Beweeg over het inhoudsgebied. De DXPR Builder-werkbalk verschijnt. ## Wat je ziet De opgeslagen pagina toont een lege builder waar de bodytekst zou staan. Hij biedt een AI-prompt, grijs tot AI is ingesteld, plus **Kies een sjabloon** en **Add Elements**. Klik op **Add Elements**: de elementenkiezer opent met zijn tabbladen **Lay-out** en **Inhoud**. DXPR Builder werkt. ## Als je de builder niet ziet - **De pagina toont de bodytekst, maar geen builder.** Het veld gebruikt nog een andere formatter. Zet zijn **Formaat** op **DXPR Builder** op de weergavemodus **Standaard** onder **Structuur** > **Inhoudstypen** > **Weergave beheren**. - **Het bewerkingsformulier toont een kaal tekstgebied.** DXPR Builder werkt op de opgeslagen pagina, niet op het bewerkingsformulier. Sla de inhoud op en open zijn pagina. - **De builder verschijnt alleen voor de beheerder.** Andere rollen missen de toestemming **Bewerken met DXPR Builder**. Ken hem toe bij **Personen** > **Toestemmingen** (`/admin/people/permissions`). - **Een tweede editor ziet “Only one account can use DXPR Builder on the DXPR Free tier”.** De gratis laag staat één editor toe. Vul een productsleutel uit een betaald abonnement in onder **Licentie**. - **Een fout zegt “Your product key is not valid”.** Het DXPR CDN heeft de sleutel geweigerd. Plak de volledige sleutel opnieuw onder **Licentie** op `/admin/dxpr_studio/dxpr_builder/settings`. - **Een fout zegt “DXPR Builder cloud assets could not be loaded”.** De browser kan `cdn2.dxpr.com` of `cdn.dxpr.com` niet bereiken. Sta beide hosts toe, zoals [Firewall en dataresidentie](/nl/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall) uitlegt. - **De AI-prompt zegt “AI features require the AI module”.** De AImodules zijn nog niet ingesteld. Volg [AI-functies inschakelen](#turn-on-ai-features-optional), of haal het vinkje weg bij de functies onder **AI-functies** op `/admin/dxpr_studio/dxpr_builder/ai_settings`. - **Instellingen opslaan meldt “Invalid product key”.** De geplakte tekst is geen hele sleutel, of het is een sleutel gemaakt voor DXPR Builder 1.x. Kopieer je huidige sleutel opnieuw, zonder spaties of regeleinden. [De editor verschijnt niet](/nl/hc/documentatie/dxpr-builder-leren/probleemoplossing/editor-laadt-niet) behandelt meer oorzaken. ## Wat nu? - [Je eerste pagina](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/eerste-pagina): bouw een pagina uit secties, rijen en elementen. - [Installeren op bestaande inhoudstypen](/nl/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types): zet meer inhoudstypen om, of voeg een builderveld toe. - [DXPR Builder bijwerken](/nl/hc/documentatie/dxpr-builder-leren/aan-de-slag/bijwerken): houd de module actueel en draai `drush updatedb` na elke update. - [Variaties testen](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): A/B-testen met de module [Reinforcement Learning](https://www.drupal.org/project/rl).