Campos de conteúdo do ACF

Se o ACF já nos dá muita flexibilidade com os campos de texto, com os campos de conteúdo então…

Os campos de conteúdo do ACF são adicionados da mesma maneira. São eles imagem, arquivo, editor wysiwyg e oembed.

Campos de imagem e arquivo do ACF

Os campos de imagem de arquivo têm a mesma interface: um botão que permite que o usuário use a biblioteca de mídia do WordPress. Pode-se fazer upload de uma imagem ou arquivo ou selecionar um que já tenha sido acrescentado à biblioteca.

Ao cadastrar o arquivo ou imagem pode-se escolher o valor que será retornado pelas funções do ACF no front-end:

Escolha de tipo de valor retornado do ACF

Isso vai influenciar como você usa essa função no seu tema ou plugin. Se for um array, ele já vem com todos os tamanhos de imagem cadastrados em add_image_size.

URL retorna o endereço da imagem original, sem mais nenhuma informação. ID da imagem retorna só o ID, para ser usado com as funções do WordPress, como no exemplo abaixo:

PHP

A vantagem de se usar o ID e as funções nativas do WordPress é que já será mostrada uma imagem responsiva, com srcset.

'tamanho' seria o tamanho desejado da imagem. Pode ser usado um valor padrão do WP (thumbnail, medium, large, full) ou um valor customizado criado pelo tema ou plugin.

O campo do tipo arquivo pode ser usado da mesma maneira. Temos porém que que usar wp_get_attachment_url ao invés de image. Também podemos usar a URL:

PHP

Em ambos os casos temos a opção de definir tamanhos mínimos e máximos. Em megabytes e pixels, no caso das imagens, e apenas em MB, no caso dos arquivos.

O próximo tipo de campo é o Wysiwyg. Este é na verdade um editor visual dentro de um campo customizado. É na verdade o mesmo editor usado pelo WP antes do Gutenberg e pelo plugin Editor Clássico.

Nele podemos fazer bold, itálico, adicionar fotos, aquele miniword que conhecemos:

Editor Wysiwyg do ACF

Por último temos o oembed, para inserir conteúdos ricos (Youtube, Vimeo, Twitter, Facebook, etc.) Para usar, basta chamar a função the_field do ACF:

PHP

Esses são os campos de conteúdo do ACF, que como pode-se ver são extramemente versáteis e úteis. Para informações mais avançadas, uma visita à documentação do ACF é de grande ajuda.

Até a próxima se não for antes!