Создание кастомного метабокса в WordPress: пошаговое руководство

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

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

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

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

Создаем кастомный метабокс вручную с помощью PHP

Регистрация метабокса с помощью хука add_meta_boxes

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

function wpcodes_add_custom_metabox() {
    add_meta_box(
        'wpcodes_custom_metabox',
        'Дополнительная информация',
        'wpcodes_custom_metabox_callback',
        'post',
        'normal',
        'high'
    );
}
add_action('add_meta_boxes', 'wpcodes_add_custom_metabox');

Здесь 'post' — тип записи, к которому добавляется метабокс. Вы можете заменить на 'page' или кастомный тип записи.

Вывод формы метабокса

Функция обратного вызова wpcodes_custom_metabox_callback отвечает за вывод HTML формы внутри метабокса.

function wpcodes_custom_metabox_callback($post) {
    // Добавляем nonce для безопасности
    wp_nonce_field('wpcodes_save_metabox_data', 'wpcodes_metabox_nonce');

    $value = get_post_meta($post->ID, '_wpcodes_custom_field', true);

    echo '<label for="wpcodes_custom_field">Введите дополнительную информацию:</label>';
    echo '<input type="text" id="wpcodes_custom_field" name="wpcodes_custom_field" value="' . esc_attr($value) . '" size="25" />';
}

Здесь мы получаем сохранённое мета-значение и выводим поле ввода с этим значением.

Сохранение данных метабокса

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

function wpcodes_save_metabox_data($post_id) {
    // Проверяем nonce
    if (!isset($_POST['wpcodes_metabox_nonce']) || !wp_verify_nonce($_POST['wpcodes_metabox_nonce'], 'wpcodes_save_metabox_data')) {
        return;
    }

    // Проверяем автосохранение
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }

    // Проверяем права пользователя
    if (!current_user_can('edit_post', $post_id)) {
        return;
    }

    if (!isset($_POST['wpcodes_custom_field'])) {
        return;
    }

    $my_data = sanitize_text_field($_POST['wpcodes_custom_field']);

    update_post_meta($post_id, '_wpcodes_custom_field', $my_data);
}
add_action('save_post', 'wpcodes_save_metabox_data');

Таким образом мы защитили сохранение данных, проверили права и безопасно записали значение в метаполя записи.

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

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

Advanced Custom Fields (ACF)

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

Чтобы добавить метабокс, достаточно:

• Установить и активировать плагин ACF
• Создать новое поле через интерфейс плагина
• Привязать группу полей к нужному типу записи

Для вывода данных в шаблоне сайта используется функция get_field('field_name'):

<?php
$info = get_field('additional_info');
echo esc_html($info);
?>

Meta Box

Meta Box — ещё один мощный плагин с большими возможностями и расширениями. Он позволяет создавать метабоксы и настраивать поля через интерфейс или код.

Пример создания метабокса через код с использованием Meta Box:

add_filter('rwmb_meta_boxes', 'wpcodes_register_meta_boxes');
function wpcodes_register_meta_boxes($meta_boxes) {
    $meta_boxes[] = [
        'title'      => 'Дополнительная информация',
        'post_types' => ['post'],
        'fields'     => [
            [
                'id'   => 'wpcodes_custom_field',
                'name' => 'Дополнительная информация',
                'type' => 'text',
            ],
        ],
    ];
    return $meta_boxes;
}

После этого метабокс появится на странице редактирования записи, а данные легко получить через API плагина.

Советы по безопасности и удобству при работе с метабоксами

При создании кастомных метабоксов важно учитывать безопасность — обязательно используйте nonce и проверяйте права пользователя. Это защитит сайт от CSRF-атак и несанкционированного изменения данных.

Также не забывайте очищать и валидировать данные перед сохранением. Для текстовых полей отлично подходит функция sanitize_text_field(), для URL — esc_url_raw(), для чисел — intval() и т.д.

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

Заключение

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

В статье рассмотрены подробные примеры, которые помогут вам быстро начать работу с метабоксами и сделать ваш проект гибким и удобным.