Skip to content

Conversation

@sanketio
Copy link

@sanketio sanketio commented Aug 12, 2025

Note

This is a part 2 for #428, and a replacement for #1244 (which only supports category filter)

Description of the Change

This update enhances the "Pull" feature by enabling taxonomy-based filtering for content fetched from remote sites. It adds:

  • Support for taxonomies: Editors can now narrow down pulls using category, tag, or custom taxonomy filters—improving efficiency when selecting remote content.
  • Dynamic filter UI: Taxonomy filter options appear dynamically based on the remote source, ensuring only relevant filters are exposed.
  • Backwards-compatible behavior: If no filters are applied, the pull interface behaves as before, preserving existing workflows.
  • Developer-friendly hooks: Includes new filters/actions allowing customization of which taxonomies appear in the UI.
    • dt_allowed_pull_taxonomies - allows more taxonomy filters. By default, only category is allowed. This is a general filter for all the taxonomies supported by all the post-types.
    • dt_available_pull_taxonomy_terms - allows filtering the terms.
    • distributable_{$taxonomy}_terms - allows distributable terms based on the taxonomy.

How to test the Change

  1. Open post pull screen
  2. You should be able to see post categories in the filter by default, if the selected post-type supports it.
  3. Based on the post-type change, the allowed taxonomy filters should be changes with the supported ones and available ones.
  4. Select a taxonomy and filter. The posts should be filtered by the selected.
  5. You should see the columns in the list table dynamically updated based on the supported taxonomies.
  6. Pull the posts and verify only posts from that taxonomy term have been pulled, if the current site has that taxonomy registered.
  7. Verify it on both internal and external connections.
  8. Verify it in conjunction with post type filter as well.
  9. Once the filter is applied, the Reset Filters button should be visible.
  10. Clicking on Reset button should clear out the filters.

Changelog Entry

Added - Taxonomy filter for remote content pulls—allows filtering by category, tag, or custom taxonomy

Credits

Props @sanketio

Checklist:

@sanketio sanketio requested a review from a team as a code owner August 12, 2025 16:06
@sanketio sanketio requested review from iamdharmesh and removed request for a team August 12, 2025 16:06
@sanketio sanketio marked this pull request as draft August 12, 2025 16:06
…s HTML

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@sanketio sanketio mentioned this pull request Aug 12, 2025
4 tasks
@sanketio
Copy link
Author

@jeffpaul Is it okay if I merge this to the base PR: #1237? So that we have one place for the feature?

@sanketio sanketio marked this pull request as ready for review August 12, 2025 16:17
@sanketio sanketio requested a review from jeffpaul August 21, 2025 12:45
@jeffpaul
Copy link
Member

jeffpaul commented Sep 3, 2025

@jeffpaul Is it okay if I merge this to the base PR: #1237? So that we have one place for the feature?

@dkotter @peterwilsoncc any concerns with this approach?

@jeffpaul jeffpaul added this to the 2.2.0 milestone Sep 3, 2025
@jeffpaul jeffpaul moved this to In Progress in Open Source Practice Sep 3, 2025
@dkotter
Copy link
Collaborator

dkotter commented Sep 4, 2025

@jeffpaul Is it okay if I merge this to the base PR: #1237? So that we have one place for the feature?

@dkotter @peterwilsoncc any concerns with this approach?

No, I think that's fine. I'll admit I'm a little confused on all the different PRs we have here so merging this into the main branch will help a bit

@dkotter dkotter modified the milestones: 2.2.0, 2.3.0 Sep 4, 2025
@sanketio sanketio merged commit 93efd0d into feature/show-category-pull Sep 5, 2025
4 checks passed
@github-project-automation github-project-automation bot moved this from In Progress to Done in Open Source Practice Sep 5, 2025
@sanketio sanketio deleted the feature/show-taxonomy-filters branch September 5, 2025 10:55
@sanketio
Copy link
Author

sanketio commented Sep 5, 2025

Thanks, @dkotter! I have merged this to the main PR: #1237

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

3 participants