Обзор
API Advanced Custom Field позволяет легко вывести значения полей на в вашей теме. Есть множество функций для работы со значениями. Они описаны в документации.
Основы
После создания группы полей их можно вывести на сайте.
Все значения хранятся через встроенные post_meta (когда сохраняется пост) и конечно можно использовать встроенную WP функцию get_post_meta() для вывода данных, но будет лучше использовать ACF функцию get_field()
для вывода. Почему? Потому, что ACF формирует значения в зависимости от типов полей и делает разработку проще!
Для присвоения значения поля переменной используйте функцию get_field(). Это очень гибкая функция, которая позволяет вернуть значение любого типа.
Если нужно сразу вывести значение, то используйте функцию the_field().
Это базовый пример использования. Больше информации можно найти в примерах кода.
<?php
/**
* Template Name: Home Page
*/
get_header();
?>
<div id="primary">
<div id="content" 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; ?>
</div><!-- #content -->
</div><!-- #primary -->
<?php get_footer(); ?>
Есть ли у ACF шорткоды?
Да, Вы, можете использовать шорткоды. Например, выведем the_field() с помощью шорткода:
[acf field="{$field_name}"]
Вы можете также передать $post_id для получения значения из определенной записи.
[acf field="{$field_name}" post_id="{$post_id}"]