wpsocial.ru wordpress WPSocial

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

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

На практике есть два рабочих сценария. Первый — быстрое добавление данных через стандартные custom fields в редакторе. Второй — когда нужен аккуратный интерфейс для редакторов и стабильный вывод на сайте. Для второго сценария плагин не обязателен: достаточно нескольких строк в файле темы или дочерней темы.

Что такое собственные поля в WordPress

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

Это удобно, когда у контента есть дополнительный атрибут, который не должен быть частью основного текста. Например, у статьи может быть поле source_url, у страницы услуги — service_price, у анонса мероприятия — event_date.

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

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

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

Дальше логика простая:

  • введите имя поля, например subtitle;
  • укажите значение, например Краткое описание для страницы;
  • сохраните запись или страницу.

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

Как вывести собственное поле в шаблоне темы

Чтобы показать значение на фронтенде, в нужном шаблоне темы используйте функцию get_post_meta(). Она возвращает значение поля по ключу для текущей записи или страницы.

Если нужно вывести, например, подзаголовок записи, вставьте в шаблон такой код:

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

if ( $subtitle ) {
    echo '<p class="post-subtitle">' . esc_html( $subtitle ) . '</p>';
}
?>

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

Код вставляют в шаблон, который отвечает за вывод нужного типа контента: single.php, page.php, шаблон записи в блочной теме или отдельный шаблон части. Если вы редактируете тему, лучше делать это в дочерней теме, иначе обновление может затереть изменения.

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

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

Ниже пример метабокса для поля «Подзаголовок». Его можно добавить в файл functions.php дочерней темы или в собственный мини-плагин, если вы всё же предпочитаете выносить код из темы. Для задачи статьи достаточно варианта в теме.

<?php
add_action( 'add_meta_boxes', function () {
    add_meta_box(
        'post_subtitle_box',
        'Подзаголовок',
        function ( $post ) {
            $value = get_post_meta( $post->ID, 'subtitle', true );
            wp_nonce_field( 'save_post_subtitle', 'post_subtitle_nonce' );
            echo '<p><label for="post_subtitle">Текст подзаголовка</label></p>';
            echo '<input type="text" id="post_subtitle" name="post_subtitle" value="' . esc_attr( $value ) . '" style="width:100%;" />';
        },
        [ 'post', 'page' ],
        'normal',
        'default'
    );
} );

add_action( 'save_post', function ( $post_id ) {
    if ( ! isset( $_POST['post_subtitle_nonce'] ) || ! wp_verify_nonce( $_POST['post_subtitle_nonce'], 'save_post_subtitle' ) ) {
        return;
    }

    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }

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

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

Этот код делает три вещи: добавляет поле в админке, защищает сохранение nonce-проверкой и записывает значение в метаданные записи. Для текстового поля достаточно sanitize_text_field(). Если вы храните URL, используйте esc_url_raw(); если число — приводите к нужному типу явно.

Как не сломать сайт при добавлении кода

Любой код в functions.php влияет на работу сайта сразу после сохранения. Если допустить синтаксическую ошибку, можно получить белый экран или ошибку PHP. Поэтому перед правками сделайте резервную копию файла или работайте через дочернюю тему и файловый менеджер/FTP, где можно быстро откатить изменения.

Есть ещё один практический момент: не вставляйте код в файл активной темы, если тема обновляется разработчиком. После обновления изменения пропадут. Для собственных полей это особенно неприятно, потому что ломается и форма в админке, и вывод на сайте.

Если у вас блоковая тема, шаблон может редактироваться через редактор сайта, но PHP-код туда не вставляется. В этом случае логику метаполей всё равно нужно хранить в дочерней теме или отдельном коде, а вывод делать через шаблонные части или динамические блоки, если вы их используете.

Проверка результата после настройки

После добавления поля и кода проверьте не только саму запись, но и сохранение данных:

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

Если значение не показывается, сначала проверьте ключ поля. Ошибка в названии — самая частая причина. Например, если в админке поле называется subtitle, а в шаблоне вы запрашиваете subtitel, WordPress честно вернёт пустое значение.

Если поле сохраняется, но не выводится, проблема обычно в шаблоне: код вставлен не в тот файл, условие не срабатывает или значение выводится до цикла WordPress. Для текущей записи используйте get_the_ID() внутри цикла или передавайте ID явно.

Когда плагин всё же лучше кода

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

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

×

AI-плагин

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

SEO и мета-теги

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

Изображения

Комментарии

Подробнее