ORANGECOLLAR/MODULE-WORDPRESS-INTEGRATION · CACHE TAGS

Cache tags used by the WordPress Integration module

The module uses Magento’s tagged cache system. Cache entries are tagged when saved, allowing targeted invalidation without flushing the entire cache.

Cache Tag Constants

Defined in Model/Cache/CacheTag.php:

Constant	Tag Value	Covers
`CacheTag::POST`	`WORDPRESS_POST`	All post-related cache entries
`CacheTag::CATEGORY`	`WORDPRESS_CATEGORY`	All category cache entries
`CacheTag::TAG`	`WORDPRESS_TAG`	All tag cache entries
`CacheTag::MENU`	`WORDPRESS_MENU`	All menu cache entries
`CacheTag::AUTHOR`	`WORDPRESS_AUTHOR`	All author cache entries

Dynamic Tag Methods

Method	Returns	Example
`CacheTag::postTag(int $id)`	`WORDPRESS_POST_{id}`	`WORDPRESS_POST_42`
`CacheTag::authorTag(int $id)`	`WORDPRESS_AUTHOR_{id}`	`WORDPRESS_AUTHOR_5`

Tag Usage in Repositories

When the PostRepository caches a single post, it saves it with both the general WORDPRESS_POST tag and the specific WORDPRESS_POST_{id} tag. This allows:

Purging all posts at once (e.g., on a bulk publish) using WORDPRESS_POST
Purging a single post (e.g., on a single post update) using WORDPRESS_POST_{id}

Webhook to Cache Tag Mapping

When a webhook arrives from WordPress, the object_type field determines which tags to purge:

`object_type`	Tags Invalidated
`post`	`WORDPRESS_POST`, `WORDPRESS_POST_{object_id}`
`page`	`WORDPRESS_POST`, `WORDPRESS_POST_{object_id}`
`category`	`WORDPRESS_CATEGORY`
`post_tag`	`WORDPRESS_TAG`
`nav_menu`	`WORDPRESS_MENU`

Manual Cache Purge

To manually purge all WordPress cache entries from the command line:

TERMINAL

$ bin/magento cache:clean full_page block_html

To purge only the WordPress integration cache entries programmatically:

PHP

$cacheTypeList->invalidate([
    \Magento\PageCache\Model\Cache\Type::TYPE_IDENTIFIER,
    \Magento\Framework\App\Cache\Type\Block::TYPE_IDENTIFIER,
]);