args = $args;
$widget_options = isset( $args['widget'] ) ? $args['widget'] : array();
$control_options = isset( $args['control'] ) ? $args['control'] : array();
$this->fields = isset( $args['fields'] ) ? $args['fields'] : array();
parent::__construct( $args['id'], $args['label'], $widget_options, $control_options );
}
/**
* Create form.
*
* @since 1.0.0
*
* @param array $instance Form settings.
*/
function form( $instance ) {
$this->create_form( $instance );
}
/**
* Return fields values.
*
* @since 1.0.0
*
* @param array $instance Form settings.
*/
function get_field_values( $instance ) {
$values = array();
$defaults = $this->get_default_field_values();
$values = array_merge( $defaults, $instance );
return $values;
}
/**
* Return default fields values.
*
* @since 1.0.0
*/
private function get_default_field_values() {
$default_values = array();
if ( ! empty( $this->fields ) ) {
foreach ( $this->fields as $key => $field ) {
$default_values[ $key ] = null;
if ( ! isset( $instance[ $key ] ) && isset( $field['default'] ) ) {
$default_values[ $key ] = $field['default'];
}
}
}
return $default_values;
}
/**
* Create form fields.
*
* @since 1.0.0
*
* @param array $instance Form settings.
*/
protected function create_form( $instance ) {
if ( ! $this->fields ) {
return;
}
$values = $this->get_field_values( $instance );
foreach ( $this->fields as $key => $field ) {
$this->create_form_field( $key, $field, $values[ $key ] );
}
}
/**
* Create single form field.
*
* @since 1.0.0
*
* @param string $key Field key.
* @param array $field Form field.
* @param mixed $value Form field value.
* @return void
*/
protected function create_form_field( $key, $field, $value ) {
$type = isset( $field['type'] ) ? $field['type'] : 'text';
$class = isset( $field['class'] ) ? sanitize_html_class( $field['class'] ) : '';
$field['rows'] = ( isset( $field['rows'] ) && absint( $field['rows'] ) > 0 ) ? absint( $field['rows'] ) : 5;
$field['placeholder'] = isset( $field['placeholder'] ) ? $field['placeholder'] : '';
$field['style'] = isset( $field['style'] ) ? $field['style'] : '';
$field['newline'] = ( isset( $field['newline'] ) && false === $field['newline'] ) ? false : true;
switch ( $type ) {
case 'text':
case 'email':
case 'url':
?>
' : ''; ?>
' : ''; ?>
style="" />
' : ''; ?>
' : ''; ?>
$label ) : ?>
get_field_name( $key );
$page_args['id'] = $this->get_field_id( $key );
$page_args['show_option_none'] = ( isset( $field['show_option_none'] ) ) ? esc_html( $field['show_option_none'] ) : '';
$page_args['class'] = esc_attr( $class );
?>
' : ''; ?>
get_field_name( $key );
$tax_args['id'] = $this->get_field_id( $key );
$tax_args['show_option_all'] = ( isset( $field['show_option_all'] ) ) ? esc_html( $field['show_option_all'] ) : '' ;
$tax_args['class'] = esc_attr( $class );
?>
' : ''; ?>
update_form( $new_instance, $old_instance );
return $instance;
}
/**
* Sanitize form field values.
*
* @since 1.0.0
*
* @param array $new_instance New settings.
* @param array $old_instance Old settings.
* @return array Sanitized settings.
*/
protected function update_form( $new_instance, $old_instance ) {
$instance = $old_instance;
foreach ( $this->fields as $key => $field ) {
$instance[ $key ] = $this->sanitize_field( $key, $field, $new_instance[ $key ] );
}
return $instance;
}
/**
* Sanitize single field.
*
* @since 1.0.0
*
* @param string $key Field key.
* @param array $field Form field.
* @param mixed $new_value New form field value.
* @return mixed Sanitized settings.
*/
protected function sanitize_field( $key, $field, $new_value ) {
$ret = null;
$field_type = isset( $field['type'] ) ? $field['type'] : 'text';
switch ( $field_type ) {
case 'text':
$ret = sanitize_text_field( $new_value );
break;
case 'number':
$ret = absint( $new_value );
break;
case 'color':
$ret = sanitize_text_field( $new_value );
break;
case 'image':
$ret = esc_url_raw( $new_value );
break;
case 'select':
$ret = sanitize_text_field( $new_value );
break;
case 'radio':
$ret = sanitize_text_field( $new_value );
break;
case 'textarea':
$ret = wp_kses_post( $new_value );
break;
case 'url':
$ret = esc_url_raw( $new_value );
break;
case 'email':
$ret = sanitize_email( $new_value );
break;
case 'dropdown-pages':
$ret = absint( $new_value );
break;
case 'dropdown-taxonomies':
$ret = absint( $new_value );
break;
case 'checkbox':
$ret = (bool) $new_value;
break;
default:
$ret = sanitize_text_field( $new_value );
break;
}
return $ret;
}
}
}