Миша Рудрастых Функция производит следующие замены: Было Стало & (амперсанд) & ” (двойная кавычка) " ‘ (одинарная кавычка) ' < (меньше, чем, часть HTML тегов) < > (больше, чем, часть HTML тегов) > Кроме того, функция выполняет любые дополнительные преобразования, заданные в фильтре esc_textarea. Переносы строк останутся нетронутыми. Если уже преобразованная строка будет вновь передана в функцию, то …
Функция заботится о безопасном выводе URL на экран, как в виде текста, так и качестве HTML атрибутов, например <img src=””>, <a href=””> и т.д. Никогда не выводите неочищенный URL в своём коде (узнайте, почему). Что конкретно делает функция: Удаляет пробелы на концах. Заменяет пробелы внутри на символы %20. Для всех протоколов кроме mailto удалит символы …
Функция подготавливает (очищает) переданную в неё строку как URL для редиректов, HTTP-запросов и запросов к базе данных. Обратите внимание, что если вы хотите выводить URL на сайте или например использовать его в качестве HTML-атрибутов, то вам нужна другая функция – esc_url(). Как конкретно работает функция: Удаляет пробелы на концах. Заменяет пробелы внутри на символы %20. Для …
Функция является частью Settings API в WordPress и используется в совокупности с другими функциями для создания страниц настроек, например settings_fields(), add_settings_section(), add_settings_field(), подробнее – в моём руководстве по страницам настроек. do_settings_sections( $page ) Параметры $page (строка) ярлык (идентификатор) страницы настроек. Важно отметить, что это значение должно совпадать с: Параметром $page (4-й параметр) функции add_settings_section(), Параметром …
Функция регистрирует опцию, которую впоследствии можно вывести на страницах настроек при помощи функции add_settings_field(). По сути помогает предопределить поведение опции, например задав функцию для очистки значений и значение по умолчанию. register_setting( $option_group, $option_name, $args = array() ) Параметры $option_group (строка) Этим параметром определяется, где конкретно отображается поле данной опции. Например для кастомных страниц настроек он должен …
Функция является частью Settings API. Используйте эту функцию для добавления поля на страницу настроек, которое впоследствии будет выведено при помощи do_settings_sections() или do_settings_fields(). Также эта функция задаёт HTML поля. Важноый момент, прежде чем добавлять поле опции, вам нужно эту опцию сначала зарегистрировать функцией register_setting(). Иначе, поле выведется, но не будет сохраняться конечно же. И конечно …
Функция является частью Settings API в WordPress и позволяет добавить секцию на стандартную или кастомную страницу настроек, в которой будут отображаться поля, причём эта секция может быть: Без заголовка, в ней будут отображаться только поля. С заголовком и со стандартной HTML-разметкой, которую даёт ей WordPress. Абсолютно с любым HTML, как мы захотим. И конечно же, …
Функция, которую вы можете использовать в админке WordPress для вывода кнопки в общем стиле админ-панели. Кнопка выводится HTML-тегом <input type=”submit” />. Не рекомендую использовать эту функцию за пределами админки, если вы не хотите столкнуться с ошибкой 500 (Call to undefined function submit_button()). Функцию довольно удобно использовать при создании кастомных страниц настроек в WordPress. Кстати, если …
Часть Settings API в WordPress. Регистрирует ошибку или уведомление для отображения на страницах настроек в админке (сохраняет в транзитный кэш, если быть точным). add_settings_error( $setting, $code, $message, $type = ‘error’ ) Параметры $setting (строка) Произвольный идентификатор группы ошибок. Должен совпадать с единственным параметром функции settings_errors(), которая как раз и позволяет вывести определённую группу ошибок. Однако, интересный …
Является частью Settings API в WordPress. Позволяет вывести на страницах в админке уведомления и ошибки (в виде HTML), которые были добавлены функцией add_settings_error(). Вообще мы обычно используем эту функцию при создании каких-либо страниц настроек в админке, но тут есть важный момент, про который не нужно забывать – функция вызывается автоматически, если ваша страница настроек находится …
Функция является частью Settings API в WordPress и возвращает массив уведомлений и ошибок для страниц настроек в админке. Уведомления и ошибки она получает из транзитного кэша, а добавлены они туда функцией add_settings_error(). В случае, если вызывается при успешном сохранении настроек (задана переменная $_GET[‘settings-updated’]), то все ошибки записываются в глобальную переменную $wp_settings_errors, а транзитный кэш очищается. …
Сериализация – это преобразование нескалярного типа данных, например массива или объекта в скалярный – специальную строку, с которой также можно в дальнейшем работать. В рамках WordPress сериализация используется такими функциями, как update_option() или update_site_meta() для того, чтобы было возможно сохранять структурные данные настроек сайта в базу данных, где всё хранится в скалярных значениях. Функция сериализует …
Функция возвращает логическое значение true или false. true – переданное в неё значение является сериализованным, пусть даже и повторно сериализованным. false – во всех остальных случаях, и также, если в неё было передано нестроковое значение, например массив. is_serialized( $data, $strict = true ) Параметры $data Значение, которое нужно проверить. $strict (логический) Более строгая проверка данных. …
Функция возвращает true или false. true – если в переданном значении была сериализована именно строка (а не массив или число), false – если переданное значение является например сериализованным массивом или не является строкой вовсе. Может быть удобна для проверки значения на повторную сериализацию. Это когда например мы сериализуем массив – и он становится строкой, тогда …
Противоположный эффект имеет функция maybe_serialize(), которая наоборот сериализует данные. Небольшой прикол о том, как работает приставка maybe_ в функциях maybe_serialize() и maybe_unserialize(). По логике она должна означать «делаем действие, если необходимо», однако так она работает только во второй функции maybe_unserialize() – то есть действительно, если мы передадим в функцию сериализованную строку, то она её структурирует, если …