Purge Core Tags - Exclude by Bundle
This module lets you exclude specific content types or other entity bundles from triggering cache purges when they are updated. It provides a simple administrative interface to select which bundles should not be included in the purge queue, helping to prevent unnecessary cache invalidations for certain content.
Exclude specific bundles from being queued by Purge’s Core Tags queuer. Filters entity cache tag invalidations so selected bundles do not enqueue purge items. Simple admin UI; no hacks to contrib; Drupal 10/11.
Features
- Exclude bundles (content types, vocabularies, media types, etc.) from Purge queueing.
- Decorates
purge_queuer_coretags.queuer; no patching of contrib. - Understands and filters:
- Entity tags:
entity_type:ID(e.g.,node:123). - List tags:
entity_type_list. - Bundle-scoped list tags:
entity_type_list:bundle(e.g.,node_list:article).
- Entity tags:
- Conservative behavior on deletes/unknown bundles to avoid stale caches.
- Configuration UI to pick excluded bundles per entity type.
- Dependency injection, bulk loading; lightweight and fast for editorial flows.
- Ideal when only certain content types should trigger CDN/varnish purges.
Post-Installation
- Enable the module.
- Ensure Purge and Core Tags queuer are enabled.
- Go to:
/admin/config/development/performance/purge-coretags-exclude-bundle. - Select the bundles you want to exclude from purge queueing and save.
- Perform CRUD operations; excluded bundles will no longer enqueue purge items.
No additional UI is added beyond the settings page. Works automatically once configured.
Additional Requirements
- Drupal core 10 or 11.
purgemodule.purge_queuer_coretagssubmodule.
Recommended modules/libraries
- Purge purgers such as Varnish/CDN integrations (e.g., Varnish Purger, Fastly, Cloudflare) depending on your stack.
- Drupal’s Performance and Purge UI/diagnostics tools to inspect queues.
Similar projects
You can achieve related behavior by writing a custom Purge queuer plugin. This project is different because it decorates the Core Tags queuer, keeping your stack unchanged while adding per-bundle filtering.
Supporting this Module
Feedback and contributions are welcome via issue queues and pull requests. If this module saves you time, consider crediting the project in releases or contributing documentation/tests.
Community Documentation
- README: consult the included
README.mdfor full usage details and examples. - Purge module documentation: explains queuers, processors, purgers, and queues.
You may include additional background or site-specific guidance below as needed.