settings_fields()
Виводить приховані поля форми на сторінці опцій (option_page, _wpnonce, …).
Функція використовується у зв’язку з функціями API налаштувань . У її завдання входить виведення всіх необхідних полів для правильної роботи та захисту форми.
Примітка: функція повинна викликатись усередині тега <form>для сторінки опцій.
Працює на основі:
wp_nonce_field()
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.0.2
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");
}