BW_Guides_CPT::POST_TYPE, 'post_status' => 'publish', // Raised from 20 (0.2.0 and earlier): the browse grid is now grouped by // category (BW_Guides_Keywords::group_guides()), and a 20-per-page slice // tends to cut a category's cards in half across two pages. 60 keeps a // category intact at the library sizes seen so far. A library that // outgrows 60 will still see a group split across pages — an accepted // tradeoff, not solved here (see docs/PLATFORM-ROADMAP.md). 'posts_per_page' => 60, 'paged' => $bw_paged, 'orderby' => 'title', 'order' => 'ASC', ); if ( '' !== $bw_search ) { $bw_args['s'] = $bw_search; } if ( '' !== $bw_tag ) { $bw_args['tax_query'] = array( array( 'taxonomy' => BW_Guides_CPT::TAXONOMY, 'field' => 'slug', 'terms' => $bw_tag, ), ); } if ( 'hub' === $bw_source ) { $bw_args['meta_query'] = array( array( 'key' => BW_Guides_CPT::SOURCE_META, 'value' => 'hub', ), ); } elseif ( 'local' === $bw_source ) { $bw_args['meta_query'] = array( 'relation' => 'OR', array( 'key' => BW_Guides_CPT::SOURCE_META, 'value' => 'local', ), array( 'key' => BW_Guides_CPT::SOURCE_META, 'compare' => 'NOT EXISTS', ), ); } $bw_query = new WP_Query( $bw_args ); // Section-level search. Clients arrive with a small specific question ("how do // I change the page url") that lives inside a larger guide, so a search also // matches headings — and a guide's hidden keywords, see BW_Guides_Keywords — // and offers a ranked, direct link to the best-matching section. Searches // every published guide rather than the current page of results — the point // is to find the answer wherever it lives. $bw_sections = array(); if ( '' !== $bw_search ) { $bw_sections = BW_Guides_Content::search_sections( get_posts( array( 'post_type' => BW_Guides_CPT::POST_TYPE, 'post_status' => 'publish', 'numberposts' => 100, 'orderby' => 'title', 'order' => 'ASC', ) ), $bw_search ); } $bw_terms = get_terms( array( 'taxonomy' => BW_Guides_CPT::TAXONOMY, 'hide_empty' => true, ) ); if ( is_wp_error( $bw_terms ) ) { $bw_terms = array(); } // Grouped for the browse grid: hub guides by category (alphabetical), // uncategorized under "More guides", local guides always last under // "Your guides" — see BW_Guides_Keywords::group_guides(). $bw_groups = $bw_query->have_posts() ? BW_Guides_Keywords::group_guides( $bw_query->posts ) : array(); ?>

post_title ); ?>

have_posts() && ! empty( $bw_sections ) ) : ?>

have_posts() ) : ?>

ID, BW_Guides_CPT::SOURCE_META, true ); $bw_post_tags = get_the_terms( $bw_post, BW_Guides_CPT::TAXONOMY ); $bw_excerpt = $bw_post->post_excerpt ? $bw_post->post_excerpt : wp_trim_words( wp_strip_all_tags( $bw_post->post_content ), 24 ); // Up to 3 quick section links per card — the guide's // first h2s, so a client can jump straight to a task // without opening the guide first. $bw_quick_headings = array_slice( array_values( array_filter( BW_Guides_Content::headings( $bw_post->post_content ), static function ( $bw_h ) { return 2 === $bw_h['level']; } ) ), 0, 3 ); ?>

post_title ); ?>

name ); ?>

max_num_pages > 1 ) : ?>

$bw_search, 'guide_tag' => $bw_tag, 'source' => $bw_source, ) ); if ( $bw_paged > 1 ) { echo '‹ ' . esc_html__( 'Previous', 'bw-guides' ) . ' '; } echo '' . (int) $bw_paged . ' / ' . (int) $bw_query->max_num_pages . ''; if ( $bw_paged < $bw_query->max_num_pages ) { echo ' ' . esc_html__( 'Next', 'bw-guides' ) . ' ›'; } ?>