Работа с метаданными в WordPress: примеры, плагины, код

Автор: Георгий Карпов | Опубликовано: 14.11.2025

Что такое метаданные в WordPress и зачем они нужны

Метаданные в WordPress — это дополнительные данные, которые хранятся вместе с постами, страницами, пользователями или другими типами контента. Они позволяют расширить функциональность сайта, добавлять произвольные поля и сохранять важную информацию, которая не помещается в стандартные поля WordPress (заголовок, контент, дата и т.п.).

Например, если у вас интернет-магазин на WordPress, вы можете использовать метаданные для хранения цены товара, цвета, размера и других характеристик. Для блогов это могут быть рейтинги, авторские заметки или дополнительные теги.

Метаданные бывают разных типов: post meta (метаданные записи), user meta (метаданные пользователя), comment meta (метаданные комментария) и term meta (метаданные таксономии). В этой статье мы подробно разберём работу с метаданными записей, так как это самый часто используемый тип.

Основные функции для работы с метаданными записей

WordPress предоставляет простой и мощный API для работы с метаданными записи:

update_post_meta($post_id, $meta_key, $meta_value, $prev_value = '') — добавляет или обновляет метаданные записи;
get_post_meta($post_id, $meta_key = '', $single = false) — получает метаданные по ключу;
delete_post_meta($post_id, $meta_key, $meta_value = '') — удаляет метаданные по ключу и значению.

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

Пример добавления и получения метаданных

Представим, что мы хотим добавить к записи метаданные «rating» (рейтинг статьи) и вывести их на странице.

function wpwp_update_post_rating($post_id, $rating) {
    update_post_meta($post_id, 'wpwp_rating', $rating);
}

function wpwp_get_post_rating($post_id) {
    return get_post_meta($post_id, 'wpwp_rating', true);
}

Теперь можно вызвать wpwp_update_post_rating(123, 5) для сохранения рейтинга 5 для записи с ID 123, а затем получить его вызовом wpwp_get_post_rating(123).

Добавление пользовательских полей в админку WordPress

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

Для этого нужно использовать хуки add_meta_box и сохранить данные через save_post.

Пример создания метабокса с полем рейтинга

function wpwp_add_rating_metabox() {
    add_meta_box(
        'wpwp_rating_box',
        'Рейтинг статьи',
        'wpwp_rating_metabox_html',
        'post',
        'side',
        'default'
    );
}
add_action('add_meta_boxes', 'wpwp_add_rating_metabox');

function wpwp_rating_metabox_html($post) {
    $value = get_post_meta($post->ID, 'wpwp_rating', true);
    wp_nonce_field('wpwp_rating_nonce', 'wpwp_rating_nonce_field');
    echo '<label for="wpwp_rating_field">Введите рейтинг (1-5): </label>';
    echo '<input type="number" id="wpwp_rating_field" name="wpwp_rating_field" value="' . esc_attr($value) . '" min="1" max="5" />';
}

function wpwp_save_rating_metabox($post_id) {
    if (!isset($_POST['wpwp_rating_nonce_field']) || !wp_verify_nonce($_POST['wpwp_rating_nonce_field'], 'wpwp_rating_nonce')) {
        return;
    }
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }
    if (isset($_POST['wpwp_rating_field'])) {
        $rating = intval($_POST['wpwp_rating_field']);
        update_post_meta($post_id, 'wpwp_rating', $rating);
    }
}
add_action('save_post', 'wpwp_save_rating_metabox');

Этот код добавляет в редактор поста боковую панель с полем для ввода рейтинга от 1 до 5. При сохранении записи рейтинг сохраняется в метаданные.

Использование плагинов для работы с метаданными

Если хочется упростить создание и управление метаданными, можно использовать готовые плагины. Вот несколько популярных вариантов:

Advanced Custom Fields (ACF) — самый популярный плагин для создания произвольных полей и метаданных с удобным интерфейсом и множеством типов полей.
Meta Box — мощный инструмент для создания метабоксов и произвольных полей, поддерживает много расширений.
Pods — плагин для создания собственных типов данных и метаданных с возможностью расширения функционала.

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

Пример вывода метаданных, добавленных через ACF

Если вы создали поле с ключом wpwp_rating в ACF, вывести его значение в шаблоне можно так:

if (function_exists('get_field')) {
    $rating = get_field('wpwp_rating');
    if ($rating) {
        echo 'Рейтинг статьи: ' . esc_html($rating);
    }
}

Оптимизация и безопасность при работе с метаданными

При работе с метаданными важно помнить несколько правил:

Безопасность данных. Всегда проверяйте nonce и права пользователя перед сохранением метаданных, чтобы избежать CSRF и несанкционированных изменений.
Типы данных. Приводите данные к нужным типам (int, string), чтобы избежать ошибок и уязвимостей.
Оптимизация запросов. Используйте get_post_meta с параметром $single = true, если ожидается одно значение, чтобы снизить нагрузку на базу.
Кэширование. При большом количестве метаданных стоит использовать кэширование, например, Transients API, чтобы ускорить вывод.

Кроме того, не храните в метаданных слишком большие объёмы данных — для этого лучше использовать отдельные таблицы или сторонние сервисы.

Заключение: зачем изучать работу с метаданными на WordPress

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

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

Работа с метаданными в WordPress: практическое руководство