Tab<\/code><\/td>\nStandard browser tab navigation<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\nHighlighting<\/h3>\n\n\nThe query is wrapped in <mark><\/code> tags around matches in the title and excerpt. The <mark><\/code> is styled in the accent color (gold by default) so matches pop visually.<\/p>\n\n\nThe highlight respects HTML escaping \u2014 <<\/code> in the title is escaped before the regex runs, so no XSS surface.<\/p>\n\n
\n\nCustomizing what shows up<\/h2>\n\n\nLimit search to specific post types<\/h3>\n\n\nBy default the endpoint queries best_classifieds_get_listing_post_type()<\/code> (which is post<\/code> for the free theme, listing<\/code> for Pro CPT mode). To search additional post types:<\/p>\n\n\nadd_filter( 'best_classifieds_search_post_types', function( $types ) {\n return array( 'post', 'page', 'product' ); \/\/ include pages and WooCommerce products\n} );<\/code><\/pre>\n\n\nChange the result count<\/h3>\n\n\nDefault is 8 listings + 4 categories. To change:<\/p>\n\n\n add_filter( 'best_classifieds_search_listings_limit', function() { return 5; } );\nadd_filter( 'best_classifieds_search_categories_limit', function() { return 6; } );<\/code><\/pre>\n\n\nAdd custom fields to the response<\/h3>\n\n\nThe excerpt<\/code>, location<\/code>, and price<\/code> fields are emitted; to add more (e.g. condition, mileage, salary range):<\/p>\n\n\nadd_filter( 'best_classifieds_search_result_fields', function( $fields, $post_id ) {\n $fields['condition'] = get_post_meta( $post_id, '_bc_condition', true );\n return $fields;\n}, 10, 2 );<\/code><\/pre>\n\n\nThe frontend JS doesn’t render these by default. To show them in the dropdown, you’d also extend live-search.js<\/code> (or override it from a child theme).<\/p>\n\n
\n\nPerformance considerations<\/h2>\n\n\nThe endpoint runs a WP_Query<\/code> with s={query}<\/code> \u2014 which is WordPress’s default LIKE-based search. For sites with 10,000+ listings, you’ll want to plug in a better search engine:<\/p>\n\n\n\n- ElasticPress<\/strong> \u2014 works automatically; it intercepts WP_Query and routes to Elasticsearch<\/li>\n
- SearchWP<\/strong> \u2014 paid plugin with great relevance tuning<\/li>\n
- Algolia<\/strong> \u2014 replace the endpoint entirely with an Algolia-powered alternative<\/li>\n<\/ul>\n\n\n
To replace the entire endpoint with your own:<\/p>\n\n\n remove_action( 'rest_api_init', 'best_classifieds_register_search_endpoint' );\n\nadd_action( 'rest_api_init', function() {\n register_rest_route( 'best-classifieds\/v1', '\/search', array(\n 'methods' => 'GET',\n 'permission_callback' => '__return_true',\n 'callback' => 'my_custom_search_callback',\n ) );\n} );<\/code><\/pre>\n\n\nReturn the same JSON shape and the frontend JS will keep working unchanged.<\/p>\n\n
\n\nDisabling live search<\/h2>\n\n\nIf you want a plain old form post (no dropdown):<\/p>\n\n\n add_filter( 'best_classifieds_enable_live_search', '__return_false' );<\/code><\/pre>\n\n\nThe form still works \u2014 it just submits to the standard search page on Enter, no live results.<\/p>\n\n
\n\nMobile behavior<\/h2>\n\n\nThe dropdown adapts to the small viewport:<\/p>\n\n\n \n- Full-width (extends past form edges via
left: -8px; right: -8px<\/code>)<\/li>\n- Max height
65vh<\/code> so it doesn’t crowd the keyboard<\/li>\n- Excerpt is hidden (just title + meta to save space)<\/li>\n
- Touch targets minimum 44px<\/li>\n<\/ul>\n\n\n
The search input is font-size: 16px<\/code> to prevent iOS auto-zooming on focus \u2014 a small detail that makes the experience feel native.<\/p>\n","protected":false},"excerpt":{"rendered":"The hero search dropdown is one of the most-used parts of the site \u2014 a polished, debounced live-search experience with smart category icons. This page explains how it\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-48","post","type-post","status-publish","format-standard","hentry","category-using-best-classifieds"],"_links":{"self":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/48","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/comments?post=48"}],"version-history":[{"count":0,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/48\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/media?parent=48"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/categories?post=48"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/tags?post=48"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
|