PHP Класс WC_Settings_API

Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$errors Validation errors.
$form_fields array Form option fields.
$id string ID of the class extending the settings API. Used in option names.
$plugin_id string The plugin ID. Used for option names.
$settings array Setting values.

Защищенные свойства (Protected)

Свойство Тип Описание
$data array The posted settings data. When empty, $_POST data will be used.

Открытые методы

Метод Описание
add_error ( string $error ) Add an error message for display in admin on save.
admin_options ( ) Output the admin options table.
display_errors ( ) Display admin error messages.
format_settings ( array $value ) : array Format settings if needed.
generate_checkbox_html ( mixed $key, mixed $data ) : string Generate Checkbox HTML.
generate_color_html ( mixed $key, mixed $data ) : string Generate Color Picker Input HTML.
generate_decimal_html ( mixed $key, mixed $data ) : string Generate Decimal Input HTML.
generate_multiselect_html ( mixed $key, mixed $data ) : string Generate Multiselect HTML.
generate_password_html ( mixed $key, mixed $data ) : string Generate Password Input HTML.
generate_price_html ( mixed $key, mixed $data ) : string Generate Price Input HTML.
generate_select_html ( mixed $key, mixed $data ) : string Generate Select HTML.
generate_settings_html ( array $form_fields = [], $echo = true ) : string Generate Settings HTML.
generate_text_html ( mixed $key, mixed $data ) : string Generate Text Input HTML.
generate_textarea_html ( mixed $key, mixed $data ) : string Generate Textarea HTML.
generate_title_html ( mixed $key, mixed $data ) : string Generate Title HTML.
get_custom_attribute_html ( array $data ) : string Get custom attributes.
get_description_html ( array $data ) : string Get HTML for descriptions.
get_errors ( ) Get admin error messages.
get_field_default ( array $field ) : string Get a fields default value. Defaults to "" if not set.
get_field_key ( mixed $key ) : string Prefix key for settings.
get_field_type ( array $field ) : string Get a fields type. Defaults to "text" if not set.
get_field_value ( string $key, array $field, array $post_data = [] ) : string Get a field's posted and validated value.
get_form_fields ( ) : array Get the form fields after they are initialized.
get_option ( string $key, mixed $empty_value = null ) : string get_option function.
get_option_key ( ) : string Return the name of the option in the WP DB.
get_post_data ( ) : array Returns the POSTed data, to be used to save the settings.
get_tooltip_html ( array $data ) : string Get HTML for tooltips.
init_form_fields ( ) : string Initialise settings form fields.
init_settings ( ) Initialise Settings.
process_admin_options ( ) : boolean Processes and saves options.
set_post_data ( $data = [] ) Sets the POSTed data. This method can be used to set specific data, instead of taking it from the $_POST array.
validate_checkbox_field ( string $key, string | null $value ) : string Validate Checkbox Field.
validate_decimal_field ( string $key, string | null $value ) : string Validate Decimal Field.
validate_multiselect_field ( string $key, string $value ) : string Validate Multiselect Field.
validate_password_field ( string $key, string | null $value ) : string Validate Password Field. No input sanitization is used to avoid corrupting passwords.
validate_price_field ( string $key, string | null $value ) : string Validate Price Field.
validate_select_field ( string $key, string $value ) : string Validate Select Field.
validate_settings_fields ( $form_fields = [] ) Validate the data on the "Settings" form.
validate_text_field ( string $key, string | null $value ) : string Validate Text Field.
validate_textarea_field ( string $key, string | null $value ) : string Validate Textarea Field.

Защищенные методы

Метод Описание
set_defaults ( $field ) Set default required properties for each field.

Описание методов

add_error() публичный Метод

Add an error message for display in admin on save.
public add_error ( string $error )
$error string

admin_options() публичный Метод

Output the admin options table.
public admin_options ( )

display_errors() публичный Метод

Display admin error messages.
public display_errors ( )

format_settings() публичный Метод

Format settings if needed.
Устаревший: 2.6.0 Unused
public format_settings ( array $value ) : array
$value array
Результат array

generate_checkbox_html() публичный Метод

Generate Checkbox HTML.
С версии: 1.0.0
public generate_checkbox_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_color_html() публичный Метод

Generate Color Picker Input HTML.
С версии: 1.0.0
public generate_color_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_decimal_html() публичный Метод

Generate Decimal Input HTML.
С версии: 1.0.0
public generate_decimal_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_multiselect_html() публичный Метод

Generate Multiselect HTML.
С версии: 1.0.0
public generate_multiselect_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_password_html() публичный Метод

Generate Password Input HTML.
С версии: 1.0.0
public generate_password_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_price_html() публичный Метод

Generate Price Input HTML.
С версии: 1.0.0
public generate_price_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_select_html() публичный Метод

Generate Select HTML.
С версии: 1.0.0
public generate_select_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_settings_html() публичный Метод

Generate the HTML for the fields on the "settings" screen.
С версии: 1.0.0
public generate_settings_html ( array $form_fields = [], $echo = true ) : string
$form_fields array (default: array())
Результат string the html for the settings

generate_text_html() публичный Метод

