Mude páginas de Paragraphs para o DXPR Builder.

Aprender DXPR BuilderComece aquiMudar de outro construtor

Reconstróem-se os parágrafos de cada página como elementos DXPR Builder, num campo novo do mesmo tipo de conteúdo. Os parágrafos ficam publicados até todas as páginas estarem prontas. Depois, os editores desenham a página na própria página em vez de preencherem formulários de parágrafos. Nenhuma ferramenta converte parágrafos, mas o Drush consegue escrever HTML preparado em muitas páginas de uma vez.

Antes de começar

  • O DXPR Builder está instalado e a sua chave de produto está guardada, veja Definições gerais.
  • Pode gerir os campos e a apresentação do tipo de conteúdo.
  • Cada página do tipo de conteúdo conta como conteúdo quando a sua apresentação usa o formatador DXPR Builder. Verifique o seu limite no separador Content Items.

Configurar

  1. Vá a Structure > Content types (/admin/structure/types) e clique em Manage fields do tipo de conteúdo.
  2. Adicione um campo: escolha Formatted text e depois Long text, por exemplo "Page content".
  3. Clique em Manage display e defina o Format do campo novo como DXPR Builder.
  4. Deixe o campo Paragraphs onde está e clique em Save.

Reconstrua cada página

  1. Abra a página. O campo DXPR Builder vazio aparece junto aos parágrafos.
  2. Reconstrua cada parágrafo com o elemento correspondente da tabela por baixo.
  3. Copie o texto de cada parágrafo para os elementos novos.
  4. Clique em Save na barra de ferramentas do DXPR Builder.
Tipo de parágrafo Elemento DXPR Builder
Texto Text
Imagem Image
Texto com imagem Row com duas colunas: Text e Image
Acordeão Collapse panel do separador Layout respetivo
Apelo à ação Button
Vídeo Video
Galeria Image carousel
Webform O bloco webform do separador Drupal Blocks respetivo
Qualquer outra coisa HTML ou uma combinação de elementos

Reconstrua muitas páginas com o Drush

O DXPR Builder transforma HTML de Bootstrap 5 em elementos que pode arrastar e editar. Se conseguir exportar o conteúdo antigo como HTML, escreva-o em cada página com o Drush. Experimente primeiro com --dry-run, que mostra a mudança sem guardar:

drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

O comando encontra o campo DXPR Builder na apresentação predefinida do tipo de conteúdo. Guarda uma nova revisão, para poder reverter.

Termine a mudança

  1. Em Manage display, passe o campo Paragraphs para Disabled e clique em Save.
  2. Verifique as páginas reconstruídas, também no telemóvel.
  3. Apague o campo Paragraphs em Manage fields apenas quando já não precisar do seu conteúdo. Apagá-lo remove os parágrafos para sempre.

O que vê

Cada página mostra o conteúdo do campo DXPR Builder e os parágrafos deixam de aparecer. Os editores com a permissão Edit with DXPR Builder veem os controlos de edição na página. O separador Content items lista todas as páginas do tipo de conteúdo.

Se não vir o editor

  • A página mostra o conteúdo antigo e o novo. O campo Paragraphs ainda está na apresentação. Passe-o para Disabled em Manage display.
  • O Drush indica "No DXPR Builder field found". A apresentação predefinida não usa o formatador DXPR Builder. Defina o Format em Manage display do modo de vista predefinido.
  • O Drush indica "Multiple DXPR Builder fields found". O tipo de conteúdo tem mais de um. Indique o campo, por exemplo --field=field_page_content.
  • O campo aparece, mas sem controlos de edição. A sua conta não tem a permissão Edit with DXPR Builder ou os seus limites de licença foram atingidos. Veja Erros de licença e chave de produto.

E a seguir?