Данные 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 следующих уроков.
- В терминале 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. Для этого курса не подключайтесь к базе рабочего сайта. - В домашней папке 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. - Выполните
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 без пароля; не используйте этот способ как готовую схему для публичного сервера. - Создайте отдельную папку командами
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. - Выполните
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. - В 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. - Создайте тему командой
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не показывает ошибку.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