Instale o DXPR Builder no seu site Drupal.

Aprender DXPR BuilderComece aquiInstalar e 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 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 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 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.

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:

    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:

    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.

Página General Settings do DXPR Builder com configuração de chave de produto

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 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 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 e do DXPR AI Provider.

  1. Descarregue ambos os módulos:

    composer require drupal/ai drupal/ai_provider_dxpr

  2. Ative-os:

    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 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.
  • 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, 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 abrange mais causas.

E a seguir?