Clone this wiki locally
scoped_search is a simple Rails plugin that will make it easy to search your ActiveRecord models. Searching is performed using a query string, which should be passed to the named_scope search_for that uses SQL LIKE conditions for searching (ILIKE for Postgres). You can specify what fields should be used for searching.
To install the gem simply add the following line to the Gemfile, and run
Once installed, start adding
scoped_search definitions to models that need it, and you can then call
ExampleModel.search_for('name = foo'). See Usage for more examples.
- a simple demo application of the scoped_search GUI
- Outdated using scoped search in Portuguese
- Very short usage introduction in Swedish
Support for different databases
Because the library generates standard SQL, it should work for all databases that respect the SQL standard. However, there are small differences between the different databases that may warrant different handling.
Scoped search comes with adapters for SQLite, MySQL and PostgreSQL to ensure consistent results across databases. We will only accept support for open source databases to the gem. However, some plugins exists to improve scoped_search’s results for other databases as well.
- Oracle: https://github.com/wvanbergen/scoped_search-oracle_enhanced
- H2: https://github.com/wvanbergen/scoped_search-h2
This plugin is released under the MIT license.
If you want to hack on this plugin or change it to suit your needs, see the CONTRIBUTING.rdoc for some pointers.