Таксономії: рубрики, мітки, … (рубрик)
Таксономія – це потужний інструмент каталогізації будь-якого контенту. Про те як все це працює докладно описано у статті Таксономії у 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() |
Оновлює метадані елемента таксономії (категорії, мітки…). |