Architectuur.

De PHP-services, JavaScript-extensiepunten en routes die DXPR Builder definieert. Service-ID's komen uit dxpr_builder.services.yml, routes uit dxpr_builder.routing.yml. Voor de aanvraag- en antwoorddetails van elke route, zie API-endpoints.

PHP-services

DxprBuilderServiceInterface

Geïmplementeerd door dxpr_builder.service. De methoden die je het meest waarschijnlijk aanroept:

• insertBaseTokens($content): vervangt de basis-URL van deze site, de filesmap en het modulepad met tokens. De editor bewaart inhoud in deze vorm.
• replaceBaseTokens(&$content): void: breidt de tokens weer uit naar URL's voor de huidige omgeving.
• stripHtmlElementPersists(string $markup): string: verwijdert de data-az-persist-attributen. Draai hem op markup geschreven buiten de editor; de editor herbouwt ze bij laden.
• getCmsElementNames(): de blokken en Views-displays aangeboden als elementen, gecachet.
• getIconSets(): array: het pictogrammensetregister na YAML-discovery en hook_dxpr_builder_icon_sets_alter().

$markup = \Drupal::service('dxpr_builder.service')->insertBaseTokens($html);

DxprBuilderLicenseServiceInterface

Geïmplementeerd door dxpr_builder.license_service.

• isBillableUser(?AccountInterface $account = NULL): bool: TRUE voor gebruiker 1 en voor actieve accounts met edit with dxpr builder die niet zijn uitgesloten van DXPR Builder-bewerken.
• getLicenseInfo(): licentiestatus van de DXPR-licentieserver, gecachet. Zonder productsleutel geeft hij de gratis tier terug: één gebruiker en 100 contentitems.
• syncAllUsersWithCentralStorage(string $operation, string $json_web_token = ''): void: stuurt de redacteurs van deze site naar DXPR. $operation is een van de interfaceconstanten DXPR_USER_SYNC_OPERATION (sync), DXPR_USER_ADD_OPERATION (add) of DXPR_USER_REMOVE_OPERATION (remove).

DxprBuilderKeyService

• getApiKey(): ?string: de productsleutel. Wanneer de instelling api_key_storage key is, leest hij de Key-entiteit genoemd in key_provider; anders leest hij json_web_token.
• setApiKey(string $key_value, string $storage_type = 'config', ?string $selected_key_id = NULL): void: bewaart de sleutel in config of in een Key-entiteit.

DxprBuilderJWTDecoder

• decodeJwt(string $access_token): geeft de claims sub, scope en dxpr_tier van de productsleutel terug, elk NULL wanneer het token niet kan worden gelezen. Het resultaat is gecachet per token.

JavaScript-extensiepunten

De editorscripts delen twee arrays op window.dxprBuilder. Push je eigen objecten erop tussen het script dat de array maakt en dxpr_builder.js, dat ze één keer leest wanneer het draait.

De parametertypen die de module registreert zijn boxmodel, checkbox, checkboxes, colorpicker, datetime, dropdown, dxb_slider, html, icon, image, images, link, links, numericfield, row_layout, saved_datetime, social_links, textarea, textfield en video. Een parameter met een onbekende type rendert als een gewone tekstinput.

Aangepaste elementen toont een complete elementdefinitie en hoe je die op het juiste moment laadt.

Editorroutes

Toegangslegende: billable is de _dxpr_builder_billable_user-controle (gebruiker 1, of een actief account met edit with dxpr builder dat niet is uitgesloten); CSRF is _csrf_token.

Adminroutes

Alle adminpagina's staan onder DXPR Studio > DXPR Builder. De kolom Tab toont het label in het adminmenu.