settings_fields()WP 2.7.0

Выводит скрытые поля формы на странице настроек (option_page, _wpnonce, ...).

Функция используется в связке с функциями из API настроек. В её задачи входит вывод всех необходимых полей для правильной работы и защиты формы.

Заметка: функция должна вызываться внутри тега <form> для страницы опций.

Работает на основе: wp_nonce_field()

Хуков нет.

Возвращает

null. Ничего не возвращает. Выводит на экран скрытые поля input.

Использование

settings_fields( $option_group );
$option_group(строка) (обязательный)
Название группы настроек. Должно совпадать с первым параметром $option_group из register_setting( $option_group, ... ).

Примеры

0

#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>
0

#2 Еще примеры

Другие примеры использования смотрите в примерах, на странице API настроек.

Список изменений

С версии 2.7.0 Введена.

Код settings_fields() WP 6.4.3

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" );
}