README.md in meilisearch-rails-0.11.1 vs README.md in meilisearch-rails-0.12.0
- old
+ new
@@ -36,10 +36,11 @@
- [🤖 Compatibility with Meilisearch](#-compatibility-with-meilisearch)
- [🚀 Getting started](#-getting-started)
- [Compatibility](#-compatibility)
- [⚙️ Settings](#️-settings)
- [🔍 Custom search](#-custom-search)
+- [🔍🔍 Multi search](#-multi-search)
- [🪛 Options](#-options)
- [Meilisearch configuration & environment](#meilisearch-configuration--environment)
- [Pagination with `kaminari` or `will_paginate`](#backend-pagination-with-kaminari-or-will_paginate-)
- [Pagination with `pagy`](#backend-pagination-with-pagy-)
- [Index configuration](#index-configuration)
@@ -237,9 +238,61 @@
```ruby
Book.search('*', sort: ['title:asc'])
```
👉 Don't forget to set up the `sortable_attributes` option in the `meilisearch` block of your model.
+
+## 🔍🔍 Multi search
+
+Meilisearch supports searching multiple models at the same time (see [🔍 Custom search](#-custom-search) for search options):
+
+```ruby
+multi_search_results = MeiliSearch::Rails.multi_search(
+ Book => { q: 'Harry' },
+ Manga => { q: 'Attack' }
+)
+```
+
+You can iterate through the results with `.each` or `.each_result`:
+
+```erb
+<% multi_search_results.each do |record| %>
+ <p><%= record.title %></p>
+ <p><%= record.author %></p>
+<% end %>
+
+<p>Harry Potter and the Philosopher's Stone</p>
+<p>J. K. Rowling</p>
+<p>Harry Potter and the Chamber of Secrets</p>
+<p>J. K. Rowling</p>
+<p>Attack on Titan</p>
+<p>Iseyama</p>
+```
+
+```erb
+<% multi_search_results.each_result do |klass, results| %>
+ <p><%= klass.name.pluralize %></p>
+
+ <ul>
+ <% results.each do |record| %>
+ <li><%= record.title %></li>
+ <% end %>
+ </ul>
+<% end %>
+
+
+<p>Books</p>
+<ul>
+ <li>Harry Potter and the Philosopher's Stone</li>
+ <li>Harry Potter and the Chamber of Secrets</li>
+</ul>
+<p>Mangas</p>
+<ul>
+ <li>Attack on Titan</li>
+</ul>
+```
+
+See the [official multi search documentation](https://www.meilisearch.com/docs/reference/api/multi_search).
## 🪛 Options
### Meilisearch configuration & environment