Referencia de la API.

Los servicios PHP, puntos de extensión JavaScript y rutas que DXPR Builder define. Los ID de servicio vienen de dxpr_builder.services.yml, las rutas de dxpr_builder.routing.yml. Para detalles de petición y respuesta de cada ruta, consulta Endpoints de la API.

Servicios PHP

DxprBuilderServiceInterface

Implementado por dxpr_builder.service. Los métodos que más probablemente llamarás:

• insertBaseTokens($content): reemplaza la URL base de este sitio, el directorio de archivos y la ruta del módulo con tokens. El editor guarda contenido en esta forma.
• replaceBaseTokens(&$content): void: expande los tokens de vuelta a URL para el entorno actual.
• stripHtmlElementPersists(string $markup): string: quita los atributos data-az-persist. Ejecútalo en marcado escrito fuera del editor; el editor los reconstruye al cargar.
• getCmsElementNames(): los bloques y pantallas de vistas ofrecidos como elementos, en caché.
• getIconSets(): array: el registro de conjuntos de iconos tras el descubrimiento YAML y hook_dxpr_builder_icon_sets_alter().

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

DxprBuilderLicenseServiceInterface

Implementado por dxpr_builder.license_service.

• isBillableUser(?AccountInterface $account = NULL): bool: TRUE para el usuario 1 y para cuentas activas con edit with dxpr builder no excluidas de la edición con DXPR Builder.
• getLicenseInfo(): estado de licencia desde el servidor de licencias de DXPR, en caché. Sin clave de producto devuelve el nivel gratuito: una persona y 100 elementos de contenido.
• syncAllUsersWithCentralStorage(string $operation, string $json_web_token = ''): void: envía las personas que editan de este sitio a DXPR. $operation es una de las constantes de interfaz DXPR_USER_SYNC_OPERATION (sync), DXPR_USER_ADD_OPERATION (add) o DXPR_USER_REMOVE_OPERATION (remove).

DxprBuilderKeyService

• getApiKey(): ?string: la clave de producto. Cuando el ajuste api_key_storage es key, lee la entidad Key nombrada en key_provider; si no, lee json_web_token.
• setApiKey(string $key_value, string $storage_type = 'config', ?string $selected_key_id = NULL): void: guarda la clave en configuración o en una entidad Key.

DxprBuilderJWTDecoder

• decodeJwt(string $access_token): devuelve los claims sub, scope y dxpr_tier de la clave de producto, cada uno NULL cuando el token no puede leerse. El resultado se guarda en caché por token.

Puntos de extensión JavaScript

Los scripts del editor comparten dos arrays en window.dxprBuilder. Pon tus propios objetos en ellos entre el script que crea el array y dxpr_builder.js, que los lee una vez al ejecutarse.

Los tipos de parámetro que el módulo registra son boxmodel, checkbox, checkboxes, colorpicker, datetime, dropdown, dxb_slider, html, icon, image, images, link, links, numericfield, row_layout, saved_datetime, social_links, textarea, textfield y video. Un parámetro con un type desconocido se renderiza como una entrada de texto simple.

Elementos personalizados muestra una definición completa de elemento y cómo cargarla en el momento justo.

Rutas del editor

Leyenda de acceso: billable es la comprobación _dxpr_builder_billable_user (usuario 1, o una cuenta activa con edit with dxpr builder no excluida); CSRF es _csrf_token.

Rutas de administración

Todas las páginas de administración están en DXPR Studio > DXPR Builder. La columna de pestaña muestra la etiqueta en el menú de administración.