settings_fields()
Выводит скрытые поля формы на странице настроек (option_page, _wpnonce, ...).
Функция используется в связке с функциями из API настроек. В её задачи входит вывод всех необходимых полей для правильной работы и защиты формы.
Заметка: функция должна вызываться внутри тега <form>
для страницы опций.
Работает на основе: wp_nonce_field()
Хуков нет.
Возвращает
null
. Ничего не возвращает. Выводит на экран скрытые поля input.
Использование
settings_fields( $option_group );
- $option_group(строка) (обязательный)
- Название группы настроек. Должно совпадать с первым параметром $option_group из register_setting( $option_group, ... ).
Примеры
#1 settings_fields() выводит скрытые поля формы, поэтому она должна находиться внутри тега form:
<form method="POST" action="options.php"> <?php // slug страницы на которой выводится форма, // совпадает с названием группы ($option_group) в API опций settings_fields( 'my-page' ); // slug страницы на которой выводится форма do_settings_sections( 'my-page' ); submit_button(); ?> </form>
#2 Еще примеры
Другие примеры использования смотрите в примерах, на странице API настроек.
Список изменений
С версии 2.7.0 | Введена. |
Код settings_fields() settings fields WP 6.7.1
function settings_fields( $option_group ) { echo "<input type='hidden' name='option_page' value='" . esc_attr( $option_group ) . "' />"; echo '<input type="hidden" name="action" value="update" />'; wp_nonce_field( "$option_group-options" ); }