wpboot.ru wordpress WPBoot

Как добавить произвольные поля к записям WordPress и вывести их на сайте

Произвольные поля в WordPress нужны, когда к записи нужно привязать не только заголовок и текст, но и дополнительную информацию: цену, автора материала, дату события, ссылку на источник, номер телефона, рейтинг, координаты и так далее. Это обычный способ хранить структурированные данные рядом с записью и потом выводить их в шаблоне темы или в блоке.

Если задача простая, можно обойтись встроенным интерфейсом WordPress. Если нужен более удобный редактор полей, лучше использовать плагин или зарегистрировать метабокс вручную. Ниже разберу оба подхода и покажу, как безопасно вывести значение на сайте.

Что такое произвольные поля и когда они действительно нужны

Произвольное поле в WordPress — это пара «ключ-значение», привязанная к записи, странице, пользовательскому типу записи или другому объекту. Ключ — это имя поля, например price или event_date. Значение — конкретные данные, которые вы хотите хранить.

Использовать их стоит, когда информация повторяется от записи к записи и должна выводиться в одном и том же месте шаблона. Например, для карточки товара или статьи-обзора удобно хранить отдельные поля для цены, бренда, ссылки на внешний ресурс, даты публикации события. Если же данные неструктурированные и меняются от случая к случаю, лучше не превращать произвольные поля в свалку метаданных.

Важно понимать разницу между произвольными полями и содержимым записи. Текст статьи редактируется в основном контенте, а произвольные поля — это служебные данные, которые тема или блок использует для вывода дополнительного фрагмента.

Как добавить произвольные поля в редакторе WordPress

В WordPress есть встроенная возможность работать с custom fields, но в новых версиях она не всегда видна по умолчанию в интерфейсе блокового редактора. Сначала нужно включить соответствующую панель.

Откройте нужную запись в редакторе Gutenberg, нажмите меню с тремя точками в правом верхнем углу, затем выберите настройки и включите панель Произвольные поля. После этого внизу редактора появится блок для добавления нового поля.

Дальше всё просто: укажите имя поля и значение, сохраните запись и обновите страницу. WordPress запишет это значение в метаданные записи.

Этот способ подходит для разовых задач и для проверки механики. Но если полей несколько и ими будут пользоваться редакторы, удобнее сделать отдельный интерфейс: метабокс в админке или плагин для полей.

Как вывести значение произвольного поля в шаблоне темы

Чтобы показать значение на сайте, в шаблоне WordPress используют функцию get_post_meta(). Она получает значение метаполя по ID записи и ключу поля. Если поле должно выводиться в карточке записи, обычно правят файл шаблона темы: single.php, content-single.php, шаблон записи в дочерней теме или шаблон части блока, если тема на блоках.

Перед изменением файлов темы сделайте резервную копию или работайте в дочерней теме. Иначе обновление темы может затереть правки.

Пример вывода значения поля price внутри цикла записи:

<?php
$price = get_post_meta( get_the_ID(), 'price', true );

if ( $price !== '' ) :
    echo '<p class="post-price">Цена: ' . esc_html( $price ) . '</p>';
endif;
?>

Здесь третий параметр true нужен, чтобы получить одно значение, а не массив. Функция esc_html() обязательна, если вы выводите текст или число в HTML. Она защищает от случайной вставки опасного кода и просто корректно экранирует вывод.

Если значение должно быть ссылкой, используйте подходящую функцию экранирования для URL:

<?php
$link = get_post_meta( get_the_ID(), 'source_url', true );

if ( $link ) :
    echo '<p><a href="' . esc_url( $link ) . '" rel="nofollow noopener" target="_blank">Источник</a></p>';
endif;
?>

Для чисел и дат лучше не доверять строке как есть. Если поле хранит цену, приводите значение к нужному формату уже перед выводом. Если это дата, заранее решите, в каком виде она хранится: 2026-10-21, timestamp или человекочитаемая строка. От этого зависит дальнейшая обработка.

Как сделать удобный интерфейс для редактирования полей

Встроенный блок произвольных полей подходит не всем. Он технический, не очень удобный для редакторов и не даёт нормальной валидации. В практическом проекте чаще делают метабокс через add_meta_box() и сохраняют данные через save_post.

Ниже минимальный рабочий пример для поля price. Его можно добавить в файл functions.php дочерней темы или в собственный плагин. Такой вариант удобен, если вы хотите контролировать структуру данных без установки отдельного плагина.

