Setting ':single => true' on a facet does not affect the "more" screen

[eranhirs]

When setting :single => true on a facet it does not affect the "more" screen.
For example, set a limit on 'pub_date' facet like this:

config.add_facet_field 'pub_date', :label => 'Publication Year', :single => true, :limit => 10

then try choosing a value, then click the "more" button.
You will see only the selected facet not all of them like expected when setting ':single => true'

[cbeer]

In fact, most facet options don't play nice with the more-screen.

[jrochkind]

Where would I find docs on all the facet options? I hadn't known about :single => true, and am still not sure what it does.

[eranhirs]

@cbeer - I will open a pull request soon that fixes a lot of the problems
@jrochkind - generated catalog_controller.rb comes with a :single => true facet (that's how I noticed it), and this is a good explanation what it does:
http://wiki.apache.org/solr/SimpleFacetParameters#Multi-Select_Faceting_and_LocalParams

[jrochkind]

Thanks @eranhirs. I see the example here:

https://github.com/projectblacklight/blacklight/blob/master/lib/generators/blacklight/templates/catalog_controller.rb#L53

But I'm still not sure what it does -- you linked to the Solr docs on Multi-Select Facetting and LocalParams. So it's got something to do with that? But what? :single => true... turns on multi-select or something?

[eranhirs]

It does 2 things:
*1 - Multi-select facet as described in the link I posted, meaning that even if you select a facet value all the other values still appear as if you didn't press a facet value.
You can see here:
https://github.com/projectblacklight/blacklight/blob/master/lib/blacklight/configuration/facet_field.rb
that it sets in Configuration::FacetField 2 members: tag & ex which are later used in the solr_search_params_logic pipeline. (methods using it: :add_facet_fq_to_solr, :add_facetting_to_solr)

*2 - It also makes the facets swap when clicking a facet value. For example you clicked "Pdf", then pressed "Word", because you set :single => true then "Pdf" will swap with "Word" instead of them both being selected.

*1 is using solr's implementation, while *2 is blacklight's internal implementation.

[cbeer]

@jrochkind or our wiki page: https://github.com/projectblacklight/blacklight/wiki/Configuration---Facet-Fields

[eranhirs]

@cbeer how do I add a pull request to this issue?

[cbeer]

Just reference it in the PR (e.g. Fixes #765)

[eranhirs]

PR #767