Add Filtering to External Resources on Toolkit Page

[santi-jose]

Prerequisite

1. Be a member of Hack for LA. (There are no fees to join.) If you have not joined yet, please follow the steps on our Getting Started page and attend an onboarding session.
2. Before you claim or start working on an issue, please make sure you have read our How to Contribute to Hack for LA Guide.

Overview

We need to add filtering functionality to the Toolkit page so that selected filters are applied to the External Resources cards in addition to the Guide Pages cards.

Details

Currently, the Toolkit page includes two types of cards:

• Guide Pages cards, e.g. 2FA Guide, Building a Survey Reporting Dashboard
• External Resources cards, e.g. Figma, GitHub

Filters are currently generated only from Guide Page card attributes and are applied only to Guide Page cards. This functionality should be preserved for the Guide Page cards, and expanded so External Resource cards can also be filtered by 'Practice Area' and 'Tools' selections. This issue requires the following changes:

1. Update the External Resource card HTML to add a new "tools" data attribute in addition to the existing "practice area" attribute for storing card info, and add a new class to help JS querying these cards.
2. Update the filter generation JS to include External Resource card attributes, and update the filtering to apply to the External Resource cards.

Action Items

• In /assets/js/toolkit.js, examine the applyFilters and retrieveFilterCategories functions to understand how filters are currently generated and applied to the Guide Page cards. The following files will also be helpful to view to understand how the External Resource cards are created:
  • includes/current-guides.html
  • data/internal/toolkitresources.yml
  • includes/guide-card.html
• In current-guides.html, make the following changes:
  • External Resource card div elements should have an attribute data-project-tools alongside the data-article-type attribute. data-project-tools should be populated from the tools listed in toolkitresources.yml.
  • Each External Resource card div should have the class resource-card.
• In toolkit.js, edit the retrieveFilterCategories function to add Practice Area and Tools categories from External Resource cards to the filters list, using the attributes you added in the previous steps.
• Edit the applyFilters function to filter the External Resources cards when a Practice Area or Tools filter is selected. The other filter categories Status, Source, and Contributors will not apply to External Resources, so if one of them is selected, all External Resource cards should be hidden.
• Test that the filters work as expected to filter both Guide Cards and External Resource cards.
• Verify that the URL parameters are still updated when filters are selected and deselected.
• If it was necessary to make changes to other functions or files in the course of this issue, make note of these additional changes in your PR.

Resources/Instructions

• Toolkit Page: https://www.hackforla.org/toolkit/
• JS file containing filtering function: assets/js/toolkit.js
• HTML file template for toolkit cards: includes/current-guides.html
• YAML file with External Resource card data: data/internal/toolkitresources.yml
• HTML template for Guide Page cards: /includes/guide-card.html
• This issue initiated by: ER: Add filtering to External Resources on Toolkit page #8509