Как добавить собственные типы табличных данных в WordPress

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

Причины создания собственных таблиц в WordPress

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

• Оптимизировать запросы за счет четкой структуры данных.
• Соблюдать нормализацию базы данных.
• Упрощать поддержку и масштабирование приложения.
• Использовать сложные связи и индексы.

Как создать собственную таблицу через плагин

Для создания таблицы нужно использовать функцию dbDelta из WordPress, которая обновляет структуру таблиц, не удаляя данные. Обычно создание таблиц происходит при активации плагина.

function wpcodex_create_custom_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'wpcodex_custom_data';
    $charset_collate = $wpdb->get_charset_collate();

    $sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        user_id bigint(20) UNSIGNED NOT NULL,
        data_value varchar(255) NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY  (id),
        KEY user_id (user_id)
    ) $charset_collate;";

    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}
register_activation_hook( __FILE__, 'wpcodex_create_custom_table' );

В этом примере создаётся таблица wp_wpcodex_custom_data, где хранятся данные, связанные с пользователями.

Как работать с собственными таблицами: примеры запросов

Для работы с таблицами используйте объект $wpdb. Вот основные операции:

Добавление записи

function wpcodex_insert_custom_data( $user_id, $data_value ) {
    global $wpdb;
    $table_name = $wpdb->prefix . 'wpcodex_custom_data';

    $wpdb->insert(
        $table_name,
        [
            'user_id' => $user_id,
            'data_value' => $data_value,
            'created_at' => current_time('mysql')
        ],
        [
            '%d',
            '%s',
            '%s'
        ]
    );
}

Получение данных

function wpcodex_get_data_by_user( $user_id ) {
    global $wpdb;
    $table_name = $wpdb->prefix . 'wpcodex_custom_data';

    $results = $wpdb->get_results( $wpdb->prepare(
        "SELECT * FROM $table_name WHERE user_id = %d",
        $user_id
    ) );

    return $results;
}

Обновление записи

function wpcodex_update_custom_data( $id, $new_value ) {
    global $wpdb;
    $table_name = $wpdb->prefix . 'wpcodex_custom_data';

    $wpdb->update(
        $table_name,
        [ 'data_value' => $new_value ],
        [ 'id' => $id ],
        [ '%s' ],
        [ '%d' ]
    );
}

Удаление записи

function wpcodex_delete_custom_data( $id ) {
    global $wpdb;
    $table_name = $wpdb->prefix . 'wpcodex_custom_data';

    $wpdb->delete( $table_name, [ 'id' => $id ], [ '%d' ] );
}

Рекомендации по работе с таблицами и безопасность

При работе с собственными таблицами важно соблюдать следующие рекомендации:

• Всегда используйте подготовленные запросы через $wpdb->prepare(), чтобы избежать SQL-инъекций.
• Обязательно проверяйте и фильтруйте входящие данные.
• Используйте транзакции, если выполняете несколько связанных запросов (MySQL поддерживает транзакции для InnoDB).
• Добавляйте индексы для ускорения выборок по часто используемым полям.
• При изменении структуры таблиц используйте функцию dbDelta — она корректно обновляет схему без потери данных.

Пример интеграции с плагином WPCommunity

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

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

Как создавать REST API для собственных таблиц

Создадим простой REST API endpoint для получения данных из нашей таблицы:

add_action( 'rest_api_init', function () {
    register_rest_route( 'wpcodex/v1', '/custom-data/(?P<user_id>\d+)', [
        'methods' => 'GET',
        'callback' => 'wpcodex_get_custom_data_api',
        'permission_callback' => '__return_true',
    ] );
} );

function wpcodex_get_custom_data_api( $request ) {
    $user_id = (int) $request['user_id'];
    $data = wpcodex_get_data_by_user( $user_id );

    if ( empty( $data ) ) {
        return new WP_Error( 'no_data', 'Данные не найдены', [ 'status' => 404 ] );
    }

    return rest_ensure_response( $data );
}

Этот код регистрирует маршрут /wp-json/wpcodex/v1/custom-data/{user_id}, который возвращает записи из нашей таблицы для указанного пользователя.

Заключение

Добавление собственных типов табличных данных в WordPress позволяет создавать более гибкие и производительные решения, особенно для сложных и объемных данных. Использование dbDelta для создания и обновления таблиц, а также аккуратная работа с $wpdb обеспечивают безопасность и стабильность. С помощью REST API можно организовать удобный доступ к этим данным из разных частей сайта или внешних приложений.

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