Codificação para campos personalizados avançados: uma introdução

Advanced Custom Fields (ACF) é um plugin do WordPress que é uma ótima ferramenta na configuração de meta de postagem personalizada. Ele permite que você crie e configure facilmente meta caixas complexas e fáceis de usar com todos os tipos de campos e configurações para tipos de postagem, taxonomia, telas de usuário e páginas de opções. E é super amigável ao desenvolvedor.

Agora, você pode configurar suas próprias meta caixas ou configurações manualmente, mas para configurações mais complexas, é necessário codificar um pouco, incluindo estilo, Javascript, validação e salvamento de manuseio. Imagine, por exemplo, escrever manualmente um repetidor com um grupo de configurações, uma seleção múltipla de postagens por uma determinada consulta. Ou lidar com configurações de exibição que dependem de certas variáveis, como qual termo ou modelo de página é atribuído (o que requer Javascript). Campos personalizados avançados lida com tudo isso, e faz isso lindamente.

Tenha em mente que os Campos Personalizados Avançados não produzirão nenhuma meta personalizada em seus modelos. A saída ou fazer algo com base nos campos e configurações configurados com o ACF depende de você como desenvolvedor. Mas isso é feito facilmente usando qualquer um dos métodos do ACF. Também é bom saber que o ACF está utilizando a metafuncionalidade do núcleo do WordPress (pós, termo, usuário). O que significa que ele realmente salva, por exemplo, configurações de postagens como meta de postagem – que você pode obter usando funções principais, como get_post_meta().

Campos personalizados avançados vêm em uma versão gratuita e uma versão Pro paga. A versão gratuita é mais do que suficiente para a maioria dos casos, mas na versão Pro você obtém alguns recursos adicionais, como campo de repetidor, campo de galeria, blocos Gutenberg (veja mais adiante) e a possibilidade de usar o ACF para configurar seu próprio administrador personalizado páginas de opções. O ACF também é tão popular que você pode encontrar facilmente extensões de alta qualidade para qualquer coisa que o núcleo do ACF não cubra a si mesmo.

Campos personalizados avançados: a parte administrativa

Ao instalar o plugin Advanced Custom Fields, você receberá um novo menu de administração para “Custom Fields". É aqui que você pode configurar e configurar suas “meta boxes” ou grupos de configurações.

Dentro de um grupo, você pode configurar quantos campos desejar de diferentes tipos. Os mais comuns são entrada de texto, área de texto, editor richtext, arquivo, imagem, verdadeiro/falso (alternador), caixas de seleção, botões de opção e caixa de seleção. Outros comuns são várias maneiras de escolher postagens, escolher taxonomia, selecionar usuários, datepicker, colorpicker, Google Maps e muito, muito mais. Dependendo do tipo de campo escolhido, você obtém várias opções adicionais para personalizar o campo. Você também pode adicionar lógica condicional a qualquer campo. A lógica condicional serve para ocultar ou mostrar campos dependendo de outras opções dentro do grupo.

Para cada grupo de configurações você pode definir em quais casos essas configurações devem aparecer. Exemplos são ao editar postagens, um termo de taxonomia ou editar um usuário. Você pode personalizar ainda mais a visibilidade de suas configurações, por exemplo, tipo de postagem. Ou se uma postagem tiver um determinado termo ou modelo de página atribuído a ela, se uma postagem for de um determinado autor, se a função do usuário for assim ou assim, a função do usuário conectado no momento ou se a página for uma página pai ou não. Você também pode personalizar onde a caixa meta deve aparecer. No entanto, esta funcionalidade é um pouco reduzida agora com o novo editor Gutenberg.

Configurando um grupo

Configurações para um único campo

Campos personalizados avançados: a parte do código

Vamos dar uma olhada na parte mais interessante: como você pode utilizar campos personalizados avançados por código. Como mencionado anteriormente, o ACF é super amigável ao desenvolvedor e oferece uma ampla gama de personalização.

Obter valores e emiti-los em seus modelos é feito facilmente usando os métodos do ACF. Por exemplo the_field('your_meta_key'), para ecoá-lo diretamente ou get_field('your_meta_key')para armazená-lo em uma variável PHP. Forneça o ID do post como segundo argumento se precisar buscar dados fora do loop. Mole-mole. Você poderia usar get_post_meta(), mas é recomendável usar os métodos do ACF – pois o ACF pode transformar o valor em algo mais significativo antes de devolvê-lo a você.

Outra coisa que você deve estar ciente é a ferramenta de exportação dentro do ACF. Você pode exportar grupos criados em dois formatos; um arquivo JSON para download ou código PHP puro. O arquivo JSON é útil se você precisar exportar configurações entre servidores de teste e ativos ou outro WordPress. Exportar em PHP puro lhe dá a possibilidade de colá-lo diretamente em seu tema ou plugin de arquivos PHP.

Como você pode concluir disso; você pode usar o código PHP, escrevendo-o manualmente ou exportando-o depois de configurá-los no admin, para adicionar seus grupos e campos. Isso permite mais controle e formas de gerar escolhas personalizadas.

Mas espere, tem mais! O ACF também oferece uma ampla gama de ações e filtros para personalizar ainda mais os campos ou seus valores. Existem ganchos para salvar ou renderizar um campo, bem como ganchos para registrar grupos por código (mencionados acima), e filtros para personalizar os valores, configurações ou opções do campo antes de salvar ou renderizar. Você pode especificar ainda mais se o filtro deve afetar todos os campos, campos de um determinado tipo ou campos de uma determinada meta-chave. Todos os ganchos e filtros são prefixados com acf/.

Dê uma olhada na página de documentação do ACF ; clique em ‘Funções’, ‘Ações’ ou ‘Filtros’ para uma visão geral. Você encontrará ótimos tutoriais e guias neste site também.

Uma nota sobre campos personalizados avançados e Gutenberg

A criação de blocos personalizados do Gutenberg é, no momento, bastante assustadora. A documentação não está no lugar, as alterações ocorrem com frequência e requer um pouco de conhecimento de Javascript para codificar. De preferência, você precisa ter conhecimento de React e como configurar o compilador do JSX/ES6 com webpack e Babel.

No entanto, na versão 5.8, o ACF Pro introduziu um recurso para configurar um grupo de campos como um bloco Gutenberg – permitindo adicionar blocos personalizados puramente com código ACF e PHP. Nenhum conhecimento de Javascript é necessário!

Tudo o que você precisa fazer é configurar os grupos em admin ou por código, como de costume. Mas, em seguida, definindo sua localização como bloco de Gutenberg. Tudo o que resta é adicionar algum código PHP para registrá-los como um bloco Gutenberg personalizado com acf_register_block(). Para essa função você define um callback para uma função PHP ou arquivo de template que é responsável por renderizar a saída do bloco. Você escreve esta função ou parte do modelo totalmente em PHP e usa métodos familiares, como get_field()para obter os valores de configuração.

Como um bloco ACF se parece no editor Gutenberg

Fique ligado na categoria Advanced Custom Fields para tutoriais sobre como usar este plugin!