Toolkit›Customize›Addons›Addons - Filter Engine

Addons - Filter Engine

Let visitors narrow your directory by the details on each listing as well as by keyword. One panel serves your member search, your categories, your events, and any custom post types you create.

Filter product card

What it does

Your directory can already be searched by keyword, by location and by category. Filter Engine adds the part that was missing: searching by the details you actually collect on each listing, such as specialties, services, languages, availability or price band, whatever your signup form asks for.

Visitors tick what they need and the results narrow to the listings that match.

It does not replace your existing search. Your keyword box and your location box can sit in the same panel and work exactly as before.

Where it lives

In your DirectoryCustomize plugin admin: Plugins then DirectoryCustomize then My Widgets then Filter Engine.

The settings are split into tabs along the top (Setup, Filters, Design, Config, Inject and Override), and most of the work happens on the Filters tab.

You add the panel to a sidebar, and it shows the filters that belong to whatever page it is on. One copy serves your member search, your category pages, your events, and any custom post types you have created, each showing its own fields, with nothing to set per page.

The panel uses your site's own block styling, so it matches everything else in that sidebar without you choosing any colors.

Setting up your filters

The Filters tab works in three steps.

Step 1: Content type. Pick the kind of listing you are setting filters for, such as Member Listings, Events or one of your own post types. Each content type keeps its own set of filters. The buttons are colored to show where you stand: green means filters are set up and live, yellow means set up but switched off, and gray means none yet.

Step 2: Layout. Choose where the filters appear. Each card is one place they can show, and they all share one set of filters, so editing a filter once updates it everywhere it appears. Each place keeps its own order. More on the places below.

Step 3: Filter settings. Add, arrange and adjust the filters themselves:

  • Add filter group adds a heading with filters under it.
  • Quick setup and Fit this site build a starting set from the fields your listings actually use.
  • Presets saves a setup you like or loads one you saved earlier.
  • Heading above the filters puts a title such as "Refine your search" at the top of the panel. Leave it empty for no heading.
  • Show sort control adds a sort menu to the panel, and Show option counts shows how many listings match beside each choice.
  • All active, All inactive, Expand all and Collapse all help when the list gets long.

Check a field has answers before you add it, since a field nobody has filled in gives an empty filter.

Where the filters can appear

On your search results page:

  • Sidebar is the usual column of filters beside the results.
  • Top Bar is a row of filters above the results.

Anywhere you paste it:

  • Widget is a panel you place yourself, for example in your homepage hero. Switch it on and it gives you a paste line, such as [widget=Filter Engine], to put on any page.

In the All Filters popup:

  • All Filters is a popup that opens from a button and can show filters from every other place at once.

As a step-by-step quiz:

  • Quiz asks one question at a time, then shows the results, and each place can offer its own quiz button.

Each place has the same few switches:

  • Show on desktop, mobile or both.
  • Filter when they press Search or Filter automatically as they choose.
  • Lay out stacked or across.

Panels you place yourself

Under Where this one goes, the Filter panels on your site list shows each panel you have made with Add a panel. Each one keeps its own settings. For each panel you can:

  • switch it on or off,
  • rename it with the pencil beside its name,
  • Open it to change what it shows,
  • Copy its paste line,
  • Put it on my homepage hero,
  • or Delete it.

Changes save by themselves, the same as anywhere else in the plugin.

Each filter's settings

Click a filter to open its settings, laid out on these tabs:

Display sets how the filter looks to visitors. The choices are:

  • Checkboxes
  • Dropdown
  • Radio buttons
  • Text
  • Yes / no toggle
  • Buttons, drawn as pills, a segmented bar or tiles
  • Stepped number, such as 1+ / 5+ / 10+
  • Date range, with a calendar and quick picks such as This week
  • Checklist - Search Assist, a checkbox list with a box above it that narrows the choices as the visitor types. Good for a field with many values.
  • Dropdown - Search Assist
  • Number - Range, Number - Slider and Number - One bound
  • Picture tiles
  • Checklist - Clickable Map, a map visitors click to pick a region, with the full list underneath

