--- url: 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalacao' title: 'Instale o DXPR Builder no seu site Drupal | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T14:10:28+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- Instale o DXPR Builder num site Drupal que já corre, adicione a sua chave de produto e mude um tipo de conteúdo para o construtor. No fim tem uma página guardada que mostra o construtor, pronta para o seu primeiro elemento. A começar um site novo? Comece um novo site com o DXPR CMS configura construtor, tema e tipos de conteúdo de uma 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: 'Instale o DXPR Builder no seu site Drupal' description: |- Instale o DXPR Builder num site Drupal que já corre, adicione a sua chave de produto e mude um tipo de conteúdo para o construtor. No fim tem uma página guardada que mostra o construtor, pronta para o seu primeiro elemento. A começar um site novo? Comece um novo site com o DXPR CMS configura construtor, tema e tipos de conteúdo de uma vez. image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T14:10:28+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/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalacao' articleSection: 'Instalar e atualizar' - '@type': WebPage '@id': 'https://dxpr.com/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalacao' description: |- Instale o DXPR Builder num site Drupal que já corre, adicione a sua chave de produto e mude um tipo de conteúdo para o construtor. No fim tem uma página guardada que mostra o construtor, pronta para o seu primeiro elemento. A começar um site novo? Comece um novo site com o DXPR CMS configura construtor, tema e tipos de conteúdo de uma vez. breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Início item: 'https://dxpr.com/pt-pt' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: pt-pt --- [Centro de ajuda](/pt-pt/node/75)/[Documentação](/pt-pt/hc/documentacao) /[Aprender DXPR Builder](/pt-pt/hc/documentation/learn-dxpr-builder) /[Comece aqui](/pt-pt/hc/documentation/learn-dxpr-builder/start-here) /[Instalar e atualizar](/pt-pt/hc/documentation/learn-dxpr-builder/start-here/install) # Instale o DXPR Builder no seu site Drupal. Aprender DXPR BuilderComece aquiInstalar e atualizar ## Neste guia Guias relacionados - [Crie a sua primeira página](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/primeira-pagina) - [Utilize o DXPR Builder nos seus tipos de conteúdo](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalar-em-tipos-de-conteudo-existentes) - [Atualizar o DXPR Builder](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar) Instale o DXPR Builder num site Drupal que já corre, adicione a sua chave de produto e mude um tipo de conteúdo para o construtor. No fim tem uma página guardada que mostra o construtor, pronta para o seu primeiro elemento. A começar um site novo? [Comece um novo site com o DXPR CMS](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalar-dxpr-cms)configura construtor, tema e tipos de conteúdo de uma vez. O vídeo em [Utilize o DXPR Builder nos seus tipos de conteúdo](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalar-em-tipos-de-conteudo-existentes)percorre os passos 2 a 8 da verificação no fim desta página. ## Antes de começar - Drupal 10.2 ou posterior, incluindo Drupal 11, com PHP 8.1 ou posterior. [Requisitos do sistema](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/requisitos) lista o resto. - Composer e Drush no seu projeto. - Uma chave de produto. O DXPR Builder precisa de uma para funcionar; encontre a sua em [dxpr.com/getting-started](/getting-started). ## Instalar o módulo 1. Descarregue o DXPR Builder 3.x com Composer. A versão 3 é publicada como versões beta, por isso permita-as: ```bash composer require 'drupal/dxpr_builder:^3.0@beta' ``` Um simples `composer require drupal/dxpr_builder` instala antes a série 2.x estável. 2. Ative o módulo: ```bash drush en dxpr_builder ``` O Drush também ativa o módulo Key e os módulos nucleares de que o DXPR Builder precisa: Field, Field UI, Views, Image e Block. ## Adicionar a chave de produto 1. Vá a **DXPR Studio** > **DXPR Builder** > **General Settings**(`/admin/dxpr_studio/dxpr_builder/settings`). 2. Na secção **License**, escolha um **Storage method**. 3. Para **Configuration storage**, cole a chave em **Product key**. Para **Key module**, escolha a sua chave em **Key**. 4. Clique em **Save settings**. **Configuration storage** mantém a chave na configuração do site, por isso acaba em exportações de configuração. **Key module** lê-a de uma chave que cria primeiro em `/admin/config/system/keys`. Dê a essa chave o fornecedor **File**ou **Environment** para a manter fora das exportações também. ## Adicionar submódulos (opcional) O DXPR Builder traz três submódulos. Ative um com `drush en` e o nome. | Submódulo | O que adiciona | Precisa de | |---|---|---| | `dxpr_builder_page` | O tipo de conteúdo **Drag and drop Page**, já definido para o construtor | O módulo [Field Group](https://www.drupal.org/project/field_group) instalado | | `dxpr_builder_block` | O tipo de bloco **Drag and Drop Block**, para conteúdo de construtor em regiões de bloco | O módulo nuclear **Block Content**, ativado primeiro | | `dxpr_builder_media` | Um navegador de media legado baseado em Entity Browser; oculto na **Extend**, página de administração | Entity Browser e Inline Entity Form | A maioria dos sites não precisa de submódulo de media. Quando o **Media Library** nuclear está ativado na instalação, o construtor usa-o. Senão escolha-o mais tarde em **Media** > **Browser type** na página de definições. [Submodule architecture](/pt-pt/hc/documentacao/aprender-dxpr-builder/desenvolvimento/submodulos) tem os detalhes. ## Ativar funcionalidades de IA (opcional) Criação de páginas por IA, texto de IA e imagens de IA correm através do módulo [AI](https://www.drupal.org/project/ai) e do [DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr). 1. Descarregue ambos os módulos: ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. Ative-os: ```bash drush en ai ai_provider_dxpr ``` 3. Vá a `/admin/config/ai/providers/dxpr`, escolha a chave que contém a sua chave de produto em **DXPR API Key**, e guarde. 4. Vá a `/admin/dxpr_studio/dxpr_builder/ai_settings`. Em **AI Features**, as três caixas vêm assinaladas por predefinição. Desmarque qualquer funcionalidade que não queira. O [guia de funcionalidades de IA](/hc/documentation/learn-dxpr-builder/ai) explica cada definição. ## Verificar a instalação O construtor aparece em conteúdo cujo campo de texto usa o formatador **DXPR Builder**. Estes passos definem-no num tipo de conteúdo com campo **Body**. O tipo **Drag and drop Page** de `dxpr_builder_page` já está definido, por isso aí pode saltar os passos 2 a 5. 1. Vá a **DXPR Studio** > **DXPR Builder** > **General Settings** e verifique a secção **License** para a sua chave de produto. 2. Vá a **Structure** > **Content types**. Abra o menu ao lado de um tipo de conteúdo com campo **Body** e clique em **Manage display**. 3. Se abrir uma visão geral de modos de vista, clique em **Manage** para **Default**. 4. Mude o **Format** do Body para **DXPR Builder**. 5. Clique em **Save**. 6. Crie conteúdo desse tipo e escreva um **Title**. 7. Clique em **Save**. 8. Paire o cursor sobre a área de conteúdo. A barra de ferramentas do DXPR Builder aparece. ## O que vê A página guardada mostra um construtor vazio onde estaria o texto do corpo. Oferece uma pergunta de IA, esmaecida até a IA estar configurada, mais **Choose a template** e **Add Elements**. Clique em **Add Elements**: o seletor de elementos abre com os separadores **Layout** e **Content**. O DXPR Builder está a funcionar. ## Se não vir o construtor - **A página mostra o texto do corpo, mas sem construtor.** O campo ainda usa outro formatador. Defina o seu **Format** como **DXPR Builder** no modo de vista **Default** em **Structure** > **Content types** > **Manage display**. - **O formulário de edição mostra uma área de texto simples.** O DXPR Builder funciona na página guardada, não no formulário de edição. Guarde o conteúdo e abra a sua página. - **O construtor aparece só para o administrador.** Outras funções não têm a permissão **Edit with DXPR Builder**. Conceda-a em **People** > **Permissions** (`/admin/people/permissions`). - **Um segundo editor vê "Only one account can use DXPR Builder on the DXPR Free tier".** O escalão gratuito permite um editor. Introduza uma chave de produto de uma subscrição paga em **License**. - **Um erro diz "Your product key is not valid".** A CDN DXPR rejeitou a chave. Cole a chave completa de novo em **License** em `/admin/dxpr_studio/dxpr_builder/settings`. - **Um erro diz "DXPR Builder cloud assets could not be loaded".** O navegador não alcança `cdn2.dxpr.com` nem `cdn.dxpr.com`. Permita ambos os anfitriões, como explica [Firewall e residência dos dados](/pt-pt/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall). - **A pergunta de IA diz "AI features require the AI module".** Os módulos de IA ainda não estão configurados. Siga [Ativar funcionalidades de IA](#turn-on-ai-features-optional), ou desmarque as funcionalidades em **AI Features** em `/admin/dxpr_studio/dxpr_builder/ai_settings`. - **Save settings indica "Invalid product key".** O texto colado não é uma chave inteira, ou é uma chave feita para o DXPR Builder 1.x. Copie a sua chave atual de novo, sem espaços nem quebras de linha. [The editor does not appear](/pt-pt/hc/documentacao/aprender-dxpr-builder/resolucao-de-problemas/editor-nao-aparece)abrange mais causas. ## E a seguir? - [Crie a sua primeira página](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/primeira-pagina): construa uma página de secções, filas e elementos. - [Utilize o DXPR Builder nos seus tipos de conteúdo](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/instalar-em-tipos-de-conteudo-existentes): mude mais tipos de conteúdo, ou adicione um campo de construtor. - [Atualizar o DXPR Builder](/pt-pt/hc/documentacao/aprender-dxpr-builder/primeiros-passos/atualizar): mantenha o módulo atual e corra `drush updatedb` depois de cada atualização. - [Test variations](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): testes A/B com o módulo [Reinforcement Learning](https://www.drupal.org/project/rl).