add_management_page()

Добавляет дочерний элемент и страницу к нему в меню Инструменты в админ-панели. Функция аналогична функции add_submenu_page() с первым параметром $parent_slug равным tools.php. Возвращает хук созданной страницы, который можно использовать в других функциях, подробнее про то, как использовать этот хук, читайте в этом примере. Или false, если у пользователя нет прав на доступ к этой странице. add_management_page( $page_title, $menu_title, $capability, …

Подробнее

add_posts_page()

Добавляет дочерний элемент и страницу к нему в меню Записи в админ-панели. Функция аналогична функции add_submenu_page() с первым параметром $parent_slug равным edit.php. Довольно редко встречал реальное использование этой функции, гораздо чаще используют add_options_page() или ту же add_submenu_page(). Возвращает хук созданной страницы, который можно использовать в других функциях, подробнее про то, как использовать этот хук, читайте в этом примере. add_posts_page( …

Подробнее

Кастомайзер может исчезнуть у части пользователей блочных тем в WordPress 5.9

Девять лет назад в WordPress появился кастомайзер, который был холодно принят сообществом авторов тем и разработчиков. Несмотря на это, он перешел в категорию стандартных инструментов для изменения внешнего вида сайта. Разработчики привыкли к API. Пользователи привыкли к настройке цветов, шрифтов и даже внутренних параметров WordPress с его помощью. Однако с момента активации блочной темы кастомайзер …

Подробнее

В WordPress 5.9 появится новый API для блокировки блоков

Блочные темы открывают перед пользователями обширное пространство творческих возможностей. Однако бывают ситуации, когда авторам тем необходимо заблокировать ключевые элементы дизайна и связанные с ними области содержимого. Специально с этой целью в релизе WordPress 5.9 будет внедрен новый API для блокировки блоков, появившийся ранее в Gutenberg 11.6. Блокировка на уровне шаблонов доступна в Gutenberg уже несколько …

Подробнее

esc_textarea() – очищает строку для использования в теге

Функция производит следующие замены: Было Стало & (амперсанд) & ” (двойная кавычка) " ‘ (одинарная кавычка) ' < (меньше, чем, часть HTML тегов) < > (больше, чем, часть HTML тегов) > Кроме того, функция выполняет любые дополнительные преобразования, заданные в фильтре esc_textarea. Переносы строк останутся нетронутыми. Если уже преобразованная строка будет вновь передана в функцию, то …

Подробнее

esc_url() – проверяет и очищает URL

Функция заботится о безопасном выводе URL на экран, как в виде текста, так и качестве HTML атрибутов, например <img src=””>, <a href=””> и т.д. Никогда не выводите неочищенный URL в своём коде (узнайте, почему). Что конкретно делает функция: Удаляет пробелы на концах. Заменяет пробелы внутри на символы %20. Для всех протоколов кроме mailto удалит символы …

Подробнее

esc_url_raw()

Функция подготавливает (очищает) переданную в неё строку как URL для редиректов, HTTP-запросов и запросов к базе данных. Обратите внимание, что если вы хотите выводить URL на сайте или например использовать его в качестве HTML-атрибутов, то вам нужна другая функция – esc_url(). Как конкретно работает функция: Удаляет пробелы на концах. Заменяет пробелы внутри на символы %20. Для …

Подробнее

do_settings_sections() – выводит все секции и поля в них для указанной страницы настроек

Функция является частью Settings API в WordPress и используется в совокупности с другими функциями для создания страниц настроек, например settings_fields(), add_settings_section(), add_settings_field(), подробнее – в моём руководстве по страницам настроек. do_settings_sections( $page ) Параметры $page (строка) ярлык (идентификатор) страницы настроек. Важно отметить, что это значение должно совпадать с: Параметром $page (4-й параметр) функции add_settings_section(), Параметром …

Подробнее

register_setting() – регистрирует опцию

Функция регистрирует опцию, которую впоследствии можно вывести на страницах настроек при помощи функции add_settings_field(). По сути помогает предопределить поведение опции, например задав функцию для очистки значений и значение по умолчанию. register_setting( $option_group, $option_name, $args = array() ) Параметры $option_group (строка) Этим параметром определяется, где конкретно отображается поле данной опции. Например для кастомных страниц настроек он должен …

Подробнее

add_settings_field() – функция добавляет поле на страницу настроек

Функция является частью Settings API. Используйте эту функцию для добавления поля на страницу настроек, которое впоследствии будет выведено при помощи do_settings_sections() или do_settings_fields(). Также эта функция задаёт HTML поля. Важноый момент, прежде чем добавлять поле опции, вам нужно эту опцию сначала зарегистрировать функцией register_setting(). Иначе, поле выведется, но не будет сохраняться конечно же. И конечно …

Подробнее

add_settings_section() – добавляет секцию на страницу настроек

Функция является частью Settings API в WordPress и позволяет добавить секцию на стандартную или кастомную страницу настроек, в которой будут отображаться поля, причём эта секция может быть: Без заголовка, в ней будут отображаться только поля. С заголовком и со стандартной HTML-разметкой, которую даёт ей WordPress. Абсолютно с любым HTML, как мы захотим. И конечно же, …

Подробнее

submit_button()

Функция, которую вы можете использовать в админке WordPress для вывода кнопки в общем стиле админ-панели. Кнопка выводится HTML-тегом <input type=”submit” />. Не рекомендую использовать эту функцию за пределами админки, если вы не хотите столкнуться с ошибкой 500 (Call to undefined function submit_button()). Функцию довольно удобно использовать при создании кастомных страниц настроек в WordPress. Кстати, если …

Подробнее

add_settings_error()

Часть Settings API в WordPress. Регистрирует ошибку или уведомление для отображения на страницах настроек в админке (сохраняет в транзитный кэш, если быть точным). add_settings_error( $setting, $code, $message, $type = ‘error’ ) Параметры $setting (строка) Произвольный идентификатор группы ошибок. Должен совпадать с единственным параметром функции settings_errors(), которая как раз и позволяет вывести определённую группу ошибок. Однако, интересный …

Подробнее

settings_errors()

Является частью Settings API в WordPress. Позволяет вывести на страницах в админке уведомления и ошибки (в виде HTML), которые были добавлены функцией add_settings_error(). Вообще мы обычно используем эту функцию при создании каких-либо страниц настроек в админке, но тут есть важный момент, про который не нужно забывать – функция вызывается автоматически, если ваша страница настроек находится …

Подробнее

get_settings_errors()

Функция является частью Settings API в WordPress и возвращает массив уведомлений и ошибок для страниц настроек в админке. Уведомления и ошибки она получает из транзитного кэша, а добавлены они туда функцией add_settings_error(). В случае, если вызывается при успешном сохранении настроек (задана переменная $_GET[‘settings-updated’]), то все ошибки записываются в глобальную переменную $wp_settings_errors, а транзитный кэш очищается. …

Подробнее