WordPress как на ладони
wordpress jino

settings_fields() WP 2.7

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

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

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

Хуков нет.

Возвращает

Ничего не возвращает. Выводит на экран скрытые поля 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 настроек.

Код settings fields: wp-admin/includes/plugin.php WP 4.8.2

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

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

Из раздела: API Настроек

settings_fields Комментариев нет

Здравствуйте, !

Ваш комментарий