--- url: 'https://dxpr.com/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion' title: 'Instala DXPR Builder en tu sitio Drupal | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T00:12:43+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: 'Instala DXPR Builder en un sitio Drupal que ya funciona, añade tu clave de producto y cambia un tipo de contenido al constructor. Al final tienes una página guardada que muestra el constructor, lista para tu primer elemento. ¿Empiezas un sitio nuevo? Empieza un sitio nuevo con DXPR CMS configura el constructor, el tema y los tipos de contenido de una vez.' 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: 'Instala DXPR Builder en tu sitio Drupal' description: 'Instala DXPR Builder en un sitio Drupal que ya funciona, añade tu clave de producto y cambia un tipo de contenido al constructor. Al final tienes una página guardada que muestra el constructor, lista para tu primer elemento. ¿Empiezas un sitio nuevo? Empieza un sitio nuevo con DXPR CMS configura el constructor, el tema y los tipos de contenido de una vez.' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T00:12:43+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/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion' articleSection: 'Instalar y actualizar' - '@type': WebPage '@id': 'https://dxpr.com/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion' description: 'Instala DXPR Builder en un sitio Drupal que ya funciona, añade tu clave de producto y cambia un tipo de contenido al constructor. Al final tienes una página guardada que muestra el constructor, lista para tu primer elemento. ¿Empiezas un sitio nuevo? Empieza un sitio nuevo con DXPR CMS configura el constructor, el tema y los tipos de contenido de una vez.' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Inicio item: 'https://dxpr.com/es' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: es --- [Centro de ayuda](/es/hc)/[Documentación](/es/hc/documentacion) /[Aprende DXPR Builder](/es/hc/documentation/learn-dxpr-builder) /[Empieza aquí](/es/hc/documentation/learn-dxpr-builder/start-here) /[Instalar y actualizar](/es/hc/documentation/learn-dxpr-builder/start-here/install) # Instala DXPR Builder en tu sitio Drupal. Aprende DXPR BuilderEmpieza aquíInstalar y actualizar ## En esta guía Guías relacionadas - [Crea tu primera página](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/primera-pagina) - [Instalación en tipos de contenido existentes](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion-tipos-contenido-existentes) - [Actualiza DXPR Builder](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/actualizar) Instala DXPR Builder en un sitio Drupal que ya funciona, añade tu clave de producto y cambia un tipo de contenido al constructor. Al final tienes una página guardada que muestra el constructor, lista para tu primer elemento. ¿Empiezas un sitio nuevo? [Empieza un sitio nuevo con DXPR CMS](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalar-dxpr-cms) configura el constructor, el tema y los tipos de contenido de una vez. El vídeo en [Instalación en tipos de contenido existentes](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion-tipos-contenido-existentes) recorre los pasos 2 a 8 de la comprobación al final de esta página. ## Antes de empezar - Drupal 10.2 o posterior, incluido Drupal 11, con PHP 8.1 o posterior. [Requisitos del sistema](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/requisitos) lista el resto. - Composer y Drush en tu proyecto. - Una clave de producto. DXPR Builder la necesita para funcionar; encuentra la tuya en [dxpr.com/getting-started](/es/getting-started). ## Instala el módulo 1. Descarga DXPR Builder 3.x con Composer. La versión 3 se publica como versiones beta, así que permítelas: ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` Un simple `composer require drupal/dxpr_builder` instala en cambio la serie 2.x estable. 2. Activa el módulo: ```bash drush en dxpr_builder ``` Drush también activa el módulo Key y los módulos core que necesita DXPR Builder: Field, Field UI, Views, Image y Block. ## Añade tu clave de producto 1. Ve a **DXPR Studio** > **DXPR Builder** > **General Settings** (`/admin/dxpr_studio/dxpr_builder/settings`). 2. En la sección **License**, elige un **Storage method**. 3. Para **Configuration storage**, pega la clave en **Product key**. Para **Key module**, elige tu clave en **Key**. 4. Haz clic en **Save settings**. **Configuration storage** guarda la clave en la configuración del sitio, así que termina en las exportaciones de configuración. **Key module** la lee de una clave que creas primero en `/admin/config/system/keys`. Da a esa clave el proveedor **File** o **Environment** para mantenerla también fuera de las exportaciones. ## Añade submódulos (opcional) DXPR Builder trae tres submódulos. Activa uno con `drush en` y su nombre. | Submódulo | Qué añade | Necesita | |---|---|---| | `dxpr_builder_page` | El tipo de contenido **Drag and drop Page**, ya configurado al constructor | El módulo [Field Group](https://www.drupal.org/project/field_group). | | `dxpr_builder_block` | El tipo de bloque **Drag and Drop Block**, para contenido del constructor en regiones de bloque | El módulo core **Block Content**, activado primero | | `dxpr_builder_media` | Un explorador de medios heredado basado en Entity Browser; oculto en la página **Extend**. | Entity Browser e Inline Entity Form | La mayoría de sitios no necesita submódulo de medios. Cuando el core **Media Library** está activo al instalar, el constructor lo usa. Si no, elígelo más tarde en **Media** > **Browser type** en la página de ajustes. [Submódulos](/es/hc/documentacion/aprender-dxpr-builder/desarrollo/submodulos) tiene los detalles. ## Activa funciones de IA (opcional) La creación de páginas con IA, el texto con IA y las imágenes con IA usan el módulo [AI](https://www.drupal.org/project/ai) y el [proveedor DXPR AI](https://www.drupal.org/project/ai_provider_dxpr). 1. Descarga ambos módulos: ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. Actívalos: ```bash drush en ai ai_provider_dxpr ``` 3. Ve a `/admin/config/ai/providers/dxpr`, elige la clave con tu clave de producto en **DXPR API Key**, y guarda. 4. Ve a `/admin/dxpr_studio/dxpr_builder/ai_settings`. En **AI Features**, las tres casillas vienen marcadas por defecto. Desmarca cualquier función que no quieras. La [guía de funciones de IA](/hc/documentation/learn-dxpr-builder/ai) explica cada ajuste. ## Comprueba la instalación El constructor se muestra en contenido cuyo campo de texto usa el formato **DXPR Builder**. Estos pasos lo definen en un tipo de contenido con un campo **Body**. El tipo **Drag and drop Page** de `dxpr_builder_page` ya está configurado, así que allí puedes omitir los pasos 2 a 5. 1. Ve a **DXPR Studio** > **DXPR Builder** > **General Settings** y comprueba la sección **License** para tu clave de producto. 2. Ve a **Structure** > **Content types**. Abre el menú junto a un tipo de contenido con un campo **Body** y haz clic en **Manage display**. 3. Si se abre un resumen de modos de vista, haz clic en **Manage** para **Default**. 4. Cambia el **Format** de Body a **DXPR Builder**. 5. Haz clic en **Save**. 6. Crea contenido de ese tipo y escribe un **Title**. 7. Haz clic en **Save**. 8. Pasa el cursor sobre la zona de contenido. Aparece la barra de herramientas de DXPR Builder. ## Lo que ves La página guardada muestra un constructor vacío donde estaría el texto del cuerpo. Ofrece un prompt de IA, atenuado hasta que la IA está configurada, más **Choose a template** y **Add Elements**. Haz clic en **Add Elements**: el selector de elementos se abre con sus pestañas **Layout** y **Content**. DXPR Builder funciona. ## Si no ves el constructor - **La página muestra el texto del cuerpo, pero sin constructor.** El campo aún usa otro formato. Pon su **Format** en **DXPR Builder** en el modo de vista **Default** en **Structure** > **Content types** > **Manage display**. - **El formulario de edición muestra un área de texto simple.** DXPR Builder funciona en la página guardada, no en el formulario de edición. Guarda el contenido y abre su página. - **El constructor se muestra solo para la cuenta administradora.** Otros roles no tienen el permiso **Edit with DXPR Builder**. Otórgalo en **People** > **Permissions** (`/admin/people/permissions`). - **Una segunda persona que edita ve "Only one account can use DXPR Builder on the DXPR Free tier".** El nivel gratuito permite una persona que edita. Introduce una clave de producto de una suscripción de pago en **License**. - **Un error dice "Your product key is not valid".** El CDN de DXPR rechazó la clave. Pega la clave completa de nuevo en **License** en `/admin/dxpr_studio/dxpr_builder/settings`. - **Un error dice "DXPR Builder cloud assets could not be loaded".** El navegador no puede llegar a `cdn2.dxpr.com` o `cdn.dxpr.com`. Permite ambos anfitriones, como explica [Cortafuegos y residencia de datos](/es/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall). - **El prompt de IA dice "AI features require the AI module".** Los módulos de IA aún no están configurados. Sigue [Activa funciones de IA](#turn-on-ai-features-optional), o desmarca las funciones en **AI Features** en `/admin/dxpr_studio/dxpr_builder/ai_settings`. - **Guardar ajustes informa "Invalid product key".** El texto pegado no es una clave entera, o es una clave hecha para DXPR Builder 1.x. Copia tu clave actual de nuevo, sin espacios ni saltos de línea. [El editor no aparece](/es/hc/documentacion/aprender-dxpr-builder/solucion-problemas/editor-no-aparece) cubre más causas. ## ¿Qué sigue? - [Crea tu primera página](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/primera-pagina): construye una página desde secciones, filas y elementos. - [Instalación en tipos de contenido existentes](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/instalacion-tipos-contenido-existentes): cambia más tipos de contenido, o añade un campo del constructor. - [Actualiza DXPR Builder](/es/hc/documentacion/aprender-dxpr-builder/primeros-pasos/actualizar): mantén el módulo actualizado y ejecuta `drush updatedb` tras cada actualización. - [Prueba variantes](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): pruebas A/B con el módulo [Reinforcement Learning](https://www.drupal.org/project/rl).