Skip to content

feat: add category filtering and tagging for abilities in Ability Table#355

Merged
dkotter merged 12 commits intoWordPress:developfrom
HILAYTRIVEDI:feature/add-categories-ablility-filter
Apr 1, 2026
Merged

feat: add category filtering and tagging for abilities in Ability Table#355
dkotter merged 12 commits intoWordPress:developfrom
HILAYTRIVEDI:feature/add-categories-ablility-filter

Conversation

@HILAYTRIVEDI
Copy link
Copy Markdown
Contributor

@HILAYTRIVEDI HILAYTRIVEDI commented Mar 30, 2026

What?

Closes #344

Adds a Category filter to the Abilities Explorer, allowing users to filter abilities by functional area (e.g., Image, Editorial, Content).

Why?

The Abilities Explorer currently only allows filtering by Provider (Core, Plugin, Theme), which makes it difficult to find abilities based on what they do, especially in large lists. This PR addresses the need for functional filtering by introducing a Category filter, making it easier to discover abilities by their purpose (e.g., image handling, content editing).
References: [Original issue] (summarize: lack of functional filtering in Abilities Explorer).

How?

This PR adds a Category filter dropdown to the Abilities Explorer UI. Categories are auto-derived from ability slugs using keyword matching, and can be extended or overridden by third-party plugins via the ai_ability_category_map and ai_ability_tags filter hooks. The filter works identically to the Provider dropdown: it is server-side, persists in the URL, and is submitted via the same Filter button.

Testing Instructions

  1. Go to the Abilities Explorer in the admin interface.
  2. Observe the new Category filter dropdown next to the Provider filter.
  3. Select a category (e.g., Image, Editorial, Content) and click the Filter button.
  4. Confirm that the list of abilities updates to show only those matching the selected category.
  5. Change the Provider filter and verify that both filters work together as expected.
  6. Check that the selected filters persist in the URL and after page reload.

Testing Instructions for Keyboard

  1. Tab to the Category filter dropdown.
  2. Use arrow keys to navigate and select a category.
  3. Tab to the Filter button and press Enter.
  4. Verify that the filtered results are accessible and that focus order is logical.
  5. Tab through the Provider filter and ensure all controls are reachable and operable via keyboard.

Screenshots or screencast

https://www.awesomescreenshot.com/video/50968973?key=5acd67e6e7dc53b4aa9d85fe075a9709

Open WordPress Playground Preview

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 30, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: HILAYTRIVEDI <hilayt24@git.wordpress.org>
Co-authored-by: dkotter <dkotter@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@codecov
Copy link
Copy Markdown

codecov bot commented Mar 30, 2026

Codecov Report

❌ Patch coverage is 84.37500% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 57.95%. Comparing base (d479cf3) to head (0126bf0).
⚠️ Report is 13 commits behind head on develop.

Files with missing lines Patch % Lines
...s/Experiments/Abilities_Explorer/Ability_Table.php 77.27% 5 Missing ⚠️
Additional details and impacted files
@@              Coverage Diff              @@
##             develop     #355      +/-   ##
=============================================
+ Coverage      57.70%   57.95%   +0.25%     
- Complexity       617      629      +12     
=============================================
  Files             46       46              
  Lines           3173     3204      +31     
=============================================
+ Hits            1831     1857      +26     
- Misses          1342     1347       +5     
Flag Coverage Δ
unit 57.95% <84.37%> (+0.25%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@HILAYTRIVEDI HILAYTRIVEDI requested a review from dkotter March 31, 2026 19:43
Copy link
Copy Markdown
Collaborator

@dkotter dkotter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would also be great to add some E2E tests to cover the changes here, verifying the category dropdown renders and works as expected

@HILAYTRIVEDI
Copy link
Copy Markdown
Contributor Author

Would also be great to add some E2E tests to cover the changes here, verifying the category dropdown renders and works as expected

@dkotter I added the E2E test for the category dropdown.

@HILAYTRIVEDI HILAYTRIVEDI requested a review from dkotter March 31, 2026 23:09
Copy link
Copy Markdown
Collaborator

@dkotter dkotter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for all the back and forth here, this is looking really good and I think we're close, just a few final things I've noticed.

@HILAYTRIVEDI
Copy link
Copy Markdown
Contributor Author

Sorry for all the back and forth here, this is looking really good and I think we're close, just a few final things I've noticed.

@dkotter no worries at all . I am new to the AI contribution in core WordPress. So I am actually grateful for your time you are giving in review and feedback. I really appreciate it . As moving forward in other PRs I will keep this feedbacks in mind before review. 🙇

@HILAYTRIVEDI HILAYTRIVEDI requested a review from dkotter April 1, 2026 18:14
@dkotter dkotter merged commit 5af7651 into WordPress:develop Apr 1, 2026
18 checks passed
@dkotter dkotter added this to the 0.7.0 milestone Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add category drop down in the ability explorer page to filter out the abilities based on their categories.

2 participants