settings_fields()

Примеры использования

Генерация полей настройки

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек
    settings_fields( 'my_settings_group' );
    
    // ...
    
    echo '</form>';
}

Функция settings_fields() используется для генерации полей настроек. Она выводит nonce, action и option_page поля для страницы настроек. В примере выше, функция settings_fields() вызывается с параметром 'my_settings_group', который должен соответствовать имени группы, указанной при регистрации настроек с помощью функции register_setting().

Создание формы настроек

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек
    settings_fields( 'my_settings_group' );
    
    // Выводим поля формы
    do_settings_sections( 'my_settings_page' );
    
    // ...
    
    echo '</form>';
}

После вызова функции settings_fields() можно использовать функцию do_settings_sections() для вывода полей формы. Функция do_settings_sections() принимает параметр 'my_settings_page', который должен соответствовать идентификатору страницы настроек, указанному при регистрации секций с помощью функции add_settings_section().

Проверка полей формы

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек
    settings_fields( 'my_settings_group' );
    
    // Выводим поля формы
    do_settings_sections( 'my_settings_page' );
    
    // Проверяем поля формы
    submit_button();
    
    // ...
    
    echo '</form>';
}

После вывода полей формы с помощью функции do_settings_sections(), можно добавить кнопку отправки формы с помощью функции submit_button(). При отправке формы, WordPress автоматически проверит значения полей формы и вызовет функцию обратного вызова, указанную при регистрации настроек с помощью функции register_setting().

Сохранение настроек

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек
    settings_fields( 'my_settings_group' );
    
    // Выводим поля формы
    do_settings_sections( 'my_settings_page' );
    
    // Проверяем поля формы
    submit_button();
    
    // Сохраняем настройки
    register_setting( 'my_settings_group', 'my_option_name' );
    
    // ...
    
    echo '</form>';
}

Для сохранения настроек, необходимо зарегистрировать настройку с помощью функции register_setting(). В примере выше, настройка с именем 'my_option_name' будет сохраняться при отправке формы. Значение настройки будет доступно в базе данных и может быть получено с помощью функции get_option().

Отображение полей формы

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек
    settings_fields( 'my_settings_group' );
    
    // Выводим поля формы
    do_settings_sections( 'my_settings_page' );
    
    // Проверяем поля формы
    submit_button();
    
    // Сохраняем настройки
    register_setting( 'my_settings_group', 'my_option_name' );
    
    // Выводим значение поля формы
    $value = get_option( 'my_option_name' );
    echo '<input type="text" name="my_option_name" value="' . esc_attr( $value ) . '">';
    
    // ...
    
    echo '</form>';
}

После вызова функции do_settings_sections(), можно использовать функции, такие как get_option(), для получения значений полей формы. В примере выше, значение поля формы будет получено с помощью функции get_option() и выведено в поле ввода.

Использование нескольких групп настроек

function my_settings_page() {
    // Выводим форму настроек
    echo '<form method="post" action="options.php">';
    
    // Генерируем поля настроек для первой группы
    settings_fields( 'my_settings_group_1' );
    
    // Выводим поля формы для первой группы
    do_settings_sections( 'my_settings_page_1' );
    
    // Генерируем поля настроек для второй группы
    settings_fields( 'my_settings_group_2' );
    
    // Выводим поля формы для второй группы
    do_settings_sections( 'my_settings_page_2' );
    
    // ...
    
    echo '</form>';
}

Функция settings_fields() может быть вызвана несколько раз для разных групп настроек. В примере выше, сначала генерируются поля настроек для первой группы с идентификатором 'my_settings_group_1', а затем для второй группы с идентификатором 'my_settings_group_2'. Аналогично, функция do_settings_sections() вызывается дважды для вывода полей формы для каждой группы настроек.