Миша Рудрастых Позволяет удалить определённую опцию из базы данных по её ключу, если удаление прошло успешно, возвращает true, если же нет – false (например опции с указанным ключом не существует или же вообще в качестве значение $option была передана пустая строка). delete_option( $option ) Параметры $option (строка) Название (ключ) опции, которую нужно удалить Пример В этом примере, …
Функция выводит скрытые поля <input type=»hidden» />, а именно: скрытое поле с названием группы настроек, скрытое поле со значением action, а точнее <input type=»hidden» name=»action» value=»update» />, скрытое поле с одноразовым числом. settings_fields( $option_group ) Параметры $option_group (строка) Название группы настроек. Оно кстати должно совпадать с параметром $option_group, который вы указываете при регистрации конкретной опции …
Эту функцию удобно использовать для вывода заголовков страниц в админке при создании их функциями add_menu_page(), add_submenu_page() и им подобными. get_admin_page_title() Параметры У функции нет аргументов. Пример add_action( ‘admin_menu’, function(){ add_submenu_page( ‘options-general.php’, ‘Ещё настройки’, // это значение и будет доступно внутри get_admin_page_title() ‘Ещё настройки1’, // это текст ссылки в меню кстати ‘manage_options’, ‘true_options_page’, ‘true_options_callback’ ); …
Класс WP_Error призван упростить работу с ошибками, которые вызваны либо некорректным действием пользователем, либо каких-то сторонних приложений или плагинов. То есть таким образом мы даже можем разделить ошибки на два типа: ошибки разработчика, который(ая) скажем пишет плагин или тему – в таком случае, если там вызывается например несуществующая функция или наоборот функция определяется дважды, то …
Проверяет переданную в неё переменную на то, является ли она ошибкой WordPress, а именно объектом класса WP_Error. Вообще, объект WP_Error могут возвращать многие функции WordPress в случае неудавшегося их выполнения, например, если при регистрации пользователя функцией wp_insert_user() был использован уже зарегистрированный на сайте email, или же, при попытке получения терминов поста функцией wp_get_post_terms(), мы передали …
В WordPress 5.7 появился фильтр-хук login_site_html_link, который позволяет полностью переписать HTML ссылки «Перейти к Студия Миши Рудрастых» (понятно, что текст ссылки зависит от названия вашего сайта 🙂) Единственный параметр этого хука – переменная $link, которая и содержит полностью весь HTML ссылки для отображения. То есть по сути вы можете даже полностью удалить эту ссылку, покажу …
Функция возвращает массив объектов элементов таксономий 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». Но …