Quickstart Finder

Quickstart Finder is a module that can be enabled to allow you to add search and filter functionality to a variety of views. Quickstart Finder works with AZ Pages, AZ News, AZ Events, and AZ People.

Image

How to implement

First, add the desired content view of pages, news, events, or people to a page:

1. Create a page
2. Add a View paragraph type 
3. Select desired view from the options above
4. Save the page
5. Copy the URL path of the page after .edu or .io

Next, enable the filter block to display as a sidebar on the page:

1. Navigate to Structure > Block layout
2. Next to the Sidebar first region, select Place block
3. Select Place block next to the matching block 
   1. Specific block names are identified above
4. Change the block settings as needed
   1. Select the desired title settings
   2. Under visibility, select Pages and paste the page path in the box to the right
   3. Save block
5. Save blocks

Now you will see the view results and block on the page you created.

Change filter formatting

To allow for headings and more functionality as seen in the screenshot below, a taxonomy hierarchy must be implemented.

Image

1. Navigate to Structure > Taxonomy
2. Click List terms next to Page Categories
3. Add terms if needed
4. Drag and drop terms in the desired nesting structure
   1. Any term that has nested terms become non-clickable headings that the user can expand or collapse.
   2. Taxonomy terms with child terms are best named as a category and are not something that the user would expect to use as a filter for the results.
5. Save

Updating Finder Functionality

NEW IN 2.11

Set finder overrides, providing enhanced control over search and filter functions on Finder enabled views.

Steps to Set Finder Overrides

1. Access Finder Settings
   • Navigate to Configuration > AZ Quickstart Settings > AZ Finder or directly go to /admin/config/az-quickstart/settings/az-finder.
2. Configure Finder Overrides
   • Default Display: Choose between "Expanded" or "Collapsed" for how taxonomy terms with children should behave by default.
     • This setting is applied universally and is not context-aware, meaning terms must be using a collapsible element if "Collapsed" is selected.
   • Add an Override:
     • Select a specific filter widget from the dropdown to override the default display for each taxonomy term.
     • Click "Override" to add the selected override.
   • Override Settings for Specific Vocabularies: Adjust settings for how filter widgets behave when they have child terms, grouped by vocabulary.
     • For each term, select "Expanded", "Collapsed", or "Default".
3. Save and Apply Changes
   • Click Save configuration to apply the new settings. The changes will take effect immediately.
4. Clear Cache
   • After saving the changes, navigate to /admin/config/az-quickstart/settings and click Clear all caches to ensure the new settings take effect.

Updating Existing Finder Blocks

Review and update your current finder blocks to use the new overrides, ensuring you leverage the enhanced features.