Releases for Faceted Search

Faceted Search version 1.0 beta4 for Drupal 5.x.

• #238208: Added support for field search! (keyword search restricted by field).
• Changed the "Search within results" option to a (more compact) checkbox.
• Changed the "More options" search form to use a (more compact) selector for choosing the operator.
• #264265: Fixed inaccurate results when searching with short words.
• #271510: Fixed a MySQL syntax error that caused the install script to fail on some systems.
• #256234 by crank: Removed the caching of node types which was preventing multiple search environments from working simultaneously.
• Made handling of quoted search strings more robust.
• #244509: Made sure a base class is always loaded before its subclasses are defined.
• Faceted Search Views: #228226: Fixed keyword searches with no matches showing all nodes when using a view display style.
• Faceted Search Views: #251760: Fixed division by zero when Nodes per page is 0 in a view.
• Taxonomy Facets: Fixed the taxonomy_facets_term_node table not being properly updated upon term deletion.
• Taxonomy Facets: Linked to cron with a more proper path in user messages.

Upgrading from version 1.0 beta3 or earlier

API changes in this version will require that you upgrade all companion modules that you might be using, such as CCK Facets, Biblio Facets, or Organic Groups Facets.

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Current development version of Faceted Search for Drupal 5.x.

This version contains experimental and unfinished features. Use it only if you wish to test it or help with development.

• #213373 by janusman and David Lesieur: Added index on results table to improve speed.
• #290680 by Patrick Hubert and David Lesieur: Allow faceted searches on unpublished nodes.

Faceted Search version 1.0 beta3 for Drupal 5.x.

#251588: Fixed keyword search not working because it was getting disabled when saving the search environment.

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Faceted Search 1.0 beta2 for Drupal 5.x.

#244509: Fixed PHP error in Faceted Search Views when enabling all the modules at once.

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Faceted Search version 1.0 beta1 for Drupal 5.x.

• Introduced the more general concept of filter (facets are now filters). This has no visible impact on the UI but is essential groundwork for future improvements.
• Rewrote the query building code around keyword search and removed a temporary table. This improves performance slightly.
• Avoided conditions on node type whenever possible, to simplify queries.
• Use a single filter for keyword search (instead of one per operator). These types of filters are now referred to as "fields".
• Administer keyword search filters (fields) separately from facets.
• Added internal weight to categories (for sorting purposes).
• Added utility functions for extracting quoted strings from the search text.
• Moved parsing of search keywords into a separate function (allows re-use).
• Faceted Search Views: #233089: Fixed errors with PHP 4.
• Faceted Search Views: #244509: Added missing (indirect) dependencies.
• Taxonomy Facets: Avoided retrieving vocabularies before parsing the search text.
• Taxonomy Facets: #233707: Update node-term associations immediately upon node insert/update.

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Faceted Search version 0.21 for Drupal 5.x.

Fixed Taxonomy Facets' update script (a database table was not prefixed and causing SQL errors when site is configured for prefixing).

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Faceted Search version 0.20 for Drupal 5.x.

