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