Таксономии: рубрики, метки, ... (рубрика)
Таксономии — это мощный инструмент каталогизации любого контента. О том как все это работает подробно описано в статье Таксономии в 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() | Обновляет метаданные элемента таксономии (категории, метки ...). |