Avançar para conteúdo

Tudo para WordPress

Plugins, Temas, dicas de WordPress e muito mais para você que busca informação sobre este excelente CMS!

  • Twitter
  • Facebook
  • Google+
  • RSS
Entenda com funciona Assine nosso RSS

Advanced Custom Fields

Campos Personalizados para desenvolvedores, no nível mais profissional que você já viu.

Campo Relacional

Publicado em 23/03/2015 às 16h18 por Guga Alves

O Campo Relacional é uma versão bem atrativa do campo de objetos. Com o Campo Relacional, você pode selecionar itens relacionados a uma página / posts / custom post types. É uma ótima forma de parar de usar plugins para posts relacionados, que nunca relacionam com precisão, e deixar seus usuários fazerem este relação manualmente, se preocupando apenas com o front-end.

acf-campo-relacional
acf-campo-relacional-2

Campos adicionais deste tipo de campo

  • Formato dos dados: Especifique a forma com os valores serão retornados no front-end
  • Tipo de Post: Selecione os post types que devem aparecer para serem escolhidos;
  • Filtro de Taxonomia: Você pode filtrar algumas taxonomias / categorias caso seja necessário;
  • Filtros: Permite adicionar um campo de busca e filtros a serem marcados pelos usuários.
  • Elementos: Quais elementos irão aparecer no resultado dos boxes de seleção.
  • Posts máximos: Quantidade máxima de posts permitidos. Caso você não preencha um valor máximo, o usuário poderá selecionar quantos posts quiser.

Como utilizar este campo em um template WP?

A API irá retornar um array de objetos de posts da mesma forma que a função get_posts faria, ou seus IDs, dependendo da escolha do Formato de Dados.

Loop básico (com setup_postdata)

Este exemplo mostra como carregar os posts selecionados no campo relacional e os exibir em uma lista. Este exemplo utiliza a função setup_postdata, que sobrescreve o objeto da variável global $post e permite que funções como the_title possam ser usadas. Vale lembrar que ao usar esta função, você deve resetar a $post depois para poder voltar a utilizar normalmente. Veja mais sobre isso em http://codex.wordpress.org/Template_Tags/get_posts#Reset_after_Postlists_with_offset

Loop básico (sem setup_postdata)

Vejamos como fazer o mesmo do exemplo anterior, mas sem usar a função setup_postdata para sobrescrever a global $post.

Utilizando o WP_Query

Como vimos nas opções, é possível ter como retorno apenas o IDs de posts, ao invés do objeto de post. Com isso, você utilizar os ID’s em um WP_Query, com argumentos adicionais. Você pode ler mais sobre parâmetros do WP_Query na documentação oficial, em http://codex.wordpress.org/Class_Reference/WP_Query#Parameters.

Note que o get_field possui dos argumentos após o campo, com o valor ‘false’ sendo passado. O primeiro é para informar que o $post_id neste caso é irrelevante, e o segundo diz para o ACF não formatar o valor, retornando da forma que está salva no banco, um array de IDs.

Seja o primeiro a comentar este artigo

Participe e deixe o seu comentário!

Procurando Temas?

Acesse o arquivo de Temas WordPress