Миша Рудрастых Возвращает объект таксономии WP_Taxonomу. Если указанной таксономии не существует, функция возвращает false. Если вы попали сюда, ища способ получения объекта элемента таксономии WP_Term, то взгляните пожалуйста на функции get_term_by() или get_term(). get_taxonomy( $taxonomy ) Параметры $taxonomy (строка) Название таксономии, например category, post_tag или произвольной таксономии. WP_Taxonomy Объект таксономии имеет плюс-минус все те же свойства, которые …
Отменяет регистрацию таксономии. Не работает для рубрик и меток. Возвращает: true – таксономия успешно де-регистрирована. WP_Error – либо в качестве параметра передана несуществующая таксономия, либо таксономия с системный свойством _builtin (рубрика или метка). unregister_taxonomy( $taxonomy ) Параметры $taxonomy (строка) Название таксономии. Пример Функция также должна добавляться на хук init (на этот же хук добавляется и …
Открепляет зарегистрированную таксономию от типа записи. Возвращает: true – открепление прошло успешно, false – если: указана несуществующая таксономия в параметрах функции, указан несуществующий тип записи в параметрах функции, указанная таксономия уже не ассоциирована с указанным типом записи. unregister_taxonomy_for_object_type( $taxonomy, $object_type ) Параметры $taxonomy (строка) Название открепляемой таксономии. $object_type (строка) Название типа записей, от которого открепляем. …
Выводит ссылки на элементы таксономий поста, разделённые запятыми (меняется в параметрах). Воспользуйтесь функцией get_the_terms(), если хотите получить термины поста в виде массива объектов. the_terms( $post_id, $taxonomy, $before = », $sep = ‘, ‘, $after = » ) Параметры $post_id (целое) ID поста, термины которого нужно вывести. Если хотите вывести термины текущего поста в цикле, передайте в …
Возвращает список элементов указанной таксономии, присвоенных к указанному посту в виде HTML-ссылок. Если у поста нет терминов указанной таксономии, вернёт false. Если было передано название несуществующей таксономии, вернёт объект WP_Error. Если вам недостаточно параметров этой функции, чтобы вывести термины в нужном формате, то рекомендую обратить внимание на функцию get_the_terms(). get_the_term_list( $post_id, $taxonomy, $before = », …
Позволяет получить список родительских элементов указанного элемента таксономии в соответствующем порядке. Эта функцию удобно использовать при создании хлебных крошек. Возвращает: список родительских элементов – в случае успеха, объект WP_Error, если пытаемся получить термины несуществующей таксономии или в качестве параметра $term_id передано пустое значение, пустую строку, если у термина нет родительских элементов. get_term_parents_list( $term_id, $taxonomy, $args = …
Возвращает массив, состоящий из ID дочерних терминов элемента таксономии. Дочерние элементы собираются со всех уровней вложенности. Функция возвращает пустой массив, если дочерних элементов у термина нет, или если термин не принадлежит указанной таксономии. Возвращает объект WP_Error, если указана несуществующая таксономия. get_term_children( $term_id, $taxonomy ) Параметры $term_id (целое) ID термина, дочерние элементы которого нужно получить. $taxonomy …
Очищает значение опции в зависимости от того, что это за опция. Подробнее – в правилах очистки. Функция (логично предположить) возвращает очищенное значение. Если с очисткой что-то пошло не так, то регистрирует соответствующую ошибку для отображения на страницах настроек в админке функцией add_settings_error(). sanitize_option( $option, $value ) Параметры $option (строка) Ключ очищаемой опции. Для стандартных опций действуют …
Получаем предопределённый набор CSS-классов для комментария в виде массива. Каждый CSS-класс будет автоматически очищен функцией esc_attr(). get_comment_class( $class = », $comment_id = null, $post_id = null ) Параметры $class (строка|массив) Один или несколько дополнительных CSS-классов, которые хотите добавить в общий список. Можно разделять пробелами или передать в виде массива. $comment_id (целое|WP_Comment) ID или объект комментария, …
Выводит (или возвращает) атрибут class=»» с предопределённым набором CSS-классов комментария. О том, каким образом WordPress задаёт эти CSS-классы, я рассказал тут. comment_class( $class = », $comment = null, $post_id = null, $echo = true ) Параметры $class (строка|массив) Один или несколько дополнительных CSS-классов, которые хотите добавить в общий список. Можно разделять пробелами или передать в …
Функция подключает файл шаблона комментариев (по умолчанию comments.php) и, самое главное, получает комментарии текущего поста и записывает их в глобальные переменные, если быть точнее, то в $wp_query->comment, которая потом используется внутри шаблона комментариев другими функциями, например функцией wp_list_comments(). О написании собственного шаблона вывода комментариев я рассказывал в этом видеоуроке. comments_template( $file = ‘/comments.php’, $separate_comments = false …
Функция возвращает количество комментариев к посту с указанным ID или текущему посту в цикле. get_comments_number( $post_id = 0 ) Параметры $post_id (целое|WP_Post) Укажите ID или объект поста, количество комментариев которого нужно получить. По умолчанию используется текущий пост в цикле. Примеры // выводим количество комментов к текущему посту echo get_comments_number(); // выводим количество комментов из …
Возвращает URL, ведущий на страницу редактирования элемента таксономии в админке. В случае, если передано название несуществующей таксономии, ничего не возвращает. В случае, если у текущего пользователя нет прав на редактирование данного элемента таксономии current_user_can( ‘edit_term’, $term_id ), ничего не возвращает. get_edit_term_link( $term_id, $taxonomy = », $object_type = » ) Параметры $term_id (целое|WP_Term) ID или объект …
Выводит HTML-ссылку на редактирование элемента таксономии (рубрики, метки или произвольной таксономии). Ссылка не будет выведена, если у пользователя нет прав на редактирование термина. Если вам нужно получить/вывести именно URL ссылки, то обратите внимание на get_edit_term_link(). edit_term_link( $link = », $before = », $after = », $term = null, $echo = true ) Параметры $link (строка) …
Возвращает: URL страницы редактирования метки – в случае успеха. null – если текущий пользователь не имеет прав на редактирование. null – если второй параметр функции был изменён, и в него было передано название несуществующей таксономии. get_edit_tag_link( $tag_id, $taxonomy = ‘post_tag’ ) Параметры $tag_id (целое) ID метки URL страницы редактирования которой нужно получить. $taxonomy (строка) Если …