A faceted search is one that allows you to drill down by various fields: price, size, colour, shipping location etc. It complements a free text search rather than replaces it.<\/p>\n\n
Using this plugin, you can create a faceted search interface for your pages, posts, or any other custom post type. You can add \"facets\" for:<\/p>\n\n
These facets are widgets that can be easily changed in the admin interface.<\/p>\n\n
You can have multiple search pages for different post types. If your WordPress installation uses multi-site, you can search across the different sites.<\/p>\n\n\n
bang-faceted-search<\/code> directory to your \/wp-content\/plugins\/<\/code> directory<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n
- Create a template
search.php<\/code> in your theme<\/li>\n- Go to Settings > Faceted Search to set up your search pages.<\/li>\n<\/ol>\n\n
Creating a search page<\/h4>\n\n
By default, you'll have a single search address, at the site root \/<\/code>. This lines up with WordPress search.<\/p>\n\nIn the WordPress admin adrea, go to Settings > Faceted Search. At the top is<\/p>\n\n
Creating a search template<\/h4>\n\n
You need to create a search template in your theme called search.php<\/code>, if you don't already have one. This template will be used whenever the user searches your site. You can have more than one search template, each.<\/p>\n\nAdd this code to your functions.php<\/code> to create a search-specific sidebar:<\/p>\n\nregister_sidebar(array(\n 'name' => 'Search',\n 'id' => 'search'\n));\n<\/code><\/pre>\n\nYour search template should include that sidebar:<\/p>\n\n
<?php dynamic_sidebar('search'); ?>\n<\/code><\/pre>\n\nThen in the admin interface, drag Facet widgets into that sidebar to add, customise and re-order the search widgets for your site.<\/p>\n\n
Customising the faceted search<\/h4>\n\n
Your site can have more than the default search page, and you can use the faceted search plugin to search custom post types.<\/p>\n\n
To make a custom search, create a page with a custom template in your theme. For example, if you have a page called \/products<\/code>, then create a template in your theme called products.php<\/code>. Near the start of this template, call this code:<\/p>\n\n$faceted_search = bang_faceted_search(null, array(\n 'force' => array(\n 'post_type' => 'product'\n )\n));\n<\/code><\/pre>\n\nLater on, display the results with something like:<\/p>\n\n
if ($faceted_search->has_posts()) {\n echo \"<h1>Search results<\/h1>\";\n $faceted_search->write_feedback();\n\n $posts = $faceted_search->get_posts();\n global $post;\n $original_post = $post;\n foreach ($posts as $post) {\n setup_postdata($post);\n \/\/ ... write the post ...\n }\n $post = $original_post;\n setup_postdata($post);\n echo $faceted_search->paginate();\n}\n<\/code><\/pre>\n\n\n\nWhat's wrong with a simple search field?<\/h3><\/dt>\nNothing, but faceted search makes your search richer.<\/p>\n\n
Faceted search doesn't replace the normal search field, it complements it. You can have both, without any boundary between them.<\/p><\/dd>\n
What's a \"facet\"?<\/h3><\/dt>\nIt's a means of narrowing down search results. A user might want to narrow down by categories or tags, by the author of a post, by the date it was published or by the contents of a taxonomy or custom field.<\/p><\/dd>\n
Why don't I see any faceted search links?<\/h3><\/dt>\nMake sure to create a search sidebar, and put some widgets into it.<\/p>\n\n
If a facet widget has the Hide empty terms<\/strong> option checked, then that facet may easily disappear from a view when all its links would produce zero results.<\/p><\/dd>\nCan I put other widgets into the same sidebar as the facet widgets?<\/h3><\/dt>\nYes. It's a normal sidebar, you can put any widgets into it.<\/p><\/dd>\n
Can I put facet widets into other sidebars?<\/h3><\/dt>\nIf the page you're on isn't a search page, facet widgets will be invisible.<\/p><\/dd>\n
Does this work with Relevanssi?<\/h3><\/dt>\nYes. If you have the Relevanssi plugin switched on at the same time, they'll cooperate to deliver the best search results.<\/p><\/dd>\n
Does this work with my eCommerce\/calendar\/reviews\/other plugin?<\/h3><\/dt>\nYou can make a faceted search on any post type, but it won't understand any special fields like 'price' or 'score' if they're implemented in a non-standard way.<\/p><\/dd>\n
Can I make my own facets? Can I filter the results? Can I change how the plugin works?<\/h3><\/dt>\nYes, yes and yes.<\/p>\n\n
If you use a plugin that defines its own post types, such as an ecommerce or events calendar plugin, then you might want to make your own facet widgets. Create a WordPress widget and register it in the normal way. Look at the code of the included widgets to get an idea how to implement the links.<\/p>\n\n
There are a lot more actions and filters you can hook into - have a look through the code to find them. Here are just a few of them:<\/p>\n\n
\nbang_fs_query<\/code> - The parameters to WP_Query<\/code><\/li>\nbang_fs_results<\/code> - The posts returned<\/li>\nbang_fs_count<\/code> - The number of results<\/li>\nbang_fs_feedback_args<\/code> - The fields to display in the feedback<\/li>\nbang_fs_options<\/code> - The plugin settings<\/li>\n<\/ul>\n\nBe aware that the internal workings of the plugin are subject to change, so the names and details of these hooks may change in future version.<\/p><\/dd>\n\n<\/dl>\n\n\n
2.0<\/h4>\n\n\n- Settings page makes this plugin suitable for non-developers<\/li>\n
- Simplified widgets by moving common options to the settings page<\/li>\n
- Auto switch between a list and a dropdown based on number of options<\/li>\n
- Updates to work with WordPress 3.8+<\/li>\n
- Better integration with Relevanssi and other plugins<\/li>\n
- WPMU: Network Search allows you to search between the sites on your network<\/li>\n<\/ul>\n\n
1.0<\/h4>\n\n\n- First version<\/li>\n<\/ul>","raw_excerpt":"Create a faceted search interface for any post type.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/23723","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=23723"}],"author":[{"embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/marcusdowning"}],"wp:attachment":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=23723"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=23723"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=23723"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=23723"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=23723"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=23723"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}