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 так же доступно для редактирования.

Место вывода расширенного описания зависит от используемой на сайте темы и выводится с помощью функций:

Функции плагина

Список функций, который можно использовать при создании шаблонов сайта.

Плагин работает в пространстве имён 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) – идентификатор описания. По умолчанию идентификатор текущего поста.

Скрины

51голос
Рейтинг статьи
Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии
0
Оставьте комментарий! Напишите, что думаете по поводу статьи.x
()
x