Category filters can also show as an expandable tree or as linked dropdowns, one per level.

Options is where you pin, promote, rename, hide and reorder the choices a visitor sees in this filter. Click Edit options to work on them full screen.

The choices themselves come from the field on your form. Renaming a choice here changes it in this filter only. To add a choice, or change one everywhere it shows, edit that field in Form Manager. The Options tab links you there.

Shows when makes a filter appear only after another one is answered, for example Times once a visitor picks a Day.

Matching logic sets how ticking several choices in this filter combines, and whether visitors can change it themselves.

Choosing more than one value

Ticking two choices in the same filter widens the results: pick Anxiety and Trauma and you get listings offering either.

Using two different filters narrows them: pick a specialty and a city and you get listings that match both.

Listings matching more of what was asked for are shown first, with a small note on the card saying how many of your choices they match.

When a visitor ticks two or more choices in one filter, a line under the choices reads Show results with any all none of these:

  • any shows listings with at least one of the choices,
  • all shows only listings with every choice,
  • none shows listings with none of them.

The one in use is in bold with a solid underline, and the other two have a dotted underline so you can tell they can be clicked.

The applied filters at the top of the panel say the same thing, for example Session · any of these.

The keyword box can sit in the same panel as your other filters.

  • Several words find listings with any of the words. The same any / all line lets a visitor ask for listings with every word instead.
  • Words in double quotes stay together as one phrase.
  • A word that finds nothing gets a suggestion under it when there is a close match, for example "Search for therapy instead" after a search for therapist. A word that finds results gets no suggestion, and neither does a word with nothing close.

You can switch the suggestion off, and list words that mean the same thing, in the keyword filter's Matching logic tab.

Filtering by opening times and Available now

Open hours and Available now, in the Add filter list, work with other plugins:

  • Open hours needs Directory Hours. It shows quick picks (Open now, Open today, Open late, Open this weekend, Open 24 hours) and a day and time picker for anything else, such as Saturday after 10 PM. Times are read in each member's own time zone.
  • Available now needs Online Status with an Available now badge, and finds members who have switched it on.

Each one stays off your page until the plugin it needs is installed.

Can I put filters on the global search page?

The global search page is the one that shows members, articles, events and everything else together in tabs. It takes one extra click, once.

Every other page belongs to a single content type, so filters are attached for you automatically. The global search page belongs to none of them, which is the point of it, so it uses a different part of your site settings and that part needs a person to press Save once.

Do you need it? Often not, so decide before spending time on it. Most directories send visitors to the member search or to a category, and seldom to the all-in-one page. If that is true of yours, leaving it off costs you nothing and your filters keep working everywhere else.

If you do want it, three options:

  • Leave it off. Nothing breaks. The global search page keeps its normal keyword box.
  • Do it yourself. In your admin: Toolbox then Sidebar Manager, open Global Website Search, add the Filter Engine widget, and save. Refresh the page and the filters are there.
  • Have us do it. If you would rather not go into settings, it can be handled as part of a setup service. See Agency setup, or contact support and we will add it for you.

On a phone

The filters collapse into a button at the bottom of the screen. Tapping it opens them over the page, so a visitor is not scrolling past every result to reach them, and Done returns them to the results.

Common questions

How do I add a choice to a filter?

Add it to the field in Form Manager. The filter picks it up from there. The Options tab only changes how existing choices show in this filter.

Why is one of my filters empty?

A filter shows the values your listings have filled in, so a field nobody has used yet has nothing to show. Fill in a few listings, or choose a different field.

I changed a filter. Does it change everywhere?

The filter itself is shared by every place it appears, so a change to it shows in the sidebar, the top bar and the popup alike. Each place keeps its own order, and you can switch a filter on or off in one place without the others.

Can I have a different panel on my homepage?

Yes. Use Add a panel, set it up, then Put it on my homepage hero or paste its line where you want it.

Still stuck?

Contact support and we will take a look at your site.