УРОК · WordPress: темы и плагины

Данные WordPress и граница темы

Опубликовано Автор: Соловьёва Мария Андреевна

После PHP и MariaDB создадим отдельный учебный WordPress. Заметки и темы появятся в его собственной базе, а рабочий сайт останется вне опыта.

Разберём по шагам

Тип записи задаёт вид материала, здесь lab_note. Таксономия lab_topic группирует заметки по темам; отдельная таблица для этого упражнения не нужна. Функциональность помещаем в плагин, чтобы смена оформления не убрала тип и таксономию. Работаем в Ubuntu 24.04 (на Windows подойдёт WSL), с PHP 8.3, MariaDB 10.11, WP-CLI 2.12.0 и WordPress 7.1.2. Это новая локальная установка с базой notes_wp_lab, а не опубликованный WordPress сайта.

Слова, которые пригодятся

WP-CLI
Командный инструмент WordPress: создаёт установку и управляет записями из терминала без переходов по админке.
Тип записи
Правило для вида материалов в WordPress. lab_note сообщает системе, что учебная заметка отличается от обычной записи блога.
Таксономия
Правило группировки материалов. Значение Backend объединит заметки с этой темой.
Плагин
Отдельный PHP-код для поведения сайта. После смены темы его функции продолжают работать.
Тема
Файлы внешнего вида страниц WordPress; в этом курсе они не регистрируют данные заметок.

show_in_rest позволит редактору WordPress видеть новый тип и таксономию. public делает учебные заметки доступными посетителю, поэтому здесь не храните личные данные.

Команды для базы создают отдельный локальный каталог данных. Пароль администратора WordPress нужен только для входа в учебный сайт; в файлах урока и отчёте его нет.

Рабочий пример

<?php
/**
 * Plugin Name: FSL Lab Notes
 * Version: 1.0.0
 */
add_action('init', function () {
    register_post_type('lab_note', [
        'label' => 'Заметки лаборатории',
        'public' => true,
        'show_in_rest' => true,
        'supports' => ['title', 'editor', 'author'],
        'has_archive' => true,
        'rewrite' => ['slug' => 'lab-notes'],
    ]);
    register_taxonomy('lab_topic', 'lab_note', [
        'label' => 'Темы заметок',
        'public' => true,
        'show_in_rest' => true,
    ]);
});

Практика

Создайте отдельный сайт и получите первую заметку через WP-CLI. Эти данные будут основой формы, шаблона и API следующих уроков.

  1. В терминале Ubuntu проверьте php -v и mariadb --version. Если пакетов нет, выполните sudo apt update и sudo apt install php8.3-cli php8.3-mysql php8.3-curl php8.3-mbstring php8.3-xml php8.3-zip mariadb-server curl unzip. Запустите MariaDB командой sudo service mariadb start. Для этого курса не подключайтесь к базе рабочего сайта.
  2. В домашней папке Ubuntu выполните curl -fL https://github.com/wp-cli/wp-cli/releases/download/v2.12.0/wp-cli-2.12.0.phar -o ~/wp-cli-2.12.0.phar, затем sha256sum ~/wp-cli-2.12.0.phar. Ожидаемый SHA-256: ce34ddd838f7351d6759068d09793f26755463b4a4610a5a5c0a97b68220d85c; при несовпадении файл не запускайте. php ~/wp-cli-2.12.0.phar --version должен показать WP-CLI 2.12.0.
  3. Выполните whoami и запомните имя пользователя Ubuntu. Откройте sudo mariadb и по очереди выполните SQL-команды CREATE DATABASE notes_wp_lab CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;, CREATE USER 'ИМЯ_ИЗ_WHOAMI'@'localhost' IDENTIFIED VIA unix_socket; и GRANT ALL PRIVILEGES ON notes_wp_lab.* TO 'ИМЯ_ИЗ_WHOAMI'@'localhost';, заменив оба ИМЯ_ИЗ_WHOAMI своим именем. Команда exit закроет MariaDB. Такой локальный пользователь входит через сокет Ubuntu без пароля; не используйте этот способ как готовую схему для публичного сервера.
  4. Создайте отдельную папку командами mkdir ~/notes-wp-lab и cd ~/notes-wp-lab. Выполните php ../wp-cli-2.12.0.phar core download --version=7.1.2 --skip-content, затем php ../wp-cli-2.12.0.phar config create --dbname=notes_wp_lab --dbuser=ИМЯ_ИЗ_WHOAMI --dbpass= --dbhost=localhost с тем же именем пользователя. php ../wp-cli-2.12.0.phar db check должен закончиться Success: Database checked.
  5. Выполните php ../wp-cli-2.12.0.phar core install --url=http://127.0.0.1:8002 --title=Notes-WP-Lab --admin_user=labadmin --prompt=admin_password --admin_email=lab@example.invalid --skip-email; в приглашении введите придуманный локальный пароль и сохраните его вне проекта. Затем выполните php ../wp-cli-2.12.0.phar option update home http://127.0.0.1:8002 и такую же команду для siteurl. php ../wp-cli-2.12.0.phar theme install twentytwentyone --activate установит классическую тему, на основе которой дальше сделаем дочернюю. Проверьте php ../wp-cli-2.12.0.phar core version: ожидается 7.1.2.
  6. В Visual Studio Code откройте папку ~/notes-wp-lab, создайте wp-content/plugins/fsl-lab-notes/fsl-lab-notes.php, вставьте весь пример и сохраните Ctrl+S. Из корня установки выполните php -l wp-content/plugins/fsl-lab-notes/fsl-lab-notes.php, php ../wp-cli-2.12.0.phar plugin activate fsl-lab-notes, php ../wp-cli-2.12.0.phar post-type get lab_note --field=public и php ../wp-cli-2.12.0.phar taxonomy get lab_topic --field=public: две последние команды должны вывести 1.
  7. Создайте тему командой php ../wp-cli-2.12.0.phar term create lab_topic Backend --slug=backend, затем заметку php ../wp-cli-2.12.0.phar post create --post_type=lab_note --post_status=publish --post_title="Первая заметка" --porcelain. Команда напечатает ID: подставьте его вместо ID в php ../wp-cli-2.12.0.phar post term add ID lab_topic backend. php ../wp-cli-2.12.0.phar post list --post_type=lab_note --fields=ID,post_title,post_status должен показать опубликованную заметку. Пока стандартная тема покажет её без специального шаблона.

Как проверить себя

В отдельной базе есть одна заметка и её тема; WP-CLI видит lab_note и lab_topic. Плагин остаётся активным при смене темы.

Если не получилось
  • Error establishing a database connection? Сначала проверьте sudo service mariadb status, затем имя пользователя из whoami, имя базы и php ../wp-cli-2.12.0.phar db check.
  • post-type get не находит lab_note? Проверьте, что плагин активен, имя файла оканчивается на .php, а php -l не показывает ошибку.

Куда заглянуть дальше