Таксономії: рубрики, мітки, … (рубрик)
Таксономія – це потужний інструмент каталогізації будь-якого контенту. Про те як все це працює докладно описано у статті Таксономії у WordPress .
На цій сторінці знаходиться список усіх функцій, які безпосередньо пов’язані з керуванням таксономій у WordPress (створенням, редагуванням та виведенням).
| get_ancestors() | Отримує ID батьківських елементів вказаного об’єкта (сторінки, таксономії, категорії). |
| get_term_parents_list() | Отримує перелік батьків зазначеного елемента таксономії. |
| WP_Tax_Query{} | Клас створює JOIN і WHERE частини SQL запиту, які на додаток до основного запиту фільтруватимуть результат за вказаними термінами (елементами таксономій). |
| wp_terms_checklist() | Виводить UL список із input checkbox полів, заголовком яких є назви елементів зазначеної таксономії. |
Для записів
| get_object_taxonomies() | Отримує таксономії запису (типу посту) або до переданого об’єкту, що відносяться до зазначеного типу. |
| get_objects_in_term() | Отримує ID об’єктів (зазвичай це записи), які відносяться до вказаного елемента таксономії. |
| get_the_category() | Отримує масив даних про категорії, що належать до зазначеної посади. |
| get_the_category_list() | Отримує список категорій посту. Список виходить як посилання на категорії. |
| get_the_tag_list() | Отримує HTML рядок позначок поточного посту. Назва кожної мітки буде посиланням на архів постів з цією міткою. Використовується у циклі. |
| get_the_tags() | Отримує масив міток поточного посту. Кожен елемент масиву – це об’єкт WP_Term . Можна використовувати всередині циклу. |
| get_the_taxonomies() | Отримує всі елементи всіх таксономій, пов’язаних із записом. Отримує масив HTML посилань. |
| get_the_term_list() | Виводить список посилань на елементи таксономії (наприклад, мітки), що належать до певної посади. |
| get_the_terms() | Отримує елементи таксономії (терміни), які відносяться до зазначеного поста (запису). |
| has_category() | Перевіряє, чи знаходиться поточний (або вказаний) запис хоч в одній із зазначених категорій. |
| has_tag() | Перевіряє чи належить пост до зазначених міток, тобто. чи має пост зазначені мітки. Умовний тег. |
| has_term() | Перевіряє наявність у посту термінів, тобто. перевіряє чи має пост мітки/категорій/розділи (з урахуванням таксономії). |
| is_object_in_taxonomy() | Перевіряє, чи вказаний тип запису з вказаною таксономією. |
| is_object_in_term() | Визначає чи пов’язаний зазначений об’єкт з будь-яким із зазначених елементів таксономії (терміном). Можна вказати конкретний термін(и) для перевірки зв’язку. |
| the_category() | Виводить посилання на рубрики, до яких належить пост у вигляді HTML li списку або у довільному форматі. |
| the_tags() | Виводить посилання на мітки, які належать до посту. |
| the_taxonomies() | Виводить посилання на терміни посту. Використовується всередині Цикл WordPress |
| wp_delete_object_term_relationships() | Руйнує всі зв’язки об’єкта (пост, сторінка) з елементами зазначеної таксономії. |
| wp_get_object_terms() | Отримує терміни (елементи таксономії) пов’язані з переданим об’єктом (записами) у зазначеній таксономії. |
| wp_get_post_categories() | Отримує список категорій (рубрик) посту (запису) як масиву. |
| wp_get_post_tags() | Отримує список позначок зазначеного посту у вигляді масиву. |
| wp_get_post_terms() | Отримує елементи зазначеної таксономії (мітки, рубрики…) з якою пов’язаний зазначений запис. |
| wp_remove_object_terms() | Розриває зв’язок між зазначеним об’єктом та зазначеним терміном, тобто. видаляє запис із елемента таксономії (рубрики). |
| wp_set_object_terms() | Прикріплює пост (запис) до терміну (елемент таксономії). Наприклад, можна помістити пост у цю категорію. Створює терміни, якщо їх немає. |
| wp_set_post_categories() | Встановлює категорії для посту. |
| wp_set_post_tags() | Встановлює позначки для посту. |
| wp_set_post_terms() | Встановлює терміни для зазначеного запису (постачальника). |
Рубрики
| cat_is_ancestor_of() | Перевіряє, чи вказана рубрика є дочірньою до іншої зазначеної рубрики (перевіряються всі рівні вкладеності). Умовний тег. |
| category_description() | Отримує опис рубрики, який вказується на сторінці редагування рубрики на адмін-панелі (пости > рубрики). |
| category_exists() | Перевіряє чи вказана рубрика (категорія). Якщо існує, повертає ID цієї рубрики. |
| get_cat_ID() | Отримує ID категорії за переданою назвою. |
| get_cat_name() | Отримує назву категорії за надісланим ID. |
| get_categories() | Отримує категорії у вигляді масиву об’єктів. |
| get_category() | Отримує дані вказаної категорії. |
| get_category_by_slug() | Отримує дані категорії з її альтернативної назви (слагу). |
| get_category_link() | Отримує коректне посилання на сторінку категорії за переданим ID категорії. |
| get_category_parents() | Отримує список батьківських категорій цієї категорії. Список виводиться у порядку вкладеності. |
| get_the_category_by_ID() | Отримує назву рубрики за надісланим ID. |
| in_category() | Перевіряє, чи належить поточний (або вказаний) пост до зазначеної категорії (можна вказати кілька категорій). Умовний тег. |
| single_cat_title() | Виводить на екран заголовок рубрики чи мітки. Використовується поза циклу. Призначений для сторінок архівів. |
| wp_create_category() | Спрощена функція додавання категорії, в яку потрібно передати назву нової категорії та якщо потрібно ID батьківської категорії. |
| wp_dropdown_categories() | Відображає або отримує список категорій у форматі HTML. Замість рубрик можна назвати довільну таксономію. |
| wp_insert_category() | Вставляє нову категорію до бази даних. Або оновлює існуючу, для цього потрібно вказати ID категорії. |
| wp_list_categories() | Виводить список категорій як посилань. Якщо перейти за посиланням, будуть показані всі пости з категорії. |
Мітки
| edit_tag_link() | Виводить посилання на редагування поточної мітки, якщо користувачеві дозволено змінювати мітки. |
| get_tag_link() | Повертає посилання на мітку по переданому ID мітки. |
| get_tags() | Отримує масив об’єктів, з даними про мітки. Дані можна отримувати за різними критеріями (задається у параметрі $args). |
| single_tag_title() | Виводить заголовок поточної мітки, якщо відображається архівна сторінка мітки. |
| tag_description() | Отримує опис мітки, який задається під час створення/редагування мітки в адмін-панелі. |
| tag_exists() | Перевіряє чи вказана мітка (тег). Якщо існує, повертає ID або масив даних цієї позначки. |
| wp_generate_tag_cloud() | Обробляє передані дані термінів (міток) та повертає HTML код хмари тегів. |
| wp_tag_cloud() | Виводить або отримує хмару міток (список міток у вигляді хмари). Можна вказати довільну таксономію. |
Будь-які таксономії
| edit_term_link() | Отримує або виводить посилання (html тег A) на редагування зазначеного елемента таксономії (терміну). |
| get_edit_term_link() | Отримує URL-адресу для редагування зазначеного елемента таксономії. |
| get_taxonomies() | Отримує список зареєстрованих таксономій. Ви можете обмежити список за потрібними параметрами. |
| get_taxonomy() | Отримує об’єкт, який містить налаштування (дані) про вказану таксономію. |
| get_term() | Отримує дані про елемент таксономії (термін) за переданим ID. |
| get_term_by() | Отримує зазначений термін (елемент таксономії) за: ім’ям (назвою), ярликом (слагою) або за ID терміном. |
| get_term_children() | Отримує всі дочірні елементи вказаного елемента таксономії (категорії) як масиву. |
| get_term_field() | Отримує поле терміна. Поле очищається функцією sanitize_term_field(). |
| get_term_link() | Отримує УРЛ на сторінку архіву терміна (елемента таксономії). Теж саме посилання на розділ рубрики. |
| get_terms() | Отримує елементи (терміни) таксономії за вказаними параметрами. |
| is_taxonomy_hierarchical() | Перевіряє чи деревоподібна зазначена таксономія. Умовний тег. |
| register_taxonomy() | Створює нову довільну таксономію WordPress. Дозволяє змінити існуючу таксономію. |
| register_taxonomy_for_object_type() | Прив’язує (додає) вказану таксономію до зазначеного типу запису (поста). |
| sanitize_term() | Очищає всі поля елемента таксономії за допомогою sanitize_term_field() . |
| sanitize_term_field() | Підготовляє (очищає) значення поля терміна (рубрик) для його використання в тексті або десь ще (залежить від контексту очищення). |
| single_term_title() | Виводить на екран або отримує заголовок поточної таксономії (категорії, мітки тощо). Призначений для сторінок архівів. |
| taxonomy_exists() | Перевіряє чи існує таксономія. |
| term_description() | Отримує опис терміна (елемента таксономії: мітки, категорії тощо), який вказується на сторінці створення/редагування терміну. |
| term_exists() | Перевіряє, чи існує вказаний елемент таксономії (розділ). Якщо є, повертає ID або масив даних цього елемента. |
| term_is_ancestor_of() | Перевіряє, чи другий термін є дочірнім до першого (перевіряються всі рівні вкладеності). Умовний тег. |
| the_terms() | Виводить список посилань на терміни (елементи таксономії), що належать до зазначеної посади. |
| unregister_taxonomy() | Скасує реєстрацію зазначеної таксономії (видаляє таксономію). |
| unregister_taxonomy_for_object_type() | Відкріплює таксономію від зазначеного типу запису (чи іншого об’єкта). |
| wp_count_terms() | Вважає скільки в таксономії елементів (термінів), із записами чи без записів. |
| wp_delete_term() | Видаляє термін (категорію, мітку) із Бази Даних. |
| wp_get_term_taxonomy_parent_id() | Отримує ID батьківського елемента таксономії (терміну) до вказаного. |
| wp_insert_term() | Додає новий елемент таксономії (термін, рубрику) до бази даних. |
| wp_update_term() | Оновлює термін (елемент таксономії), використовуючи вказані дані. |
| wp_update_term_count() | Оновлює кількість записів в елементі таксономії (термін). |
Метадані (termmeta)
| add_term_meta() | Додає мета поле (додаткове поле) для елемента вказаної таксономії (рубрики, мітки…). |
| delete_term_meta() | Видаляє цільове поле вказаного елемента таксономії. |
| get_term_meta() | Отримує значення зазначеного мета поля елемента таксономії (рубрики, мітки тощо). Можна отримати всі значення як масиву. |
| has_term_meta() | Отримує всі метадані зазначеного елемента таксономії (терміну). |
| register_term_meta() | Реєструє метапол для зазначеної таксономії. |
| update_term_meta() | Оновлює метадані елемента таксономії (категорії, мітки…). |