Таксономии: рубрики, метки, ... (рубрика)

Таксономии — это мощный инструмент каталогизации любого контента. О том как все это работает подробно описано в статье Таксономии в WordPress.

На этой странице находится список всех функций, которые напрямую связаны с управлением таксономий в WordPress (созданием, редактирование и выводом).

_update_post_term_count()

Обновляет количество записей (постов) прикрепленных к термину (элементе таксономии). Какие типы записей считать, берется из настроек таксономии.

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()

Обновляет метаданные элемента таксономии (категории, метки ...).