Campo Relacional

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.

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 https://codex.wordpress.org/Template_Tags/get_posts#Reset_after_Postlists_with_offset

<?php 

$posts = get_field('relacao-posts');

if( $posts ): ?>
    <ul>
    <?php foreach( $posts as $post): ?>
        <?php setup_postdata($post); ?>
        <li>
            <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
            <span>Custom field from $post: <?php the_field('author'); ?></span>
        </li>
    <?php endforeach; ?>
    </ul>
    <?php wp_reset_postdata(); ?>
<?php endif; ?>

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.

<?php 

$posts = get_field('relacao-posts');

if( $posts ): ?>
	<ul>
	<?php foreach( $posts as $p ): // variable must NOT be called $post (IMPORTANT) ?>
	    <li>
	    	<a href="<?php echo get_permalink( $p->ID ); ?>"><?php echo get_the_title( $p->ID ); ?></a>
	    	<span>Custom field from $post: <?php the_field('author', $p->ID); ?></span>
	    </li>
	<?php endforeach; ?>
	</ul>
<?php endif; ?>

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 https://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.

<?php 

// get only first 3 results
$ids = get_field('relacao-posts', false, false);

$query = new WP_Query(array(
	'post_type'      	=> 'conferences',
	'posts_per_page'	=> 3,
	'post__in'		=> $ids,
	'post_status'		=> 'any',
	'orderby'        	=> 'rand',
));

?>