Advanced Custom Fields (ACF) – популярный плагин WordPress, который позволяет разработчикам легко добавлять настраиваемые поля в записи, страницы и другие типы контента. Получение значений полей — обычная задача при работе с ACF, и для этого существует несколько методов. В этой статье мы рассмотрим десять различных методов вместе с примерами кода, которые помогут вам получить значения полей с помощью ACF в WordPress.

Метод 1: использование get_field()
Самый простой и простой метод — использовать функцию get_field(), предоставляемую ACF. Он принимает имя поля в качестве параметра и возвращает значение поля. Вот пример:

$field_value = get_field('field_name');

Метод 2: использование get_field_object()
Если вам нужна дополнительная информация о поле, например тип или метка поля, вы можете использовать функцию get_field_object(). Он возвращает массив, содержащий все свойства поля. Вот пример:

$field = get_field_object('field_name');
$field_value = $field['value'];

Метод 3: использование the_field()
Функция the_field()аналогична get_field(), но она автоматически отображает значение поля, а не возвращает его. Этот метод полезен, если вы хотите напрямую вывести значение поля. Вот пример:

the_field('field_name');

Метод 4: использование get_sub_field()
ACF также обеспечивает поддержку полей-повторителей, которые позволяют создавать набор подполей, которые могут повторяться. Чтобы получить значение подполя в повторителе, вы можете использовать функцию get_sub_field(). Вот пример:

$sub_field_value = get_sub_field('sub_field_name');

Метод 5: использование have_rows() и the_row()
При работе с полями повторителя вы можете использовать функции have_rows()и the_row()для циклического обхода повторителя. строки и получить значения полей. Вот пример:

if (have_rows('repeater_field_name')) {
    while (have_rows('repeater_field_name')) {
        the_row();
        $sub_field_value = get_sub_field('sub_field_name');
        // Process the sub-field value
    }
}

Метод 6: использование get_fields()
Если вы хотите получить все значения полей для определенного сообщения или страницы, вы можете использовать функцию get_fields(). Он возвращает массив, содержащий все значения полей. Вот пример:

$fields = get_fields();

Метод 7: использование get_post_meta()
Внутри ACF сохраняет значения полей как метаданные публикации. Таким образом, вы также можете использовать функцию get_post_meta()для прямого получения значений полей. Вот пример:

$field_value = get_post_meta(get_the_ID(), 'field_name', true);

Метод 8: использование WP_Query()
Если вам нужно получить значения полей при запросе сообщений или страниц, вы можете использовать WP_Query()в сочетании с параметрами метазапроса ACF. Вот пример:

$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        array(
            'key' => 'field_name',
            'value' => 'field_value',
            'compare' => '='
        )
    )
);
$query = new WP_Query($args);

Метод 9: использование get_query_var()
Если вы хотите получить значения полей из строки запроса URL-адреса, вы можете использовать функцию get_query_var(). Вот пример:

$field_value = get_query_var('field_name');

Метод 10: использование ACF REST API
Если вы работаете с автономным WordPress или вам необходимо получить значения полей с помощью API, вы можете использовать конечные точки ACF REST API. Вот пример:

GET /wp-json/acf/v3/posts/{post_id}/field/field_name

Получение значений полей с помощью ACF в WordPress можно выполнить различными способами, в зависимости от ваших конкретных требований. В этой статье мы рассмотрели десять различных методов, включая использование функций ACF, мета-извлечение сообщений, запросы и конечные точки REST API. Благодаря этим методам и примерам кода вы сможете эффективно получать значения полей в своих проектах WordPress на базе ACF.