API настроек

wordpress-plugin-settings

Обзор

API настроек, добавлены в WordPress 2.7, позволяет администраторcким страницам, содержащим формы настроек, управляться в полуавтоматическом режиме. Это позволяет определить настройки страниц, разделы в пределах этих страниц и полей в секциях.

Новые настройки страниц могут быть зарегистрированы вместе с секциями и полями внутри них. Существующие настройки страниц также могут быть добавлены при регистрации новых разделов настроек или полей внутри них.

Организация регистрации и проверки полей по-прежнему требует некоторых усилий от разработчиков, использующих API настроек, но позволяет избегать множества сложностей отладки базовых вариантов управления.

Зачем использовать API настроек?

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

Визуальная последовательность

Использование API для генерации элементов интерфейса гарантирует, что ваша страница настроек будет выглядеть подобно остальной административной части. Вы когда-нибудь видели страницу настроек плагина, которая выглядела так, как будто она была разработана 5-летним ребенком? Можно поспорить, что разработчик не использовал API. Итак, сильный аргумент, что ваш интерфейс будет выглядеть как следует, и благодаря команде дизайнеров WordPress, он будет выглядеть потрясающе!

Надежность (перспективность!)

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

Меньше работы!

Конечно самое непосредственное преимущество в том, что API WordPress делает много работы за вас под капотом. Вот несколько примеров того, что API настроек делает, кроме применения прекрасного вида и интегрированного дизайна.

  • Обработка форм — Позвольте WordPress управлять извлечением и хранением ваших $_POST запросов.
  • Включает в себя меры безопасности — вы получите дополнительные меры безопасности, такие как одноразовые числа, и т.п. бесплатно.
  • Обработка данных — Вы получаете доступ к тем же методам, которые WordPress использует для обеспечения безопасного использования строк.

Справочник по функциям

Регистрация/Дерегистрация Добавление полей/секций
register_setting() (codex)
unregister_setting() (codex)
add_settings_field() (codex)
add_settings_section() (codex)
Опции представления форм Ошибки
settings_fields() (codex)
do_settings_sections() (codex)
do_settings_fields() (codex)
add_settings_error() (codex)
get_settings_errors() (codex)
settings_errors() (codex)
Навигация по разделам:

Оставить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *