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 версії 5.0 в WordPress за замовчуванням використовується блоковий редактор 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) – поверти один опис або всі що прикріплені. За замовчуванням true.

get_description_content

Отримує вміст “опису” терма. Повертає рядок.

Аргументи функції:

  • $term_id (int) – ідентифікатор терміна опис якого потрібно отримати. Обов’язковий параметр.

get_decription_entry_terms_ids

Повертає ідентифікатори термів опису. Повертає масив ідентифікаторів.

Аргументи функції:

  • $post_id (int) – ідентифікатор опису. За замовчуванням ідентифікатор поточного поста.

Скріни

51голос
Рейтинг статті
Підписатися
Сповістити про
guest
0 Коментарі
Вбудовані Відгуки
Переглянути всі коментарі
0
Ми любимо ваші думки, будь ласка, прокоментуйте.x
()
x