Toucher2

This is a Dokuwiki plugin that revived (original: toucher), it having been not updated in twelve years and officially marked as dead.

What toucher2 does is 'touch'¹⁾ the dokuwiki configuration file. This has the effect of invalidating the cache.

Dokuwiki builds pages from various sources - the general layout template, the actual page content etc. - and then caches them. Sometimes an update occurs that isn't visible, because the page is still being served from the cache. Invalidating the cache forces the page to be rebuilt.

The original toucher plugin invalidated the cache every time a page was created or updated - provided the page was created/updated by a manager or admin. It also had the ability via configuration, to limit that to just admins. There is also an option from the admin menu to do an ad-hoc touch.

I have now updated toucher2:

1. the original code didn't actually enforce the configuration options
2. the new code can also be configured to only allow touching via the admin menu

The code now properly enforces the touching only occurs when managers (if config option allows) or admins trigger a touch when creating/updating a page.