Функция возвращает массив объектов элементов таксономий WP_Term в случае успеха, пустой массив, если терминов по заданному критерию не найдено или же объект ошибки WP_Error, если таксономия $taxonomy не существует. Если вы получаете термины поста в цикле, и если вам не нужно передавать произвольные параметры в виде массива $args, рассмотрите вариант использования функции get_the_terms(), потому что …
Параметр $crop функции add_image_size() ранее был лишь логическим значением – true or false. true означал жёсткую обрезку по размерам, false – мягкую пропорциональную обрезку, подробнее тут. Теперь же (а точнее начиная с WordPress 3.9) вы можете передавать массив с параметрами позиционирования обрезаемой области (x_crop_position, y_crop_position), но в этом случае у нас всегда используется жёсткая обрезка! …
Главное отличие функции wp_strip_all_tags() от обычной PHP-функции strip_tags() в том, что она удаляет не только теги сами по себе, но также и то, что внутри тегов <script> и <style>. wp_strip_all_tags( $string, $remove_breaks = false ) $string (строка) Какой-то текст, из которого нужно удалить теги. $remove_breaks (строка) Нужно ли также удалить пустые строки и переносы на …
Функция по сути подключает любой PHP-файл с доступной в нём средой WordPress, а также глобальными переменными $posts, $post, $wp_did_header, $wp_query, $wp_rewrite, $wpdb, $wp_version, $wp, $id, $comment, $user_ID. Кроме того, массив $wp_query->query_vars, если существует, будет разобран на отдельные переменные php-функцией extract(). То есть $wp_query->query_vars[ ‘param1’ ] превратится в $param1. Подробнее во втором примере. И ещё кое-что, параметр …
Функция возвращает путь к первому найденному файлу шаблона или подключает его. Если файла шаблона не найдено, то возвращает пустую строку. Если вам интересно лучше разбираться, как устроены файлы тем в WordPress и как работает их иерархия, то рекомендую посмотреть этот видеоурок. locate_template( $template_names, $load = false, $require_once = true, $args = array() ) Параметры $template_names (массив|строка) …
Функция sanitize_text_field() очищает переданную в неё строку следующим образом: Проверяет, является ли переданное значение числом или строкой, если это объект или массив – возвращает пустую строку. Удаляет некорректные для кодировки UTF-8 символы. Преобразует открывающий символ <, не являющийся частью HTML-теги в HTML-сущность <. Преобразует символы переносов строки и табуляции r, n и t в пробелы. Очищает пробелы …
Функция возвращает true, если у заданного пользователя имеется проверяемое право, иначе – false. Рекомендую вам свой подробный урок про роли и права пользователей WordPress! user_can( $user, $capability, …$args ) Параметры функции user_can() $user (целое число|объект WP_User) ID или объект пользователя, которого проверяем. Если передаём ID, то функция сама будет получать из него объект функцией get_userdata(). …
Функция возвращает true, если пользователь является супер-админом сети WordPress Мультисайт, иначе – false. Хуков внутри функции нет. is_super_admin( $user_id = false ) $user_id (целое число) Укажите ID пользователя, которого хотите проверить на суперадмина, по умолчанию проверяется текущий пользователь. Примеры Обычная проверка: $user_id = 5; if( is_super_admin( $user_id ) ) { // Да, пользователь с ID=5 …
Эта тема уже затрагивалась на некоторых сайтах, тем не менее хочу описать её ещё и по-своему. Вполне возможно, что иногда в коде вы могли сталкиваться с функциями типо wp_verify_nonce() или wp_nonce_field() или что-то-там…nonce(). Эти функции нужны для генерации и проверки одноразовых чисел. Они так называются, потому что nonce – это сокращение «Number used ONCE». Но …
Создаёт и возвращает nonce – уникальное одноразовое число, привязанное к переданному в неё значению переменной, текущему пользователю, сессии пользователя и временному промежутку. Функция должна вызываться не ранее хука init. Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке. wp_create_nonce( $action = -1 ) $action (строка|целое) Ключ, описывающий действие, на основе …
Добавляет значение одноразового ключа в URL в качестве $_GET-параметра. Перед тем, как вернуть URL, очищает результат функцией esc_html(), а значит, преобразует символы & в &. Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке. wp_nonce_url( $actionurl, $action = -1, $name = ‘_wpnonce’ ) $actionurl (строка) URL, к которому нужно добавить нонс-ключ. …
Позволяет проверить валидность одноразового числа nonce. Кстати, по умолчанию одноразовые числа валидны в течение 24 часов, но это время можно изменить. Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке. wp_verify_nonce( $nonce, $action = -1 ) $nonce (строка) В этот параметр передаём значение nonce для проверки $action (строка|целое) Ключ, описывающий действие, …
Создаёт скрытое поле <input type=»hidden» />, содержащее защитный ключ nonce. Также позволяет добавить второе скрытое поле с реферером. Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке. wp_nonce_field( $action = -1, $name = ‘_wpnonce’, $referer = true, $echo = true ) $action (строка|целое) Ключ, описывающий действие, на основе которого будет создано …
Функция нужна для валидации одноразовых чисел (nonces) в AJAX-запросах. Рекомендую вам свой видеокурс по AJAX в WordPress. Читайте, что такое одноразовые числа (nonces) и для чего они нужны в этом уроке. check_ajax_referer( $action = -1, $query_arg = false, $die = true ) Параметры функции check_ajax_referer() $action (строка|целое) Ключ, описывающий действие, который использовался при создании проверяемого защитного …
