As imagens não carregam ou desaparecem.

Aprender DXPR BuilderGerir o siteResolver um problema

Ponha os carregamentos a funcionar e mantenha os ficheiros carregados no site. As imagens chegam à página pelo carregamento próprio do construtor ou pela Media Library, quando o site a usa. A maioria das falhas são definições de média, permissões de ficheiros ou um carregamento que nunca chegou ao servidor.

O navegador de média falta ou abre vazio

  1. Vá a DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) e abra a secção Media.
  2. Defina Browser type como Media Library e clique em Save settings. A opção só aparece quando o módulo Media Library do núcleo está ativado. Escolha Media Library (Acquia DAM) se usa Acquia DAM.
  3. Vá a Structure > Media types e confirme que existe um tipo de média com o nome de máquina image (video para vídeos). O construtor abre a Media Library nesse tipo.

Nota: Basic file upload mostra um botão simples Select image que carrega diretamente do seu computador. É a predefinição quando a Media Library não está ativada. Entity Browser é a opção legada; prefira Media Library.

O carregamento falha com um erro

  • "Destination file path is not writable" ou "File could not be saved". O servidor web não consegue escrever no diretório de ficheiros. Torne sites/default/files gravável para o utilizador do servidor web e depois verifique Reports > Status report.
  • "Only files with the following extensions are allowed". O construtor aceita imagens GIF, JPEG, PNG, WebP, AVIF e SVG, e vídeos WebM, Ogg e MP4. Na Media Library, o tipo de média decide: adicione a extensão em Allowed file extensions do campo de imagem em Structure > Media types > Image > Manage fields.
  • "exceeding the maximum file size" ou "The uploaded video is too large". O ficheiro é maior do que o PHP aceita. Suba upload_max_filesize e post_max_size no PHP, e o limite de tamanho do corpo do seu servidor web ou proxy.
  • 403 ou 405 em /dxpr_builder/ajax/file_upload. Um proxy ou firewall bloqueia ou redireciona pedidos POST para esse caminho. Ponha-o na lista de permissões e garanta que o site não o redireciona, por exemplo de HTTP para HTTPS.
  • Os editores recebem "Access denied" dentro do navegador de média. A função precisa de View media para abrir a Media Library e de Image: Create new media para carregar nela. Conceda ambas em People > Permissions.

As imagens desaparecem poucas horas depois de carregar

O ficheiro desapareceu de sites/default/files/dxpr_builder_images e a página mostra uma imagem partida.

Os lançamentos anteriores a 3.0.0-alpha85 guardavam os carregamentos do construtor como ficheiros temporários quando o módulo Media estava desligado. O cron do Drupal apaga ficheiros temporários ao fim de seis horas.

  1. Atualize para o lançamento atual. Guarda os carregamentos como ficheiros permanentes e regista o seu uso.
  2. Carregue de novo as imagens em falta ou restaure-as de uma cópia de segurança para a mesma pasta.

Nota: os carregamentos vão para dxpr_builder_images, dxpr_builder_videos e dxpr_builder_files no diretório de ficheiros predefinido.

As imagens aparecem no editor mas não para os visitantes

  • A imagem desapareceu depois de recarregar. O contentor não foi guardado. Adicione a imagem de novo e clique em Save na barra do contentor.
  • Vê a imagem, os visitantes não. Apply text format filters to frontend content está ligado em General Settings > Text Filters e o formato de texto do campo remove etiquetas img ou os seus atributos. Os editores veem sempre o conteúdo não filtrado. Desligue a definição ou permita img nesse formato de texto.
  • Os visitantes veem uma versão mais antiga da página. Uma cache serve a página antiga. Veja Os visitantes veem algo diferente.

Confirmar a correção

Carregue uma imagem para um elemento Image e guarde o contentor. Numa janela privada, a imagem aparece para um visitante anónimo.

E a seguir?

Integração da Media Library para reutilizar média existente no construtor.