© 2017-2019 Domizio DemichelisMIT License

Searchkick Extra

This extra deals with the pagination of Searchkick::Results objects either by creating a Pagy object out of an (already paginated) Searchkick::Results object or by creating the Pagy and Searchkick::Results objects from the backend params.

Synopsis

See extras for general usage info.

Require the extra in the pagy.rb initializer:

require 'pagy/extras/searchkick'

Passive mode

If you have an already paginated Searchkick::Results object, you can get the Pagy object out of it:

@results = Model.search('*', page: 1; per_page: 10, ...)
@pagy    = Pagy.new_from_searchkick(@results, ...)

Active Mode

If you want Pagy to control the pagination, getting the page from the params, and returning both the Pagy and the Searchkick::Results objects automatically (from the backend params):

Extend your model:

extend Pagy::Search

In a controller use pagy_search in place of search:

records = Article.pagy_search(params[:q]).results
@pagy, @records = pagy_searchkick(records, items: 10)

Files

Pagy.new_from_searchkick

This constructor accepts a Searchkick::Results as the first argument, plus the usual optional variable hash. It sets the :items, :page and :count pagy variables extracted/calculated out of the Searchkick::Results object.

@results = Model.search('*', page: 2; per_page: 10, ...)
@pagy    = Pagy.new_from_searchkick(@results, ...)

Notice: you have to take care of manually manage all the params for your search, however the method extracts the :items, :page and :count from the results object, so you don’t need to pass that again. If you prefer to manage the pagination automatically, see below.

Pagy::Search

Extend your model with the Pagy::Search micro-moudule (see pagy_search.rb)

extend Pagy::Search

The Pagy::Search adds the pagy_search class method that you must use in place of the standard search method when you want to paginate the search response.

pagy_search(term, options={})

This method accepts the same arguments of the search method and you must use it in its place. This extra uses it in order to capture the arguments, automatically merging the calculated :page and :per_page options before passing them to the standard search method internally.

Methods

This extra adds the pagy_searchkick method to the Pagy::Backend to be used when you have to paginate a Searchkick::Results object. It also adds a pagy_searchkick_get_vars sub-method, used for easy customization of variables by overriding.

pagy_searchkick(Model.pagy_search(…), vars={}})

This method is similar to the generic pagy method, but specialized for Searchkick. (see the pagy doc)

It expects to receive a Model.pagy_search(...) result and returns a paginated response. You can use it in a couple of ways:

@pagy, @results = pagy_searchkick(Model.pagy_search(params[:q]), ...)
...
@records = @results.results

# or directly with the collection you need (e.g. records)
@pagy, @records = pagy_searchkick(Model.pagy_search(params[:q]).results, ...)

pagy_searchkick_get_vars(array)

This sub-method is similar to the pagy_get_vars sub-method, but it is called only by the pagy_searchkick method. (see the pagy_get_vars doc).