• #170959: Added support for multiple search environments.
• Rewrote much of the administration interface to support multiple environments and improve usability. The administration interface is now more similar to Views'.
• Made the base path of search URLs customizable.
• Made the title of search pages customizable.
• Made all blocks optional (per-environment).
• Added the start page to the breadcrumb of search pages.
• Allowed facets to be disabled independently of their provider module.
• #191298: Added option for selective use of the Extracts display style (only when keywords are actually used in the current search).
• Made the Teasers display style the default (instead of the Extracts style).
• Changed the search term remover link to 'x' instead of '-' (per patrickharris's suggestion).
• Turned tooltips off by default.
• Separated disabled facets from enabled ones to make administration easier.
• Allowed category labels to contain HTML (needed for CCK Facets).
• Added class around node counts to help styling.
• #197783: Added robots directive to prevent them from hitting every possible link in the Guided search.
• Refactored hook_faceted_search_parse(), hook_faceted_search_list(), hook_faceted_search_collect() into a single, easier to implement hook_faceted_search_collect().
• Added variable system (similar to variable_get()/variable_set()) to make it easier for facet modules to manage per-environment settings.
• Made sure block settings are removed when uninstalling.
• Made initialization of default facet settings cleaner (directly in the facets' constructors).
• Renamed a few functions for consistency.
• Fixed search initialization, which was performed even when not needed.
• Fixed search initialization to only create the facets that are enabled.
• #187078: Removed drop temporary table that was not working with PostgreSQL.
• Author Facet: Blocked users are now displayed in the Guided search.
• Author Facet: #216305: Fixed subquery causing problems with hook_db_rewrite_sql().
• Content Type Facet: Changed default to show all content types.
• Faceted Search Views: #222799: Use Views' number of nodes per page.
• Faceted Search Views: Fixed view showing all available nodes when the search should return no results.
• Faceted Search Views: #208066: Fixed wrong results when a view is using the Node: Distinct filter.
• Taxonomy Facets: Supported large number of nodes or terms through building node-term associations on cron.
• Taxonomy Facets: Reduced overhead with non-hierarchical vocabularies.
• Taxonomy Facets: Fixed taxonomy changes (such as changing a term's parents) not always being reflected in the Guided search.

Upgrading from version 0.11 or earlier

After copying the files, you'll need to run update.php as usual. However, if you are using Views to display Faceted Search results, you'll also have to manually edit your View to remove the Faceted Search filter and the Faceted Search sort handler (after the update these will look like empty handlers when editing your view), and use the Faceted Search Environment ID argument instead. Then you'll have to re-select your view as display style in the Faceted Search environment.

If you have overridden one of the following theme functions, you must revisit them to keep your site secure:

• theme_faceted_search_keyword_and_label()
• theme_faceted_search_keyword_or_label()
• theme_faceted_search_keyword_not_label()
• theme_faceted_search_keyword_phrase_label()

These functions must now filter their output (previously, Faceted Search UI was taking care of this). See the default implementations provided in Faceted Search UI for examples.

Faceted Search version 0.11 for Drupal 5.x.

• Added choice of display styles for the Related categories block (List Ungrouped, List Grouped by facet, Table Grouped by facet).
• #198621 by hrayr: Fixed wrong category count when some modules rewrite the queries.

Faceted Search version 0.10 for Drupal 5.x.

Fixed support for query rewrites on queries generated by the Faceted Search Views module.

Faceted Search version 0.9 for Drupal 5.x.

• Created a simple API for allowing modules to add display styles.
• Created the Faceted Search Views modules. Allows to use Views for displaying and filtering search results.
• Added ability to use the "results" page as the start page. This also means that an embedded view can now be used as the start page.
• Simplified the URLs.
• Added permission checks before displaying blocks.
• Fixed category listings to be filtered by node type (as search results already were) when not in the context of a current search.
• Fixed tooltips not being displayed on multiple words searches.
• Fixed install problem when search.module is not installed beforehand.
• Fixed display of OR keyword search arguments in the Current search block and in the page title (some HTML was displayed as entities).

Faceted Search version 0.8 for Drupal 5.x.

• Added setting for default keyword search mode (new vs. refine).
• Fixed unwanted prefixing of temporary tables.
• Fixed wrong results when "/" is used in the search text.

Faceted Search version 0.7 for Drupal 5.x.

Fixed an incompatibility with some modules that use hook_db_rewrite_sql(). Bug was introduced in the last release.

Faceted Search version 0.6 for Drupal 5.x.

• Added sort options for categories.
• Show number of results in results page.
• Added a Start page setting (path to go to when the current search is cleared).
• Avoid redirects when clearing the current search; go straight to the Start page.
• Added some instructions to users in the Guided search.
• Fixed inconsistent counts on categories when not using any keyword in the current search while node_access denies access to some matching nodes.
• Made the Advanced search page look prettier.
• Moved the Advanced search settings into a fieldset (collapsed by default).
• Slightly improved the theming layer; makes theming easier.
• Wrapped facet names in headings (<h3>).
• Rewrote the query building API. Cleaner, more robust, more flexible, more fun to use. Inspired in part from Views'.
• Removed an unused URL argument; was a placeholder for an idea that probably won't be implemented.

Faceted Search 0.5 for Drupal 5.x.

• Added Date Authored Facet to allow searching content by creation date.
• Changed the value of unspecified arguments in search URLs (from 'na' to '-').
• Show name of each facet's module in settings.
• Renamed blocks to use string identifiers instead of numeric identifiers (makes theming easier).
• Fixed incompatibility with AJAX tooltips and Devel module. Thanks to Moshe Weitzman! See also #115139.
• #170144: Fixed error under PHP 4.
• [Taxonomy Facets] Automatically rebuild the index when enabling the Taxonomy Facets module.
• [Author Facet] #172373: Fixed empty results when no role is defined.
• [Author Facet] Fixed SQL error when some users have multiple roles.

Faceted Search version 0.4 for Drupal 5.x.

• Major performance improvement: Now only one query per facet in guided search.
• Changed the API. These changes were necessary to improve performance, but that also made the API cleaner.
• Added a new facet to search by author.
• Added AJAX tooltips to show relevant subcategories when hovering over categories.
• Added a setting for results display style (extract or teaser).
• Added stylesheet classes for categories and the 'more' links.
• Added search terms to the titles of search pages.
• Fixed invalid values in the excluded content types option.

Faceted Search version 0.3 (unstable) for Drupal 5.x.

• #146943: Added support for free tags.
• #151258: Fixed node terms not always being saved in the faceted search index.
• Optimization: Reduced the number of count queries in guided search.
• Usability: Avoid showing a setting that's irrelevant for keyword facets.
• #160197, by fairwind: Added Russian translation.

Faceted Search version 0.2 (unstable) for Drupal 5.x.

New features:

• Added a Related categories block as a way to launch a faceted search from a node.
• API change: Simplified handling of active categories in facets.

Faceted Search version 0.1 (unstable) for Drupal 5.x.

HEAD version of Faceted Search.

See #219095: Port Faceted Search to Drupal 6 for the Drupal 6 status.

This version contains experimental and unfinished features. Use it only if you wish to test it or help with development.