Як створити таблицю в WordPress через functions.php: Повний гід по типам даних MySQL

Іноді стандартних можливостей WordPress (постів та мета-полів) недостатньо для складних проєктів. У таких випадках створення власної таблиці в базі даних — це найефективніший шлях для оптимізації швидкості та структури сайту.

1. Еталонний код для створення таблиці

Для роботи з базою даних ми використовуємо функцію dbDelta. Її головна перевага — розумне оновлення: якщо таблиця вже існує, вона не створить її заново, а лише оновить структуру (наприклад, якщо ви додасте нову колонку пізніше).

Додайте цей код у файл functions.php вашої теми:

function create_custom_table() {
    global $wpdb;

    // Назва таблиці з урахуванням префікса (наприклад, wp_custom_table)
    $table_name = $wpdb->prefix . 'custom_table'; 

    // Отримуємо кодування сайту (зазвичай utf8mb4)
    $charset_collate = $wpdb->get_charset_collate();

    $sql = "CREATE TABLE $table_name (
        id INT NOT NULL AUTO_INCREMENT,
        column_name1 VARCHAR(255) NOT NULL,
        column_name2 TEXT NOT NULL,
        column_name3 INT DEFAULT 0,
        PRIMARY KEY  (id)
    ) $charset_collate;";

    // Підключаємо необхідний файл для роботи dbDelta
    require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);
}

// Запускаємо функцію при налаштуванні теми
add_action('after_setup_theme', 'create_custom_table');

2. Основні типи даних MySQL

Щоб ваша таблиця працювала швидко і не займала зайвого місця, важливо правильно обрати тип даних для кожної колонки.

Числові типи

Рядкові типи (Текст)

Дата та час

3. Важливі правила синтаксису dbDelta

Функція dbDelta дуже вибаглива до оформлення SQL-запиту. Якщо ігнорувати ці правила, таблиця не створиться:

1. Два пробіли: Між словами PRIMARY KEY та визначенням ключа (id) має бути рівно два пробіли.

2. Великі літери: Усі команди SQL (CREATE TABLE, NOT NULL, INT) краще писати великими літерами.

3. Довжина VARCHAR: Ви обов’язково повинні вказати довжину для VARCHAR, наприклад VARCHAR(255).

Як перевірити результат?

Після збереження файлу functions.php просто оновіть будь-яку сторінку вашого сайту. Після цього зайдіть у phpMyAdmin. У списку таблиць вашої бази даних має з’явитися нова позиція: wp_custom_table.