Функция SETTINGS_FIELDS() в WordPress: синтаксис, примеры использования, изменения

# Функция SETTINGS_FIELDS() в WordPress

Функция settings_fields() используется для генерации скрытых полей формы на странице настроек в WordPress. Это необходимо для защиты данных, которые пользователь отправляет через форму. Функция создает несколько важных полей, которые помогают идентифицировать форму и предотвратить несанкционированные действия.

## Основные моменты

- **Выводит**: nonce (защитный токен), действие и поля для страницы настроек.
- **Не использует хуки.**
- **Возвращает**: ничего (null).

## Синтаксис использования

Функция вызывается следующим образом:

```php
settings_fields( $option_group );

• $option_group (строка) - обязательный параметр. Это имя группы настроек. Оно должно соответствовать имени группы, которую вы использовали в функции register_setting().

Примеры использования

Пример 1

Функция settings_fields() должна находиться внутри тега <form>, как показано ниже:

Этот код создает форму, где с помощью settings_fields() добавляются необходимые скрытые поля.

Пример 2

Дополнительные примеры использования можно найти в документации API настроек, где приводятся различные сценарии работы с функцией settings_fields().

Изменения

Функция была введена в версии WordPress 2.7.0.

Код функции

Вот код функции settings_fields() из файла wp-admin/includes/plugin.php:

function settings_fields( $option_group ) {
echo "";
echo '';
wp_nonce_field( "$option_group-options" );
}

Связанные функции

Функция settings_fields() тесно связана с другими функциями API настроек:

• add_settings_error()
• add_settings_field()
• add_settings_section()
• do_settings_fields()
• do_settings_sections()
• get_settings_errors()
• register_setting()
• settings_errors()
• unregister_setting()

Эти функции помогут вам добавить, управлять и отображать настройки на странице вашей админки WordPress.