Visão geral

A API do Advanced Custom Field torna muito fácil a exibição de dados de campo no seu tema. Existem muitas funções disponíveis e todas estão bem documentadas na página de recursos.

The Basics

Após ter criado um grupo de campos e introduzido alguns dados, pode agora carregar e mostrar os dados no seu tema.

Todos os valores são guardados como post_meta nativo (quando guardados num post) e embora possa utilizar a função WP nativa get_post_meta(), é melhor prática utilizar a função ACF relevante, tal como get_field(). Porquê? Porque ACF irá formatar o valor dependendo do tipo de campo e tornar o desenvolvimento mais rápido e fácil!

Para recuperar um valor de campo como uma variável, use a função get_field(). Esta é a função mais versátil que sempre retornará um valor para qualquer tipo de campo.

Para exibir um campo, use a função get_field() de uma maneira similar.

Aqui está um exemplo de uso básico, e por favor tenha certeza de ver a página de exemplo de código para mais.

<?php/** * Template Name: Home Page */get_header(); ?><div><div role="main"><?php while ( have_posts() ) : the_post(); ?><h1><?php the_field('custom_title'); ?></h1><img src="<?php the_field('hero_image'); ?>" /><p><?php the_content(); ?></p><?php endwhile; // end of the loop. ?></div><!-- #content --></div><!-- #primary --><?php get_footer(); ?>

A ACF tem um Shortcode?

Sim, você pode usá-lo da mesma forma que a função_field(). Parece algo assim:

Você também pode especificar o $post_id para ir buscar o valor de.