__( 'Display Related Posts', 'contextual-related-posts' ),
'customize_selective_refresh' => true,
)
);
}
/**
* Back-end widget form.
*
* @see WP_Widget::form()
*
* @param array $instance Previously saved values from database.
*/
public function form( $instance ) {
$title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
$limit = isset( $instance['limit'] ) ? esc_attr( $instance['limit'] ) : '';
$offset = isset( $instance['offset'] ) ? esc_attr( $instance['offset'] ) : '';
$show_excerpt = isset( $instance['show_excerpt'] ) ? esc_attr( $instance['show_excerpt'] ) : '';
$show_author = isset( $instance['show_author'] ) ? esc_attr( $instance['show_author'] ) : '';
$show_date = isset( $instance['show_date'] ) ? esc_attr( $instance['show_date'] ) : '';
$post_thumb_op = isset( $instance['post_thumb_op'] ) ? esc_attr( $instance['post_thumb_op'] ) : '';
$thumb_height = isset( $instance['thumb_height'] ) ? esc_attr( $instance['thumb_height'] ) : '';
$thumb_width = isset( $instance['thumb_width'] ) ? esc_attr( $instance['thumb_width'] ) : '';
$ordering = isset( $instance['ordering'] ) ? esc_attr( $instance['ordering'] ) : '';
$random_order = isset( $instance['random_order'] ) ? esc_attr( $instance['random_order'] ) : '';
$include_cat_ids = isset( $instance['include_cat_ids'] ) ? esc_attr( $instance['include_cat_ids'] ) : '';
// Parse the Post types.
$post_types = array();
// If post_types is empty or contains a query string then use parse_str else consider it comma-separated.
if ( ! empty( $instance['post_types'] ) && false === strpos( $instance['post_types'], '=' ) ) {
$post_types = explode( ',', $instance['post_types'] );
} elseif ( ! empty( $instance['post_types'] ) ) {
parse_str( $instance['post_types'], $post_types ); // Save post types in $post_types variable.
}
$wp_post_types = get_post_types(
array(
'public' => true,
)
);
$posts_types_inc = array_intersect( $wp_post_types, $post_types );
// Get the different ordering settings.
$orderings = crp_get_orderings();
?>
:
:
$label ) { ?>
:
true,
)
);
$post_types = isset( $new_instance['post_types'] ) ? $new_instance['post_types'] : array();
$post_types = array_intersect( $wp_post_types, (array) $post_types );
$instance['post_types'] = implode( ',', $post_types );
// Save include_categories.
$include_categories = wp_parse_id_list( $new_instance['include_cat_ids'] );
foreach ( $include_categories as $cat_name ) {
$cat = get_term_by( 'term_taxonomy_id', $cat_name );
if ( isset( $cat->term_taxonomy_id ) ) {
$include_cat_ids[] = $cat->term_taxonomy_id;
$include_cat_names[] = $cat->name;
}
}
$instance['include_cat_ids'] = isset( $include_cat_ids ) ? join( ',', $include_cat_ids ) : '';
$instance['include_categories'] = isset( $include_cat_names ) ? crp_str_putcsv( $include_cat_names ) : '';
delete_post_meta_by_key( 'crp_related_posts_widget' ); // Delete the cache.
/**
* Filters Update widget options array.
*
* @since 2.0.0
*
* @param array $instance Widget options array
* @param array $new_instance Values just sent to be saved.
* @param array $old_instance Previously saved values from database.
*/
return apply_filters( 'crp_widget_options_update', $instance, $new_instance, $old_instance );
} //ending update
/**
* 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 ) {
global $post;
// Get the post meta.
if ( isset( $post ) ) {
$crp_post_meta = get_post_meta( $post->ID, 'crp_post_meta', true );
if ( isset( $crp_post_meta['disable_here'] ) && $crp_post_meta['disable_here'] ) {
return;
}
}
// If post_types is empty or contains a query string then use parse_str else consider it comma-separated.
if ( crp_get_option( 'exclude_on_post_types' ) && false === strpos( crp_get_option( 'exclude_on_post_types' ), '=' ) ) {
$exclude_on_post_types = explode( ',', crp_get_option( 'exclude_on_post_types' ) );
} else {
parse_str( crp_get_option( 'exclude_on_post_types' ), $exclude_on_post_types ); // Save post types in $exclude_on_post_types variable.
}
if ( is_object( $post ) && ( in_array( $post->post_type, $exclude_on_post_types, true ) ) ) {
return 0; // Exit without adding related posts.
}
$exclude_on_post_ids = explode( ',', crp_get_option( 'exclude_on_post_ids' ) );
if ( ( ( is_single() ) && ( ! is_single( $exclude_on_post_ids ) ) ) || ( ( is_page() ) && ( ! is_page( $exclude_on_post_ids ) ) ) ) {
$title = empty( $instance['title'] ) ? wp_strip_all_tags( str_replace( '%postname%', $post->post_title, crp_get_option( 'title' ) ) ) : $instance['title'];
/**
* Filters the widget title.
*
* @since 2.6.0
*
* @param string $title The widget title. Default 'Pages'.
* @param array $instance Array of settings for the current widget.
* @param mixed $id_base The widget ID.
*/
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
$limit = isset( $instance['limit'] ) ? $instance['limit'] : crp_get_option( 'limit' );
if ( empty( $limit ) ) {
$limit = crp_get_option( 'limit' );
}
$offset = isset( $instance['offset'] ) ? $instance['offset'] : 0;
$post_thumb_op = isset( $instance['post_thumb_op'] ) ? esc_attr( $instance['post_thumb_op'] ) : 'text_only';
$thumb_height = isset( $instance['thumb_height'] ) && ! empty( $instance['thumb_height'] ) ? esc_attr( $instance['thumb_height'] ) : crp_get_option( 'thumb_height' );
$thumb_width = isset( $instance['thumb_width'] ) && ! empty( $instance['thumb_width'] ) ? esc_attr( $instance['thumb_width'] ) : crp_get_option( 'thumb_width' );
$show_excerpt = isset( $instance['show_excerpt'] ) ? esc_attr( $instance['show_excerpt'] ) : '';
$show_author = isset( $instance['show_author'] ) ? esc_attr( $instance['show_author'] ) : '';
$show_date = isset( $instance['show_date'] ) ? esc_attr( $instance['show_date'] ) : '';
$ordering = isset( $instance['ordering'] ) ? esc_attr( $instance['ordering'] ) : '';
$random_order = isset( $instance['random_order'] ) ? esc_attr( $instance['random_order'] ) : '';
$post_types = isset( $instance['post_types'] ) && ! empty( $instance['post_types'] ) ? $instance['post_types'] : crp_get_option( 'post_types' );
$include_cat_ids = isset( $instance['include_cat_ids'] ) ? esc_attr( $instance['include_cat_ids'] ) : '';
$arguments = array(
'is_widget' => 1,
'instance_id' => $this->number,
'limit' => $limit,
'offset' => $offset,
'show_excerpt' => $show_excerpt,
'show_author' => $show_author,
'show_date' => $show_date,
'post_thumb_op' => $post_thumb_op,
'thumb_height' => $thumb_height,
'thumb_width' => $thumb_width,
'ordering' => $ordering,
'random_order' => $random_order,
'post_types' => $post_types,
'include_cat_ids' => $include_cat_ids,
);
/**
* Filters arguments passed to get_crp for the widget.
*
* @since 2.0.0
*
* @param array $arguments CRP widget options array.
* @param array $args Widget arguments.
* @param array $instance Saved values from database.
* @param mixed $id_base The widget ID.
*/
$arguments = apply_filters( 'crp_widget_options', $arguments, $args, $instance, $this->id_base );
$related_posts = get_crp( $arguments );
if ( ! empty( wp_strip_all_tags( $related_posts, true ) ) ) {
$output = $args['before_widget'];
$output .= $args['before_title'] . $title . $args['after_title'];
$output .= $related_posts;
$output .= $args['after_widget'];
echo $output; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
}// End if.
} // Ending function widget.
}
/**
* Initialise the widget.
*
* @since 1.9.1
*/
function register_crp_widget() {
register_widget( 'CRP_Widget' );
}
add_action( 'widgets_init', 'register_crp_widget' );
endif;