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

Функция выводит скрытые поля <input type="hidden" />, а именно:

• скрытое поле с названием группы настроек,
• скрытое поле со значением action, а точнее <input type="hidden" name="action" value="update" />,
• скрытое поле с одноразовым числом.

settings_fields( $option_group )

Параметры

$option_group

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

Пример

Лучше всего можно понять действие этой функции вы можете почитав моё руководство по созданию страниц настроек в WordPress.

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

add_action( 'admin_menu', function(){
 
	add_submenu_page( 'options-general.php', 'Ещё настройки', 'Ещё настройки', 'manage_options', 'true_options_page', 'true_options_callback' );
 
} );
 
function true_options_callback(){
 
	echo '<div class="wrap"><p>Сама страница настроек к слову пустая.</p>
	<form method="post" action="options.php">';
 
		settings_fields( 'true_options' );
 
		// ... продолжение страницы настроек
 
	echo '</form></div>';
 
}

Не знаете, куда вставлять код?

Обратите внимание на четыре скрытых поля, появившихся внутри тега <form> (да, settings_fields() всегда нужно использовать только внутри этого тега).