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

Шаблон заметки в дочерней теме

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

Форма уже сохраняет lab_note. Выведем её название и тему в браузере через шаблон, не перенося регистрацию данных из плагина.

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

Дочерняя тема наследует файлы Twenty Twenty-One, а файл single-lab_note.php отвечает только за отдельную заметку. WordPress выбирает его по типу записи. esc_html выводит пользовательское название как текст, поэтому символы < и > не становятся HTML-разметкой. Тему записи читаем из lab_topic и тоже экранируем.

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

Дочерняя тема
Собственная тема, которая наследует файлы другой. Здесь она добавляет один шаблон и не меняет исходную Twenty Twenty-One.
Шаблон записи
PHP-файл, который WordPress выбирает для показа одной записи определённого типа. single-lab_note.php относится только к lab_note.
Экранирование вывода
Преобразование специальных символов перед показом. esc_html делает <b> видимым текстом, а не исполняемой разметкой.

get_header и get_footer берут общие части родительской темы. get_the_terms может вернуть список, пустой результат или ошибку, поэтому перед чтением имени есть проверка.

wp_kses_post оставляет разрешённую WordPress разметку содержимого. Для простого заголовка используем более строгий esc_html по контексту вывода.

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

wp-content/themes/fsl-lab-child/style.css — весь файл:
/*
Theme Name: FSL Lab Child
Template: twentytwentyone
Version: 1.0.0
*/

wp-content/themes/fsl-lab-child/single-lab_note.php — весь файл:
<?php
get_header();
while (have_posts()) : the_post();
    echo '<main id="primary"><article>';
    echo '<h1>' . esc_html(get_the_title()) . '</h1>';
    $topics = get_the_terms(get_the_ID(), 'lab_topic');
    if ($topics && !is_wp_error($topics)) {
        echo '<p>Тема: ' . esc_html($topics[0]->name) . '</p>';
    }
    echo '<div>' . wp_kses_post(get_the_content()) . '</div>';
    echo '</article></main>';
endwhile;
get_footer();

Практика

Покажите уже сохранённую заметку своим шаблоном и смените тему на минуту. Так вы увидите разницу между данными плагина и внешним видом страницы.

  1. В Visual Studio Code в папке ~/notes-wp-lab создайте каталог wp-content/themes/fsl-lab-child и два файла из примера. Скопируйте каждый подписанный участок только в соответствующий файл, без строк с путями и без второго <?php. Сохраните Ctrl+S. Выполните php -l wp-content/themes/fsl-lab-child/single-lab_note.php.
  2. Из корня установки выполните php ../wp-cli-2.12.0.phar theme activate fsl-lab-child и php ../wp-cli-2.12.0.phar theme list --status=active --field=name. Ожидайте fsl-lab-child. Плагин fsl-lab-notes остаётся активным, а php ../wp-cli-2.12.0.phar post-type get lab_note --field=public по-прежнему выводит 1.
  3. Создайте контрольную запись php ../wp-cli-2.12.0.phar post create --post_type=lab_note --post_status=publish --post_title="<b>Тест & проверка</b>" --porcelain, запомните её ID и привяжите тему командой php ../wp-cli-2.12.0.phar post term add ID lab_topic backend. В браузере откройте http://127.0.0.1:8002/?p=ID. Увидите заголовок буквально с <b>, без жирного начертания, и строку Тема: Backend.
  4. Временно верните родительскую тему командой php ../wp-cli-2.12.0.phar theme activate twentytwentyone и обновите запись в браузере: специальная строка темы из дочернего шаблона исчезнет, но запись и lab_topic останутся в WP-CLI. Снова включите fsl-lab-child. Эта проверка показывает границу плагина и оформления; она не удаляет данные.

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

Шаблон показывает название и тему заметки; после временной смены оформления записи и таксономия не пропали.

Если не получилось
  • WordPress не видит дочернюю тему? Проверьте точную строку Template: twentytwentyone в style.css и установленную родительскую тему.
  • Появилась страница 404? Убедитесь, что сервер wp server ещё запущен, а ID относится к опубликованному lab_note. При необходимости выполните php ../wp-cli-2.12.0.phar rewrite flush.

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