defaults = array(
'title' => '',
'number' => '3',
'style' => 'default',
'post_type' => 'post',
'taxonomy' => '',
'terms' => '',
'terms_exclude' => '',
'order' => 'DESC',
'orderby' => 'date',
'columns' => '3',
'img_size' => 'wpex_custom',
'img_hover' => '',
'img_width' => '',
'img_height' => '',
'date' => '',
'excerpt_length' => '0',
'thumbnail_query' => true,
'img_crop_location' => '',
);
// Construtor
$branding = wpex_get_theme_branding();
$branding = $branding ? $branding . ' - ' : '';
parent::__construct(
'wpex_recent_posts_thumb',
$branding . esc_html__( 'Posts With Thumbnails', 'total' ),
array(
'customize_selective_refresh' => true,
)
);
}
/**
* Front-end display of widget.
*
* @since 1.0.0
*/
public function widget( $args, $instance ) {
// Parse instance
extract( wp_parse_args( $instance, $this->defaults ) );
// Define output
$output = '';
// Apply filters to the title
$title = isset( $instance['title'] ) ? apply_filters( 'widget_title', $instance['title'] ) : '';
// Before widget WP hook
$output .= $args['before_widget'];
// Display title if defined
if ( $title ) {
$output .= $args['before_title'];
$output .= esc_html( $title );
$output .= $args['after_title'];
}
// Query posts
$query_args = array(
'post_type' => $post_type,
'posts_per_page' => $number,
'no_found_rows' => true,
'tax_query' => array(
'relation' => 'AND',
),
);
// Query by thumbnail meta_key
if ( $thumbnail_query ) {
$query_args['meta_key'] = '_thumbnail_id';
}
// 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 );
// If there are posts loop through them
if ( $wpex_query->have_posts() ) :
// Begin entries output
$output .= '';
// Loop through posts
while ( $wpex_query->have_posts() ) : $wpex_query->the_post();
// Check thumb
$has_thumb = has_post_thumbnail();
// Li classes
$li_classes = 'wpex-widget-recent-posts-li clr';
if ( ! $has_thumb ) {
$li_classes .= ' wpex-no-thumb';
}
// Output entry
$output .= '- ';
// Get post data
$permalink = wpex_get_permalink();
$esc_title = wpex_get_esc_title();
// Display thumbnail
if ( $has_thumb ) :
// Thumb chasses
$thumb_classes = 'wpex-widget-recent-posts-thumbnail';
if ( $img_hover = esc_attr( $img_hover ) ) {
$thumb_classes .= ' ' . wpex_image_hover_classes( $img_hover );
}
$output .= '';
$output .= wpex_get_post_thumbnail( array(
'size' => $img_size,
'width' => $img_width,
'height' => $img_height,
'crop' => $img_crop_location,
) );
$output .= '';
endif;
$output .= '
';
$output .= '
' . esc_html( get_the_title() ) . '';
// Display date if enabled
if ( '1' != $date ) :
$output .= '
' . get_the_date() . '
';
endif;
// Display excerpt
if ( intval( $excerpt_length ) && 0 !== $excerpt_length ) {
$excerpt = wpex_get_excerpt( array(
'length' => $excerpt_length,
'context' => 'wpex_recent_posts_thumb_widget',
'custom_excerpts' => false,
) );
if ( $excerpt ) {
$output .= '
' . $excerpt . '
';
}
}
$output .= '
';
endwhile;
$output .= '
';
// Reset post data
wp_reset_postdata();
endif;
// After widget WordPress hook
$output .= $args['after_widget'];
// Echo output
echo $output;
}
/**
* Sanitize widget form values as they are saved.
*
* @since 1.0.0
*/
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'] ) ? strip_tags( $new_instance['number'] ) : '';
$instance['excerpt_length'] = ! empty( $new_instance['excerpt_length'] ) ? intval( $new_instance['excerpt_length'] ) : '';
$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_width'] ) ? intval( $new_instance['img_width'] ) : '';
$instance['date'] = isset( $new_instance['date'] ) ? true : false;
$instance['thumbnail_query'] = isset( $new_instance['thumbnail_query'] ) ? true : false;
$instance['img_crop_location'] = ! empty( $new_instance['img_crop_location'] ) ? strip_tags( $new_instance['img_crop_location'] ) : '';
return $instance;
}
/**
* Back-end widget form.
*
* @since 1.0.0
*/
public function form( $instance ) {
extract( wp_parse_args( ( array ) $instance, $this->defaults ) ); ?>
/>
/>