Generate Text Input HTML.
С версии: 1.0.0
public generate_text_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_textarea_html() публичный Метод

Generate Textarea HTML.
С версии: 1.0.0
public generate_textarea_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

generate_title_html() публичный Метод

Generate Title HTML.
С версии: 1.0.0
public generate_title_html ( mixed $key, mixed $data ) : string
$key mixed
$data mixed
Результат string

get_custom_attribute_html() публичный Метод

Get custom attributes.
public get_custom_attribute_html ( array $data ) : string
$data array
Результат string

get_description_html() публичный Метод

Get HTML for descriptions.
public get_description_html ( array $data ) : string
$data array
Результат string

get_errors() публичный Метод

Get admin error messages.
public get_errors ( )

get_field_default() публичный Метод

Get a fields default value. Defaults to "" if not set.
public get_field_default ( array $field ) : string
$field array
Результат string

get_field_key() публичный Метод

Prefix key for settings.
public get_field_key ( mixed $key ) : string
$key mixed
Результат string

get_field_type() публичный Метод

Get a fields type. Defaults to "text" if not set.
public get_field_type ( array $field ) : string
$field array
Результат string

get_field_value() публичный Метод

Get a field's posted and validated value.
public get_field_value ( string $key, array $field, array $post_data = [] ) : string
$key string
$field array
$post_data array
Результат string

get_form_fields() публичный Метод

Get the form fields after they are initialized.
public get_form_fields ( ) : array
Результат array of options

get_option() публичный Метод

Gets an option from the settings API, using defaults if necessary to prevent undefined notices.
public get_option ( string $key, mixed $empty_value = null ) : string
$key string
$empty_value mixed
Результат string The value specified for the option or a default value for the option.

get_option_key() публичный Метод

Return the name of the option in the WP DB.
С версии: 2.6.0
public get_option_key ( ) : string
Результат string

get_post_data() публичный Метод

Returns the POSTed data, to be used to save the settings.
public get_post_data ( ) : array
Результат array

get_tooltip_html() публичный Метод

Get HTML for tooltips.
public get_tooltip_html ( array $data ) : string
$data array
Результат string

init_form_fields() публичный Метод

Add an array of fields to be displayed on the gateway's settings screen.
С версии: 1.0.0
public init_form_fields ( ) : string
Результат string

init_settings() публичный Метод

Store all settings in a single database entry and make sure the $settings array is either the default or the settings stored in the database.
С версии: 1.0.0
public init_settings ( )

process_admin_options() публичный Метод

If there is an error thrown, will continue to save and validate fields, but will leave the erroring field out.
public process_admin_options ( ) : boolean
Результат boolean was anything saved?

set_defaults() защищенный Метод

Set default required properties for each field.
protected set_defaults ( $field )

set_post_data() публичный Метод

Sets the POSTed data. This method can be used to set specific data, instead of taking it from the $_POST array.
public set_post_data ( $data = [] )

validate_checkbox_field() публичный Метод

If not set, return "no", otherwise return "yes".
public validate_checkbox_field ( string $key, string | null $value ) : string
$key string
$value string | null Posted Value
Результат string

validate_decimal_field() публичный Метод

Make sure the data is escaped correctly, etc.
public validate_decimal_field ( string $key, string | null $value ) : string
$key string
$value string | null Posted Value
Результат string

validate_multiselect_field() публичный Метод

Validate Multiselect Field.
public validate_multiselect_field ( string $key, string $value ) : string
$key string
$value string Posted Value
Результат string

validate_password_field() публичный Метод

Validate Password Field. No input sanitization is used to avoid corrupting passwords.
public validate_password_field ( string $key, string | null $value ) : string
$key string
$value string | null Posted Value
Результат string

validate_price_field() публичный Метод

Make sure the data is escaped correctly, etc.
public validate_price_field ( string $key, string | null $value ) : string
$key string
$value string | null Posted Value
Результат string

validate_select_field() публичный Метод

Validate Select Field.
public validate_select_field ( string $key, string $value ) : string
$key string
$value string Posted Value
Результат string

validate_settings_fields() публичный Метод

Validate the data on the "Settings" form.
Устаревший: 2.6.0 No longer used
public validate_settings_fields ( $form_fields = [] )

validate_text_field() публичный Метод

Make sure the data is escaped correctly, etc.
public validate_text_field ( string $key, string | null $value ) : string
$key string Field key
$value string | null Posted Value
Результат string

validate_textarea_field() публичный Метод

Validate Textarea Field.
public validate_textarea_field ( string $key, string | null $value ) : string
$key string
$value string | null Posted Value
Результат string

Описание свойств

$data защищенное свойство

The posted settings data. When empty, $_POST data will be used.
protected array $data
Результат array

$errors публичное свойство

Validation errors.
public $errors

$form_fields публичное свойство

Form option fields.
public array $form_fields
Результат array

$id публичное свойство

ID of the class extending the settings API. Used in option names.
public string $id
Результат string

$plugin_id публичное свойство

The plugin ID. Used for option names.
public string $plugin_id
Результат string

$settings публичное свойство

Setting values.
public array $settings
Результат array