Шаблон заметки в дочерней теме
Форма уже сохраняет 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();
Практика
Покажите уже сохранённую заметку своим шаблоном и смените тему на минуту. Так вы увидите разницу между данными плагина и внешним видом страницы.
- В 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. - Из корня установки выполните
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. - Создайте контрольную запись
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. - Временно верните родительскую тему командой
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.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