Миша Рудрастых Выводит ссылку (HTML тегом <a>) на страницу редактирования метки. Ссылка не будет выведена, если у пользователя нет прав на редактирование меток. Если вам нужно получить/вывести именно URL ссылки, то обратите внимание на get_edit_tag_link(). edit_tag_link( $link = », $before = », $after = », $tag = null ) Параметры $link (строка) Текст ссылки. По умолчанию __( ‘Edit This’ ) …
Возвращает информацию о метке. В виде объекта или в виде ассоциативного или нумерованного массива. Прежде, чем получать значение из базы данных, функция попробует получить его из кэша. Возвращает объект класса WP_Error, если в первый параметр функции передано пустое значение, либо null, если метки с указанным ID не существует. get_tag( $tag, $output = OBJECT, $filter = …
Функция занимается очисткой информации об элементе таксономии. Также позволяет добавлять в себя другие правила очистки в зависимости от контекста. Возвращает очищенное значение. Если вы не до конца понимаете, про какую «очистку» я говорю, смотрите этот видеоурок. sanitize_term_field( $field, $value, $term_id, $taxonomy, $context ) Параметры $field (строка) Ключ очищаемого поля. По сути может быть названием любого свойства …
Удаляет элемент таксономии. А также его метаданные. Если термин является родительским для других терминов, то его дочерние элементы будут подвинуты на уровень выше. Возвращает: true – удаление прошло успешно, false – указанных терминов не существует, 0 – если была попытка удалить категорию по умолчанию, термин по умолчанию. wp_delete_term( $term, $taxonomy, $args = array() ) Параметры …
Очищает все поля элемента таксономии в полученном объекте/массиве, игнорируя все «левые» поля в нём. Под полями подразумеваются свойства объекта WP_Term. Вот его свойства («не левые» поля). term_id name description slug count parent term_group term_taxonomy_id object_id По факту, всё, что делает функция, это проходит циклом по всем этим ключам внутри массива/объекта и очищает каждый из них …
Возвращает значение одного из полей термина или, иными словами, одно из свойств объекта WP_Term. Значения очищаются функцией sanitize_term_field() в зависимости от контекста использования. Читайте подробнее про очистку в этом уроке. Возвращает объект класса WP_Error, если во второй параметр функции передано пустое значение, либо null, если указанного термина или указанного поля у термина не существует. get_term_field( $field, $term, …
Функция проверяет, существует ли (зарегистрирована ли) указанная таксономия. Возвращает: true – да, существует, false – нет, не существует. taxonomy_exists( $taxonomy ) Параметры $taxonomy (строка) Название проверяемой таксономии. Примеры taxonomy_exists( ‘category’ ); // Возвращает true, потому что рубрики скорее всего существуют на сайте taxonomy_exists( ‘post_tag’ ); // Возвращает true, потому что метки скорее всего существуют на …
Проверяет, существует ли элемент таксономии с указанным ID, ярлыком или названием. Обратите пожалуйста внимание, что функция не супер-быстрая, потому что работает напрямую с базой данных, поэтому возможно, что в вашей ситуации будет лучше использовать для этой цели get_term_by(), которая использует кэш, смотрите примеры. Возвращает: ID термина, если он существует, а проверку мы делали только по …
Добавляет новый термин (рубрику, метку или элемент произвольной таксономии). Возвращает: В случае успеха функция возвращает массив, состоящий из двух ключей – term_id и term_taxonomy_id. Объект WP_Error, если: указанной таксономии не существует (или она регистрируется позже), если в первом параметре передано пустое или числовое значение, если термин с указанным ярлыком или именем уже существует, если указан …
Изменяет элемент таксономии. Функция возвращает: В случае успеха – массив, состоящий из двух ключей – term_id и term_taxonomy_id. Объект WP_Error, если: указанной таксономии не существует (или она регистрируется позже), термина с указанным ID не существует, каким-то образом у обновляемого термина нет имени, и мы не передаём новое, если указан ID родительского термина, но его не существует, если был указан новый …
Подготавливает строку для использования в качестве ярлыка. Ярлыки в WordPress чаще всего используются в URL-ax. Функция преобразует все символы в ASCII, пробелы – в дефисы. Удаляет запрещённые символы, переносит всё в нижний регистр. sanitize_title( $title, $fallback_title = », $context = ‘save’ ) Параметры $title (строка) Строка, которую нужно преобразовать (очистить). $fallback_title (строка) Какое значение использовать …
Функция нужна для получения элементов таксономий (рубрик, меток и т.д) постов (записей, страниц или постов произвольного типа). Очень похожа на функцию wp_get_post_terms(). Возвращает: массив объектов терминов WP_Term, пустой массив, если у поста нет элементов таксономии (терминов) по заданным критериям, объект WP_Error, если мы попытались получить термины несуществующей таксономии (хотя бы одной из переданных). Если вы …
Функция выводит информацию об авторе текущего поста или о пользователе с указанным ID, либо значение любого его мета-поля. Если вам нужно не вывести, а получить эту информацию и записать в переменную, то обратите внимание на get_the_author_meta(). А значения мета-полей вы также можете получить функцией get_user_meta(). the_author_meta( $field = », $user_id = false ) Параметры $field …
Возвращает ответ в виде JSON в асинхронном AJAX-запросе. «Возвращает» – это не значит, что результат действия функции можно присвоить в переменную. Тут имеется ввиду именно ответ от запроса AJAX. Функция также прерывает выполнение PHP-кода в запросе функцией wp_die() и добавляет в заголовок ответа Content-Type: application/json. На её основе работают очень похожие функции wp_send_json_success() и wp_send_json_error(). Кстати, …
Функция позволяет определить, выполняется ли данный код как часть AJAX-запроса в WordPress. Возвращает: true – если да, false – если нет. До версии 4.7 мы делали эту проверку при помощи константы DOING_AJAX, например так: if( defined( ‘DOING_AJAX’ ) && DOING_AJAX ). Кстати, если вы не чувствуете, что хорошо разбираетесь в асинхронных запросах WordPress, тогда я …