DXPR Builder installeren op je Drupal-site.

DXPR Builder lerenBegin hierInstalleren en 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 zet de builder, het thema en inhoudstypen in één keer op.

De video op Installeren op bestaande inhoudstypen 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 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.

De module installeren

  1. Download DXPR Builder 3.x met Composer. Versie 3 verschijnt als bèta-releases, dus sta ze toe:

    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:

    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.

Algemene-instellingenpagina van DXPR Builder met productsleutelconfiguratie

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 Groupmodule
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 heeft de details.

AI-functies inschakelen (optioneel)

AI-pagina-aanmaak, AI-tekst en AI-afbeeldingen draaien via de module AI en de DXPR AI Provider.

  1. Download beide modules:

    composer require drupal/ai drupal/ai_provider_dxpr

  2. Schakel ze in:

    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 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 uitlegt.
  • De AI-prompt zegt “AI features require the AI module”. De AImodules zijn nog niet ingesteld. Volg AI-functies inschakelen, 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 behandelt meer oorzaken.

Wat nu?