true,
)
);
$this->defaults = array(
'title' => '',
'number' => '6',
'post_type' => 'post',
'taxonomy' => '',
'terms' => '',
'terms_exclude' => '',
'order' => 'DESC',
'orderby' => 'date',
'columns' => '3',
'img_size' => 'wpex_custom',
'img_hover' => 'opacity',
'img_width' => '',
'img_height' => '',
'gap' => '',
'img_crop_location' => '',
);
}
/**
* Front-end display of widget.
*
* @see WP_Widget::widget()
*
* @param array $args Widget arguments.
* @param array $instance Saved values from database.
*/
public function widget( $args, $instance ) {
// Define output var
$output = '';
// Parse instance
extract( wp_parse_args( $instance, $this->defaults ) );
$img_hover_classes = wpex_image_hover_classes( $img_hover );
// Apply filters to the title
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
// Before widget WP hook
$output .= $args['before_widget'];
// Display title if defined
if ( $title ) {
$output .= $args['before_title'];
$output .= $title;
$output .= $args['after_title'];
}
// Gap
$gap = $gap ? ' gap-'. $gap : ' gap-10';
// Start output
$output .= '';
// Query args
$query_args = array(
'post_type' => $post_type,
'posts_per_page' => $number,
'meta_key' => '_thumbnail_id',
'no_found_rows' => true,
'tax_query' => array(
'relation' => 'AND',
),
);
// Order params - needs FALLBACK don't ever edit!
if ( ! empty( $orderby ) ) {
$query_args['order'] = $order;
$query_args['orderby'] = $orderby;
} else {
$query_args['orderby'] = $order; // THIS IS THE FALLBACK
}
// Tax Query
if ( ! empty( $taxonomy ) ) {
// Include Terms
if ( ! empty( $terms ) ) {
// Sanitize terms and convert to array
$terms = str_replace( ', ', ',', $terms );
$terms = explode( ',', $terms );
// Add to query arg
$query_args['tax_query'][] = array(
'taxonomy' => $taxonomy,
'field' => 'slug',
'terms' => $terms,
'operator' => 'IN',
);
}
// Exclude Terms
if ( ! empty( $terms_exclude ) ) {
// Sanitize terms and convert to array
$terms_exclude = str_replace( ', ', ',', $terms_exclude );
$terms_exclude = explode( ',', $terms_exclude );
// Add to query arg
$query_args['tax_query'][] = array(
'taxonomy' => $taxonomy,
'field' => 'slug',
'terms' => $terms_exclude,
'operator' => 'NOT IN',
);
}
}
// Exclude current post
if ( is_singular() ) {
$query_args['post__not_in'] = array( get_the_ID() );
}
// Query posts
$wpex_query = new WP_Query( $query_args );
// Set post counter variable
$count=0;
// Hover classes
$img_hover_classes = $img_hover_classes ? ' class="'. esc_attr( $img_hover_classes ) .'"' : '';
// Loop through posts
while ( $wpex_query->have_posts() ) : $wpex_query->the_post();
// Add to counter variable
$count++;
$output .= '- ';
$output .= '';
$output .= wpex_get_post_thumbnail( array(
'size' => $img_size,
'width' => $img_width,
'height' => $img_height,
'crop' => $img_crop_location,
) );
$output .= '';
$output .= '
';
// Reset counter to clear floats
if ( $count == $columns ) {
$count = '0';
}
// End loop
endwhile;
// Reset global query post data
wp_reset_postdata();
$output .= '
';
// After widget WP hook
$output .= $args['after_widget'];
echo $output;
}
/**
* Sanitize widget form values as they are saved.
*
* @see WP_Widget::update()
*
* @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;
$instance['title'] = ! empty( $new_instance['title'] ) ? strip_tags( $new_instance['title'] ) : '';
$instance['post_type'] = ! empty( $new_instance['post_type'] ) ? strip_tags( $new_instance['post_type'] ) : '';
$instance['taxonomy'] = ! empty( $new_instance['taxonomy'] ) ? strip_tags( $new_instance['taxonomy'] ) : '';
$instance['terms'] = ! empty( $new_instance['terms'] ) ? strip_tags( $new_instance['terms'] ) : '';
$instance['terms_exclude'] = ! empty( $new_instance['terms_exclude'] ) ? strip_tags( $new_instance['terms_exclude'] ) : '';
$instance['number'] = ! empty( $new_instance['number'] ) ? intval( $new_instance['number'] ) : '';
$instance['order'] = ! empty( $new_instance['order'] ) ? strip_tags( $new_instance['order'] ) : '';
$instance['orderby'] = ! empty( $new_instance['orderby'] ) ? strip_tags( $new_instance['orderby'] ) : '';
$instance['style'] = ! empty( $new_instance['style'] ) ? strip_tags( $new_instance['style'] ) : '';
$instance['img_hover'] = ! empty( $new_instance['img_hover'] ) ? strip_tags( $new_instance['img_hover'] ) : '';
$instance['img_size'] = ! empty( $new_instance['img_size'] ) ? strip_tags( $new_instance['img_size'] ) : 'wpex_custom';
$instance['img_height'] = ! empty( $new_instance['img_height'] ) ? intval( $new_instance['img_height'] ) : '';
$instance['img_width'] = ! empty( $new_instance['img_height'] ) ? intval( $new_instance['img_width'] ) : '';
$instance['img_crop_location'] = ! empty( $new_instance['img_crop_location'] ) ? strip_tags( $new_instance['img_crop_location'] ) : '';
$instance['columns'] = ! empty( $new_instance['columns'] ) ? strip_tags( $new_instance['columns'] ) : '';
$instance['gap'] = ! empty( $new_instance['gap'] ) ? strip_tags( $new_instance['gap'] ) : '';
return $instance;
}
/**
* Back-end widget form.
*
* @see WP_Widget::form()
*
* @param array $instance Previously saved values from database.
*/
public function form( $instance ) {
extract( wp_parse_args( $instance, $this->defaults ) ); ?>