This project is not covered by Drupal’s security advisory policy.

Want to take over the Guide namespace?

This module was started upon client request but never used. Thus it has not been developed further and is incomplete. I am open to transfer owner- and maintainership, regardless of whether or not it will be brought forward or replaced by something else.

Original (obsolete) information:
Do your website users need a Guide to find content or do you have large and complex search facets?

This module might help. It provides a guiding system in form of a decision tree where each answer can lead the user to a specific node or add filters to a faceted search.

How does it work?
As an admin, you create various questions where each question is an entity of the new entity type question. The module also contains a new field type answer which allows you to set unlimited answers for a question. While the answer text is displayed to the user, each answer contains more fields which allow you to set an action for each individual answer. The main action is to add a filter to a faceted search. Upon choosing this action, you can choose a facet source (Search API View), one or more facets for that source and one or more possible parameters in each facet.

Next, you add a dialog (also a new entity type) where you can set an introduction and add questions. The order of questions is important and there is also an interface to define the dialog's logic, e.g. only show a specific question if a previous question was answered in a defined way.

When the user completes the dialog (multistep form), the user will be redirected to a search page with all filters preset depending on your answers' definitions.

Current status
The module is now a working draft, dialogs, questions and answers can be added and are stored in the database correctly. Upon submitting the guide, the search page with all filters set is called as well.

Open issues include:

  • Define the target search in Dialog
  • Optimise AnswerFieldWidget by only loading required facets
  • Restrict logic source questions to previously appearing ones
  • Replace integer (nid) field with Autocomplete field for "Redirect to a node" action
  • Add actual redirect code for "Redirect to a node" action
  • Clean up code base
  • Consolidate strings for translation
Supporting organizations: 
Initial development

Project information

Releases