How To
Documentation
    Learn More

      Configuring the Hierarchical Facet Service

      To correctly display a taxonomy as a hierarchical facet you must configure the requisite Appkit service to retrieve the data structure that is configured in your Solr index.

      First you must create a service configuration:

      /conf
          /services
              /hierarchical
                  /hierarchical.conf

      The file 'hierarchical.conf' should be configured similar to this example:

      name: twigkit.search.solr.service.facet.GreedySolrHierarchicalFacetService
      platform: platforms.solr
      parents-suffix: _parent

      platform
      This specifies the configured platform where the taxonomy has been indexed.

      parents-suffix
      The suffix that, if appended to the facet’s fieldname, designates the field containing parent node data. The suffix will depend on how the taxonomy data has been indexed.

      This service configuration is what is used when adding the hierarchical facet to your HTML page as in this example:

      <search:facet facet-name="location" show="6" show-more="100" max-characters="35" collapsible="true">
          <facet:hierarchical title="location" facet-name="location" platform="myHierarchicalPlatform" query="myHierarchicalQuery"></facet:hierarchical>
      </search:facet>