
Плагин BETD
Taxonomy description by means of block editor добавляет поле для выбора расширенного описания сделанного с помощью редактора Gutenberg для термов (категорий) . Работает со всеми таксономиями, включая пользовательские. Список таксономий для которых можно включить расширенное описание можно изменить в настройках плагина.
Страница плагина в каталоге WordPress https://wordpress.org/plugins/block-editor-taxonomy-description/
Git-репозиторий https://github.com/chomovva/block-editor-taxonomy-description
На стандартной странице редактирования терма (категории) для описания предусмотрено только поле textarea. С помощью, к примеру, Visual Term Description Editor или Yoast SEO plugin можно подключить TinyMCE для редактирования этого поля. Но не редко бывает, что страницы категорий используются как посадочные и там требуется расширенное описание со сложной вёрсткой в виде галерей, форм, таблиц и прочего. В таком случае TinyMCE будет недостаточно. Можно написать вёрстку отдельно и просто встать её в редактор, но это неудобно.
Gutenberg
C версии WordPress 5.0 по умолчанию включён блочный редактор Gutenberg, он имеет ряд преимуществ по сравнению с «классическим» TinyMCE, среди них:
- упрощение процесса создания страницы
- ориентирование на визуальную составляющую контента
- возможность создавать сложные макеты без знания и опыта HTML
- позволяет быстро включать контент из разных ресурсов
- легко создать индивидуальный дизайн для поста в блоге или страницы
Благодаря этому Gutenberg отлично подходит для создания расширенного описания, но он предназначен только для редактирования постов и страниц. Плагина Taxonomy description by means of block editor добавляет в WordPress возможность создавать расширенные описания для категорий с помощью блочного редактора Gutenberg.
Как это работает
Плагин Taxonomy description by means of block editor регистрирует в WordPress пользовательский тип записи term_desc
. По умолчанию записи этого типа непубличные, недоступны для поиска и в меню WordPress. При желании это можно изменить в настройках плагина. Содержимое записей term_desc
. полностью редактируется с помощью Gutenberg.
Во время создания или редактирования терма (категория или тег) можно выбрать из списка запись типа term_desc
, которая станет описанием терма. Записи нужно создать заранее. В публичной части сайта стандартное описание категорий и тегов будет заменено на контент выбранной в настройках записи.
Одно расширенное описание может быть использовано сразу для нескольких категорий (термов).
Чтобы не вызывать конфликтов с другими плагинами стандартное поле textarea так же доступно для редактирования.
Место вывода расширенного описания зависит от используемой на сайте темы и выводится с помощью функций:
category_description
– получает описание рубрики, которое указывается на странице редактирования рубрики в админ-панели (посты > рубрики). Описание: https://developer.wordpress.org/reference/functions/category_description/tag_description
– получает описание метки, которое задается при создании/редактировании метки в админ-панели. Описание: https://developer.wordpress.org/reference/functions/tag_description/term_description
– получает описание термина (элемента таксономии: метки, категории и т.п.), которое указывается на странице создании/редактировании термина Описание: https://wp-kama.ru/function/term_descriptionget_term_field
– получает поле термина. Описание https://wp-kama.ru/function/get_term_field
Функции плагина
Список функций, который можно использовать при создании шаблонов сайта.
Плагин работает в пространстве имён betdpl
, поєтому все функции следует вызывать так:
betdpl\имя_функции()
get_entries
Получает список всех описаний. Возвращает массив или объект WP_Error. Обёртка для функции get_posts
.
Аргументы функции:
$args(array)
– Список аргументов, в соответствии с которыми будет получен результат. Аналогичен функцииget_posts
get_plugin_options
Получает опции плагина. Возвращает ассоциативный массив с параметрами работы плагина.
Не принимает никаких аргументов.
get_plugin_taxonomy_names
Возвращает идентификаторы таксономий с которыми работает плагин. Возвращает массив с идентификаторами таксономий для которых можно добавить расширенное описание на Gutenberg. Список можно изменить в настройках плагина.
get_description_id
Получает идентификатор “описания” терма. Возвращает идентификатор (int) или 0.
Аргументы функции:
$term_id (int)
идентификатор термина описание которого нужно получить. Обязательный параметр.$single (bool)
– возвращиет одно описание, false – все, которые прикреплены. По умолчаниюtrue
.
get_description_content
Получает содержимое “описания” терма. Возвращает строку.
Аргументы функции:
$term_id (int)
– идентификатор термина описание которого нужно получить. Обязательный параметр.
get_decription_entry_terms_ids
Возвращает идентификаторы термов описания. Возвращает массив идентификаторов.
Аргументы функции:
$post_id (int)
– идентификатор описания. По умолчанию идентификатор текущего поста.