Функция FORM_OPTION() │ WP 1.5.0

Функция form_option() используется для отображения очищенного значения настроек в WordPress. Она позволяет безопасно выводить значение, которое определено в настройках сайта, и применяется, например, для атрибута value тега <input>.

Как работает функция

При выводе значения, функция использует метод esc_attr(), чтобы убедиться, что выводимое значение безопасно для отображения в HTML.

Использование функции

Синтаксис:

form_option( $option );

Параметры:

• $option (строка, обязательный) — имя настройки, значение которой будет получено.

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

Функция form_option() часто применяется в файле options-media.php, который отвечает за настройки медиа в админ-панели. Приведём один из примеров кода:

    
        
    
    
        

            

                
                    
                
            

            
                
            
            
            


            
                
            
            
        

        />
        
            
        
    

Как видите, в этом примере кода

• Определяются поля для ввода ширины и высоты миниатюры.
• Значения для этих полей получаются с помощью функции form_option().

История изменений

С версии: 1.5.0 — функция была добавлена.

Код функции FORM_OPTION

Вот как выглядит реализация функции form_option() в файле wp-includes/option.php:

function form_option( $option ) {
echo esc_attr( get_option( $option ) );
}

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

При использовании функции form_option(), также могут быть полезны эти функции:

• checked() — отметка чекбокса в зависимости от значения.
• disabled() — отключение элемента формы.
• selected() — выбор элемента в списке.
• wp_readonly() — установка поля в режим "только для чтения".
• wp_referer_field() — скрытое поле с URL страницы для возврата.

Теперь у вас есть все необходимые данные, чтобы использовать функцию form_option() и создавать настраиваемые формы в WordPress.