<?php
add_action( 'add_meta_boxes', function () {
    add_meta_box(
        'post_price_box',
        'Цена записи',
        function ( $post ) {
            $value = get_post_meta( $post->ID, 'price', true );
            wp_nonce_field( 'save_post_price', 'post_price_nonce' );
            echo '<p><label for="post_price">Цена</label></p>';
            echo '<input type="text" id="post_price" name="post_price" value="' . esc_attr( $value ) . '" style="width:100%;" />';
        },
        'post',
        'side',
        'default'
    );
} );

add_action( 'save_post', function ( $post_id ) {
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }

    if ( ! isset( $_POST['post_price_nonce'] ) || ! wp_verify_nonce( $_POST['post_price_nonce'], 'save_post_price' ) ) {
        return;
    }

    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

    if ( isset( $_POST['post_price'] ) ) {
        update_post_meta( $post_id, 'price', sanitize_text_field( wp_unslash( $_POST['post_price'] ) ) );
    }
} );

Здесь есть несколько важных моментов. wp_nonce_field() и wp_verify_nonce() защищают от подделки запроса. Проверка current_user_can() не даёт сохранить данные пользователю без прав. sanitize_text_field() очищает строку перед записью в базу. Это базовый минимум, который не стоит пропускать.

Если поле должно хранить только число, лучше сразу привести значение к нужному типу, например через floatval() или intval(), а не хранить произвольный текст.

Как вывести произвольное поле в блоке или шорткоде

Не всегда удобно править шаблон темы. Если значение нужно вставлять в контент точечно, практичнее сделать шорткод. Тогда редактор сможет добавить его прямо в запись, а вывод останется централизованным.

Пример шорткода для вывода поля price текущей записи:

<?php
add_shortcode( 'post_price', function () {
    $price = get_post_meta( get_the_ID(), 'price', true );

    if ( $price === '' ) {
        return '';
    }

    return '<span class="post-price">' . esc_html( $price ) . '</span>';
} );

После этого в редакторе можно вставить [post_price]. Такой подход удобен, если один и тот же фрагмент нужно показывать в нескольких местах без правки шаблона.

Если вы работаете с блоковой темой, можно пойти дальше и собрать динамический блок, который читает метаполе через серверный рендер. Но для большинства проектов шорткода достаточно: он проще в поддержке и не требует отдельной сборки фронтенда.

Как проверить, что всё работает

После сохранения записи проверьте три вещи.

  • Поле действительно сохранилось в админке после обновления записи.
  • На странице записи выводится нужное значение, а не пустой блок.
  • Если поле пустое, шаблон не ломается и не показывает мусор вроде лишних заголовков или двоеточий.

Если значение не отображается, обычно проблема в одном из трёх мест: неверный ключ поля, вывод не в том шаблоне, где вы ожидаете, или запись сохраняется не через тот объект, для которого вы читаете метаданные. Например, в архиве и на одиночной записи могут использоваться разные шаблоны.

Ещё одна частая ошибка — вывод без экранирования. Даже если поле заполняет только администратор, безопаснее всегда использовать esc_html(), esc_attr() или esc_url() в зависимости от типа данных.

Что выбрать на практике: встроенные поля, метабокс или плагин

СпособКогда подходитПлюсыМинусы
Встроенные произвольные поляБыстрая проверка, разовая задачаНе нужно ничего ставитьНеудобный интерфейс, слабая валидация
Метабокс в теме или плагинеНужен контроль над полями и выводомГибко, можно настроить права и формат данныхНужно писать код и поддерживать его
Плагин для полейМного полей, редакторы без технического опытаУдобная админка, меньше ручной разработкиЗависимость от плагина и его обновлений

Если проект небольшой и полей немного, я бы начинал с метабокса или даже с встроенных custom fields для прототипа. Если сайт живой, с редакторами и повторяющимися типами контента, лучше сразу продумать структуру полей и способ их вывода в шаблоне. Тогда данные не расползутся по записи и их будет проще поддерживать.

Произвольные поля в WordPress — это не «дополнительная фишка», а нормальный инструмент для структурированных данных. Если сразу определить ключи, типы значений и место вывода, дальше всё работает предсказуемо: редактор заполняет поле, шаблон или шорткод читает его и показывает на сайте без ручной правки каждой записи.

×

AI-плагин

WPGPT
Сам создает статьи для вашего сайта WordPress

SEO и мета-теги

Парсинг конкурентов

Изображения

Комментарии

Подробнее