Merge pull request #2150 from vaskinyy/facet-sorting-docs

- added documentation for facet sorting

docs/source/ref/settings.rst

@@ -94,7 +94,9 @@ all default to 20.
 
 A dictionary that specifies the facets to use with the search backend.  It
 needs to be a dict with keys ``fields`` and ``queries`` for field- and
-query-type facets.  The default is::
+query-type facets. Field-type facets can get an 'options' element with parameters like facet
+sorting, filtering, etc.
+The default is::
 
     OSCAR_SEARCH_FACETS = {
         'fields': OrderedDict([

src/oscar/defaults.py

@@ -224,7 +224,10 @@ OSCAR_SEARCH_FACETS = {
         ('product_class', {'name': _('Type'), 'field': 'product_class'}),
         ('rating', {'name': _('Rating'), 'field': 'rating'}),
         # You can specify an 'options' element that will be passed to the
-        # SearchQuerySet.facet() call.  It's hard to get 'missing' to work
+        # SearchQuerySet.facet() call.
+        # For instance, with Elasticsearch backend, 'options': {'order': 'term'}
+        # will sort items in a facet by title instead of number of items.
+        # It's hard to get 'missing' to work
         # correctly though as of Solr's hilarious syntax for selecting
         # items without a specific facet:
         # http://wiki.apache.org/solr/SimpleFacetParameters#facet.method