Related Posts section. * * @since 3.5.0 * @return void */ public function astra_related_posts_markup() { if ( astra_target_rules_for_related_posts() ) { $this->astra_get_related_posts(); } } /** * Related Posts markup. * * @since 3.5.0 * @return bool */ public function astra_get_related_posts() { global $post; $post_id = $post->ID; $related_posts_title = astra_get_option( 'related-posts-title' ); $related_post_meta = astra_get_option( 'related-posts-meta-structure' ); $related_post_structure = astra_get_option_meta( 'related-posts-structure' ); $exclude_ids = apply_filters( 'astra_related_posts_exclude_post_ids', array( $post_id ), $post_id ); $related_posts_total_count = absint( astra_get_option( 'related-posts-total-count', 2 ) ); // Get related posts by WP_Query. $query_posts = $this->astra_get_related_posts_by_query( $post_id ); if ( $query_posts ) { if ( ! $query_posts->have_posts() ) { return apply_filters( 'astra_related_posts_no_posts_avilable_message', '', $post_id ); } // Added flag to load wrapper section 'ast-single-related-posts-container' only once, because as we removed 'posts__not_in' param from WP_Query and we conditionally handle posts__not_in below so it needs to verify if there are other posts as well to load, then only we will display wrapper. $related_posts_section_loaded = false; do_action( 'astra_related_posts_loop_before' ); /** * WP_Query posts loop. * * Used $post_counter & ( $post_counter < $total_posts_count ) condition to manage posts in while loop because there is case where manual 'post__not_in' condition handling scenario fails within loop. * * # CASE EXAMPLE - If total posts set to 4 (where 'post__not_in' not used in WP_Query) so there is a chance that out of those 4 posts, 1 post will be currently active on frontend. * * So what will happen in this case - Within following loop the current post will exclude by if condition & only 3 posts will be shown up. * * To avoid such cases $post_counter & ( $post_counter < $total_posts_count ) condition used. * * @since 3.5.0 */ $post_counter = 1; $total_posts_count = $related_posts_total_count + 1; while ( $query_posts->have_posts() && $post_counter < $total_posts_count ) { $query_posts->the_post(); $post_id = get_the_ID(); $output_str = astra_get_post_meta( $related_post_meta ); if ( is_array( $exclude_ids ) && ! in_array( $post_id, $exclude_ids ) ) { if ( false === $related_posts_section_loaded ) { echo '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped do_action( 'astra_related_posts_title_before' ); if ( '' !== $related_posts_title ) { echo apply_filters( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped 'astra_related_posts_title', sprintf( '
<%1$s class="ast-related-posts-title"> %2$s
', 'h2', $related_posts_title ) ); } do_action( 'astra_related_posts_title_after' ); echo '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped $related_posts_section_loaded = true; } ?>
>
astra_get_related_post_featured_image( $post_id ); do_action( 'astra_related_post_after_featured_image', $post_id ); } else { ?>
astra_get_related_post_title( $post_id ); echo apply_filters( 'astra_related_posts_meta_html', '
' . $output_str . '
', $output_str ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
astra_get_related_post_excerpt( $post_id ); $this->astra_get_related_post_read_more( $post_id ); ?>
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } do_action( 'astra_related_posts_loop_after' ); } } /** * Render Post CTA button HTML marup. * * @param int $current_post_id current post ID. * * @since 3.5.0 */ public function astra_get_related_post_read_more( $current_post_id ) { if ( ! astra_get_option( 'enable-related-posts-excerpt' ) ) { return; } $related_posts_content_type = apply_filters( 'astra_related_posts_content_type', 'excerpt' ); if ( 'full-content' === $related_posts_content_type ) { return; } $target = apply_filters( 'astra_related_post_cta_target', '_self' ); $cta_text = apply_filters( 'astra_related_post_read_more_text', astra_get_option( 'blog-read-more-text' ) ); $show_read_more_as_button = apply_filters( 'astra_related_post_read_more_as_button', astra_get_option( 'blog-read-more-as-button' ) ); $class = ''; if ( $show_read_more_as_button ) { $class = 'ast-button'; } $custom_class = apply_filters( 'astra_related_post_cta_custom_classes', $class ); do_action( 'astra_related_post_before_cta', $current_post_id ); ?>

< class="ast-related-post-title entry-title"> > '; if ( '' !== $post_thumb ) { $featured_img_markup .= '
'; $featured_img_markup .= astra_markup_open( 'ast-related-post-image', array( 'open' => '', 'echo' => false, 'attrs' => array( 'class' => '', 'href' => esc_url( get_permalink() ), ), ) ); $featured_img_markup .= $post_thumb; $featured_img_markup .= '
'; } $featured_img_markup = apply_filters( 'astra_related_post_featured_image_after', $featured_img_markup ); $featured_img_markup .= '
'; $featured_img_markup = apply_filters( 'astra_related_post_thumbnail', $featured_img_markup, $before, $after ); if ( false === $echo ) { return $before . $featured_img_markup . $after; } echo $before . $featured_img_markup . $after; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } /** * Get related posts based on configurations. * * @param int $post_id Current Post ID. * * @since 3.5.0 * * @return WP_Query|bool */ public function astra_get_related_posts_by_query( $post_id ) { $term_ids = array(); $current_post_type = get_post_type( $post_id ); $related_posts_total_count = absint( astra_get_option( 'related-posts-total-count', 2 ) ); // Taking one post extra in loop because if current post excluded from while loop then this extra one post will cover total post count. Apperently avoided 'post__not_in' from WP_Query. $updated_total_posts_count = $related_posts_total_count + 1; $related_posts_order_by = astra_get_option( 'related-posts-order-by', 'date' ); $related_posts_order = astra_get_option( 'related-posts-order', 'desc' ); $related_posts_based_on = astra_get_option( 'related-posts-based-on', 'categories' ); $query_args = array( 'update_post_meta_cache' => false, 'posts_per_page' => $updated_total_posts_count, 'no_found_rows' => true, 'post_status' => 'publish', 'post_type' => $current_post_type, 'orderby' => $related_posts_order_by, 'fields' => 'ids', 'order' => $related_posts_order, ); if ( 'tags' === $related_posts_based_on ) { $terms = get_the_tags( $post_id ); if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) { $term_ids = wp_list_pluck( $terms, 'term_id' ); } $query_args['tag__in'] = $term_ids; } else { $terms = get_the_category( $post_id ); if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) { $term_ids = wp_list_pluck( $terms, 'term_id' ); } $query_args['category__in'] = $term_ids; } $query_args = apply_filters( 'astra_related_posts_query_args', $query_args ); return new WP_Query( $query_args ); } } /** * Kicking this off by creating NEW instance. */ new Astra_Related_Posts_Markup();