name = wp_strip_all_tags( $args['name'] );
$this->id_base = wp_strip_all_tags( $args['id_base'] );
$this->options = isset( $args['options'] ) ? $args['options'] : '';
$this->fields = $args['fields'];
// Add filter to options
$this->options = apply_filters( $this->id_base . '_widget_options', $this->options );
// Call WP_Widget to create the widget
parent::__construct(
$this->id_base,
$this->name,
$this->options
);
}
/**
* Return default values.
*
* @since 1.0
*
* @access public
* @return array $defaults Returns the default arguments for this widget.
*/
public function get_defaults() {
if ( empty( $this->fields ) || ! is_array( $this->fields ) ) {
return;
}
$defaults = array();
foreach ( $this->fields as $field ) {
if ( empty( $field['default'] ) && isset( $field['choices'] ) && is_array( $field['choices'] ) ) {
reset( $field['choices'] );
$field['default'] = key( $field['choices'] );
}
$defaults[$field['id']] = isset( $field['default'] ) ? $field['default'] : '';
}
return $defaults;
}
/**
* Parse insance for live output.
*
* @since 1.0
*
* @access public
* @return array $instance Returns the current widget instance.
*/
public function parse_instance( $instance ) {
$defaults = $this->get_defaults();
$instance = wp_parse_args( $instance, $defaults );
foreach ( $instance as $k => $v ) {
if ( ! isset( $v ) && isset( $defaults[$k] ) ) {
$instance[$k] = $defaults[$k];
}
}
return $instance;
}
/**
* Output widget title
*
* @since 1.0
*
* @access public
* @return array $instance Returns the current widget instance.
*/
public function widget_title( $args, $instance ) {
if ( ! empty( $instance['title'] ) ) {
echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'] ) . $args['after_title'];
}
}
/**
* Sanitize widget form values as they are saved.
*
* @see WP_Widget::update()
* @since 1.0
*
* @param array $new_instance Values just sent to be saved.
* @param array $old_instance Previously saved values from database.
*
* @return array Updated safe values to be saved.
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
foreach ( $this->fields as $field ) {
$field_id = $field['id'];
$field_type = $field['type'];
$field_val = isset( $new_instance[$field_id] ) ? $new_instance[$field_id] : null;
$default = isset( $field['default'] ) ? $field['default'] : '';
if ( 'notice' == $field_type ) {
continue;
}
/* Field has value */
if ( $field_val ) {
// Save checkbox field
if ( 'checkbox' == $field_type ) {
$instance[$field_id] = (bool) true;
}
// Save select field
elseif ( 'select' == $field_type ) {
$array_to_check = array();
if ( is_array( $field['choices'] ) ) {
$array_to_check = $field['choices'];
} else {
$method = 'choices_' . $field['choices'];
if ( method_exists( $this, $method ) ) {
$array_to_check = $this->$method( $field );
}
}
$instance[$field_id] = ( array_key_exists( $field_val, $array_to_check ) ? $field_val : $default );
}
// Save repeater field
elseif ( 'repeater' == $field_type ) {
$fields = $field[ 'fields' ];
$new_val = array();
foreach ( $fields as $field_k => $field_v ) {
$subfield_id = $field_v[ 'id' ];
$subfield_type = $field_v[ 'type' ];
$field_vals = $field_val[$subfield_id];
$count = 1;
foreach( $field_vals as $field_vals_k => $field_vals_v ) {
if ( $count == count( $field_vals ) ) {
continue;
}
$count++;
if ( function_exists( 'wpex_sanitize_data' ) ) {
$field_vals_v = wpex_sanitize_data( $field_vals_v, $subfield_type );
} else {
$field_vals_v = wp_strip_all_tags( $field_vals_v );
}
$new_val[$field_vals_k][$subfield_id] = $field_vals_v;
}
}
$instance[$field_id] = $new_val;
} else {
$sanitize = isset( $field['sanitize'] ) ? $field['sanitize'] : $field_type;
if ( 'text' == $field_type || 'image' == $field_type || 'media_upload' == $field_type ) {
$sanitize = 'text_field';
}
if ( function_exists( 'wpex_sanitize_data' ) ) {
$instance[$field_id] = wpex_sanitize_data( $field_val, $sanitize );
} else {
$instance[$field_id] = wp_strip_all_tags( $field_val );
}
}
}
/* Field value is empty */
else {
if ( 'checkbox' == $field_type ) {
$instance[$field_id] = (bool) false;
} else {
$instance[$field_id] = '';
}
}
}
return $instance;
}
/**
* Back-end widget form.
*
* @since 1.0
*
* @see WP_Widget::form()
*
* @param array $instance Previously saved values from database.
*/
public function form( $instance ) {
echo '';
foreach ( $this->fields as $field ) {
$id = $field['id'];
$field['class'] = 'widefat';
$field['id'] = $this->get_field_id( $id );
$field['name'] = $this->get_field_name( $id );
if ( empty( $instance ) ) {
$default = isset( $field['std'] ) ? $field['std'] : ''; // new instance
$default = isset( $field['default'] ) ? $field['default'] : $default;
} else {
$default = isset( $field['default'] ) ? $field['default'] : ''; // already saved instance
}
$field['value'] = isset( $instance[$id] ) ? $instance[$id] : $default;
$this->add_field( $field );
}
echo '
';
}
/**
* Adds a new field to the admin form.
*
* @since 1.0
*
* @access public
* @param array $field Field parameters.
* @return string
*/
public function add_field( $field ) {
$type = isset( $field['type' ] ) ? $field['type' ] : '';
$method_name = 'field_' . $type;
$description = '';
if ( method_exists( $this, $method_name ) ) {
if ( isset( $field['description'] ) && 'notice' != $type ) {
$description = '
' . wp_kses_post( $field['description'] ) . '';
}
echo '' . $this->$method_name( $field ) . $description . '
';
}
}
/**
* Return field label for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_label( $field, $semicolon = true ) {
if ( empty( $field['repeater'] ) ) {
$for = ' for="' . esc_attr( $field['id'] ) . '"';
} else {
$for = '';
}
$output = '';
return $output;
}
/**
* Return notice type field.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_notice( $field, $output = '' ) {
$output .= '';
$output .= 'Notice: ' . esc_html( $field['description'] );
$output .= '
';
return $output;
}
/**
* Return text field for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_text( $field, $output = '' ) {
$output .= $this->field_label( $field );
$output .= 'field_label( $field );
$output .= 'field_label( $field );
$output .= 'field_label( $field );
$output .= '';
return $output;
}
/**
* Return repeater field for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_repeater( $field, $output = '' ) {
if ( empty( $field[ 'fields' ] ) ) {
return;
}
$fields = $field[ 'fields' ];
$default = isset( $field[ 'default' ] ) ? $field[ 'default' ] : '';
$value = isset( $field[ 'value' ] ) ? $field[ 'value' ] : $default;
if ( empty( $fields ) || ! is_array( $fields ) ) {
return;
}
$output .= '' . $this->field_label( $field ) . '
';
$output .= '';
// Add button
$output .= '' . esc_html__( 'Add New', 'total-theme-core' ) . '
';
// Add the cloner item
$output .= '';
foreach ( $fields as $subfield ) {
$subfield[ 'name' ] = $field[ 'name' ] . '[' . $subfield[ 'id' ] . '][]'; // same name for each
$subfield[ 'value' ] = '';
$method = 'field_' . $subfield['type'];
if ( method_exists( $this, $method ) ) {
$output .= '
' . $this->$method( $subfield ) . '
';
}
}
$output .= '
';
if ( $value && is_numeric( $value ) ) {
$output .= '' . esc_html__( 'Edit template', 'total-theme-core' ) . ' | ';
}
$output .= '' . esc_html__( 'Create new template', 'total-theme-core' ) . '';
$output .= '
';
return $output;
}
/**
* Return checkbox field for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_checkbox( $field, $output = '' ) {
$output .= 'field_label( $field, false );
return $output;
}
/**
* Return number field for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function field_number( $field, $output = '' ) {
$output .= $this->field_label( $field );
$output .= ' true,
), 'objects', 'and' );
foreach ( $get_types as $key => $val ) {
$types[$key] = $val->labels->name;
}
return $types;
}
/**
* Return taxonomies choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_taxonomies() {
$taxonomies = array(
'' => '— ' . esc_html( 'Select', 'total-theme-core' ) . ' —'
);
$get_taxonomies = get_taxonomies( array(
'public' => true,
), 'objects' );
foreach ( $get_taxonomies as $get_taxonomy ) {
$taxonomies[ $get_taxonomy->name ] = ucfirst( $get_taxonomy->labels->singular_name );
}
return $taxonomies;
}
/**
* Return query_orderby choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_query_orderby() {
return array(
'date' => esc_html__( 'Date', 'total-theme-core' ),
'title' => esc_html__( 'Title', 'total-theme-core' ),
'modified' => esc_html__( 'Modified', 'total-theme-core' ),
'author' => esc_html__( 'Author', 'total-theme-core' ),
'rand' => esc_html__( 'Random', 'total-theme-core' ),
'comment_count' => esc_html__( 'Comment Count', 'total-theme-core' ),
);
}
/**
* Return query_order choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_query_order() {
return array(
'desc' => esc_html__( 'Descending', 'total-theme-core' ),
'asc' => esc_html__( 'Ascending', 'total-theme-core' ),
);
}
/**
* Return categories choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_categories() {
$choices = array(
'' => '— ' . esc_html( 'Select', 'total-theme-core' ) . ' —',
);
$terms = get_terms( 'category' );
if ( $terms ) {
foreach ( $terms as $term ) {
$choices[ $term->term_id ] = $term->name;
}
}
return $choices;
}
/**
* Return intermediate_image_sizes choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_intermediate_image_sizes( $field ) {
if ( isset( $field['exclude_custom'] ) ) {
$sizes = array( '' => esc_html__( 'Default', 'total-theme-core' ) );
} else {
$sizes = array( 'wpex-custom' => esc_html__( 'Custom', 'total-theme-core' ) );
}
$get_sizes = array_keys( $this->get_intermediate_sizes() );
$sizes = $sizes + array_combine( $get_sizes, $get_sizes );
return $sizes;
}
/**
* Return intermediate_image_sizes choices for admin form.
*
* @since 1.0
*
* @access private
* @return array
*/
private function get_intermediate_sizes() {
if ( function_exists( 'wpex_get_thumbnail_sizes' ) ) {
return wpex_get_thumbnail_sizes();
}
$size = '';
global $_wp_additional_image_sizes;
$sizes = array(
'full' => array(
'width' => '9999',
'height' => '9999',
'crop' => 0,
),
);
$get_intermediate_image_sizes = get_intermediate_image_sizes();
// Create the full array with sizes and crop info
foreach( $get_intermediate_image_sizes as $_size ) {
if ( in_array( $_size, array( 'thumbnail', 'medium', 'large' ) ) ) {
$sizes[ $_size ]['width'] = get_option( $_size . '_size_w' );
$sizes[ $_size ]['height'] = get_option( $_size . '_size_h' );
$sizes[ $_size ]['crop'] = (bool) get_option( $_size . '_crop' );
} elseif ( isset( $_wp_additional_image_sizes[ $_size ] ) ) {
$sizes[ $_size ] = array(
'width' => $_wp_additional_image_sizes[ $_size ]['width'],
'height' => $_wp_additional_image_sizes[ $_size ]['height'],
'crop' => $_wp_additional_image_sizes[ $_size ]['crop']
);
}
}
// Get only 1 size if found
if ( $size ) {
if ( isset( $sizes[ $size ] ) ) {
return $sizes[ $size ];
} else {
return false;
}
}
// Return sizes
return $sizes;
}
/**
* Return image_crop_locations choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_image_crop_locations() {
return function_exists( 'wpex_image_crop_locations' ) ? wpex_image_crop_locations() : array();
}
/**
* Return image_hovers choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_image_hovers() {
return function_exists( 'wpex_image_hovers' ) ? wpex_image_hovers() : array();
}
/**
* Return menus choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_menus() {
$menus = array();
$get_menus = get_terms( 'nav_menu', array(
'hide_empty' => false,
) );
if ( ! empty( $get_menus ) ) {
foreach ( $get_menus as $menu ) {
$menus[$menu->term_id] = $menu->name;
}
}
return $menus;
}
/**
* Return posts choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_posts( $field ) {
$posts = array();
$ids = new WP_Query( array(
'post_type' => $field['post_type'],
'posts_per_page' => -1,
'fields' => 'ids',
'no_found_rows' => true,
) );
if ( $ids->have_posts() ) {
foreach ( $ids->posts as $post_id ) {
$posts[$post_id] = get_post_field( 'post_title', $post_id, 'raw' );
}
}
return $posts;
}
/**
* Return grid_columns choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_grid_columns() {
return function_exists( 'wpex_grid_columns' ) ? wpex_grid_columns() : array();
}
/**
* Return grid_gaps choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_grid_gaps() {
return function_exists( 'wpex_column_gaps' ) ? wpex_column_gaps() : array();
}
/**
* Return link_target choices for admin form.
*
* @since 1.0
*
* @access private
* @return string
*/
private function choices_link_target() {
return array(
'_self' => esc_html__( 'Current window', 'total-theme-core' ),
'_blank' => esc_html__( 'New window', 'total-theme-core' ),
);
}
}