Image Field ACF Não Retorna URL: como corrigir

Tipo Page Builders

Nome do erro Image Field do ACF PRO não retorna URL EN: ACF PRO Image Field not returning URL

Severidade Atenção

Descrição O Image Field do ACF PRO não retorna a URL quando o Return Format do campo está como Image Array ou Image ID, mas o template usa o valor como se fosse a string da URL. O ACF devolve um array ou um número de anexo, então o atributo src da imagem sai quebrado ou vazio.

Conteúdo exclusivo para membros Pro

Faça upgrade para acessar este item completo.

// ★ Conteúdo disponível para membros Pro...
// Faça upgrade para acessar este item.

Perguntas frequentes

Por que o Image Field do ACF imprime a palavra Array em vez da imagem

O Return Format do campo está como Image Array e o template tenta imprimir o array inteiro como se fosse texto. Leia a chave url do array com get_field e escape com esc_url, ou troque o Return Format do campo para Image URL na configuração.

Qual a diferença entre Image Array, Image URL e Image ID no ACF

Image Array devolve um array com url, alt, width e sizes. Image URL devolve só a string da URL, pronta para o src. Image ID devolve o número do anexo, que você converte em caminho com wp_get_attachment_image_url. Escolha conforme o que o template precisa.

Como pego só a URL quando o campo está como Image Array

Guarde o retorno de get_field em uma variável e acesse a chave url do array. Imprima com esc_url para escapar a saída. O mesmo array traz alt e sizes caso você queira montar a tag de imagem completa com texto alternativo.

O campo devolve um número em vez do caminho da imagem, o que é

O Return Format está como Image ID, então o ACF entrega o número do anexo. Passe esse ID para wp_get_attachment_image_url com o tamanho desejado para obter a URL, ou mude o Return Format do campo para Image URL se quiser o caminho direto.

Posso usar the_field para exibir o Image Field

Só funciona bem quando o Return Format é Image URL, porque the_field imprime a string direta. Com Image Array ou Image ID o the_field imprime a palavra Array ou um número. Para esses formatos use get_field, monte a tag e escape a saída.

A imagem some dentro de um Repeater, como corrijo

Dentro de Repeater ou Flexible Content a imagem só sai por get_sub_field, chamado dentro do laço have_rows. Usar get_field no campo pai não devolve a imagem da linha atual. Acesse a chave url do retorno e escape com esc_url antes de imprimir.

Por que a imagem aparecia e parou de aparecer de repente

O anexo selecionado pode ter sido removido da biblioteca de mídia. Com Image ID a função wp_get_attachment_image_url devolve false para um ID inexistente. Confirme se o arquivo ainda existe na mídia e selecione a imagem de novo no campo.

Pro Atenção

Como corrigir o erro de CSS no Customizer do Astra Pro

O Astra Customizer CSS não aplica quando o código de Personalizar -> CSS Adicional não surte efeito no site, porque o cache serve o head antigo, a regra perde para a especificidade do CSS dinamico do Astra Pro, ou o CSS ficou preso a outro tema. A correção limpa o cache, sobe a especificidade do seletor e confirma o tema ativo.

Pro Atenção

Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce

O Astra mini cart do WooCommerce que não aparece deixa o icone ausente no header, abre um dropdown vazio ou exibe a janela transparente. A causa quase sempre e o elemento Cart não adicionado no Header Builder, o script wc-cart-fragments bloqueado pelo cache, ou o filtro de fundo do outline cart desligado após migrar do header antigo.

Pro Crítico

Como corrigir Elementor que não salva alterações

O Elementor que não salva alterações deixa o botão Atualizar girando para sempre ou retorna erro, e o trabalho se perde ao recarregar. A causa quase sempre é o max_input_vars do PHP baixo demais para a página, ou uma regra de mod_security/WAF bloqueando a requisição de salvamento (admin-ajax.php).

Pro Grave

Como corrigir o erro de licença ao ativar o Elementor Pro

O erro de licença do Elementor Pro impede a ativação dos recursos pagos quando a chave não conecta ao servidor da Elementor, o limite de sites do plano foi atingido ou a licença ainda consta ativa em outro domínio.

Pro Grave

Como corrigir a incompatibilidade entre JetThemeCore e Astra

A incompatibilidade entre JetThemeCore e Astra aparece quando o Theme Builder do Crocoblock não consegue substituir o cabeçalho, o rodape ou o body do Astra, e a página sai com o layout nativo do tema em vez do template criado. O Override theme header, body e footer parece não ter efeito e o template publicado e ignorado no front-end.

Pro Atenção

Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg

A incompatibilidade do ACF PRO com o Gutenberg ocorre quando o plugin Gutenberg standalone, uma versão defasada do ACF ou um block.json mal registrado impedem que campos e ACF Blocks apareçam no editor de blocos.

Setores

Extensões

Integrações

Como corrigir o Image Field no ACF PRO

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir o erro de CSS no Customizer do Astra Pro

Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce

Como corrigir Elementor que não salva alterações

Como corrigir o erro de licença ao ativar o Elementor Pro

Como corrigir a incompatibilidade entre JetThemeCore e Astra

Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos