| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
This repo was archived
See collective/eea.facetednavigation for new releases
The EEA Faceted Navigation (FacetedNav) gives you a very powerful interface to improve search within large collections of items. No programming skills are required by the website manager to configure the faceted navigation interface, configuration is done TTW. It lets you gradually select and explore different facets (metadata/properties) of the site content and narrow down you search quickly and dynamically.
On the contrary, plone collections are static, in a way that the site admin decides the search criteria and the end user is not able to further sort or filter the presented results.
FacetedNav is fully customizable, site admin may decide that some criteria (facets) must have fixed values while other may be presented as filter options to the web visitor.
FacetedNav may very well replace the standard collection content type, since it covers same functionality and it adds a lot more features.
FacetedNav can also be used as an advanced search for your Plone Classic site.
Contents
It comes with plenty of configuration options and features like:
With pip:
bin/pip install eea.facetednavigation
Try it with docker:
docker run --rm -p 8080:8080 -e SITE="Plone" -e ADDONS="eea.facetednavigation" -e PROFILES="eea.facetednavigation:default" plone/plone-backend
Login to http://localhost:8080/Plone/login (admin:admin)
Install EEA Faceted Navigation` via Site Setup > Add-ons
Faceted settings is a menu that appears once you enable Faceted navigation within your context next to the Actions menu and it allows you to perform the following actions:
Configure Faceted Navigation TTW.
This allows you to gain more space for faceted navigation pages by disabling Plone portlets left column.
Default: disabled (starting with version 5.2)
This allows you to gain more space for faceted navigation pages by disabling Plone portlets right column.
Default: disabled (starting with version 5.2)
Hide facets criteria if there is only one page of results.
Default: disabled (starting with version 5.2)
You can enhance and boost search by replacing ZCatalog with Apache Solr, see collective.solr. Thus:
Add collective.solr to your requirements.txt and constraints.txt:
bin/pip install collective.solr
Start solr:
$ docker run -p 8983:8983 eeacms/solr
Install collective.solr within Site Setup > Add-ons
Setup and reindex Solr within Site Setup > Solr settings
Add or replace Text widgets with Text field with suggestions within your faceted enabled items.
To include a specific select2 locale, French for instance, just import it to your webpack bundle and make the bundle depend on plone:
import 'select2/select2_locale_fr';
You can add a new autocomplete source by registering a IAutocompleteSuggest browser view, you can see an example in eea/facetednavigation/tests/autocomplete.py and eea/facetednavigation/tests/autocomplete.zcml
You also need to configure Solr to include /suggest requestHandler. Within your solrconfig.xml add:
<!-- eea.facetednavigation autocomplete -->
<searchComponent name="suggest" class="solr.SpellCheckComponent">
<lst name="spellchecker">
<str name="name">suggest</str>
<str name="classname">org.apache.solr.spelling.suggest.Suggester</str>
<str name="lookupImpl">org.apache.solr.spelling.suggest.fst.WFSTLookupFactory</str>
<str name="field">Title</str>
<float name="threshold">0.005</float>
<str name="buildOnCommit">true</str>
</lst>
</searchComponent>
<requestHandler name="/suggest" class="org.apache.solr.handler.component.SearchHandler">
<lst name="defaults">
<str name="spellcheck">true</str>
<str name="spellcheck.dictionary">suggest</str>
<str name="spellcheck.count">10</str>
<str name="spellcheck.onlyMorePopular">true</str>
<str name="wt">xml</str>
</lst>
<arr name="components">
<str>suggest</str>
</arr>
</requestHandler>
You can extend faceted navigation functionality by installing the following add-ons:
To gain performance, you can disable diazo theme on faceted results ajax requests. Go to "configuration registry" on control panel, select the key "Disable diazo rules on ajax requests" and set it True. Be sure you do not actually need it.
It has been developed and tested for Plone 2, 3, 4, 5 and 6.
See the contribution guidelines (CONTRIBUTING.md).
The EEA Faceted Navigation (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
The Initial Owner of the Original Code is European Environment Agency (EEA). Portions created by Eau de Web are Copyright (C) 2009 by European Environment Agency. All Rights Reserved.
EEA - European Environment Agency (EU)
| Back | FazBrowse Home | New Git URL |