thestreamable / kirby-clear-cloudflare-cache
Kirby plugin to clear Cloudflare cache URLs
Installs: 53
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 2
Forks: 1
Open Issues: 2
Type:kirby-plugin
Requires
This package is auto-updated.
Last update: 2022-08-14 19:20:00 UTC
README
This Kirby plugin can automatically purge Cloudflare cached URLs.
Installation
Download
Download and copy this repository to /site/plugins/clear-cloudflare-cache
.
Git submodule
git submodule add https://github.com/thathoff/kirby-clear-cloudflare-cache.git site/plugins/clear-cloudflare-cache
Composer
composer require thathoff/kirby-clear-cloudflare-cache
Setup
At a minimum, you must set the following options in your config.php
file:
'thathoff.clearcloudflarecache.cloudflareZoneID' => 'YOUR_CF_ZONE_ID', 'thathoff.clearcloudflarecache.cloudflareEmail' => 'YOUR_CF_EMAIL', 'thathoff.clearcloudflarecache.cloudflareAPIKey' => 'YOUR_CF_API_KEY',
Options
thathoff.clearcloudflarecache.cloudflareZoneID
This must be set to your Cloudflare Zone ID (available in the Overview dashboard).
thathoff.clearcloudflarecache.cloudflareEmail
This must be set to the email address of your Cloudflare account.
thathoff.clearcloudflarecache.cloudflareAPIKey
This must be set to your Cloudflare API Key (available in the Profile page).
thathoff.clearcloudflarecache.dependantUrlsForPage
This must be a function that returns what URL(s) should be cleared after a page modification.
By default, simply returns the URL of the page itself and potentially the previous URL (in the case of a slug change).
function ($hook, $page, $oldPage = null) { return $oldPage ? [$page->url(), $oldPage->url()] : $page->url(); }
If you know that a change to one page affects other pages, you could include them as well. For example, the following would clear the Cloudflare cache for a modified page siblings (including the affected page) and parent pages.
'thathoff.clearcloudflarecache.dependantUrlsForPage'=> function ($hook, $page, $oldPage = null) { return $page->parents()->add($page->siblings(true)); },
Or, a more elaborate example could include a sitemap and content representations:
'thathoff.clearcloudflarecache.dependantUrlsForPage'=> function ($hook, $page, $oldPage = null) { $urls = []; $urls[] = $page->url(); $urls[] = $page->url() . '.json'; if ($oldPage) { $urls[] = $oldPage->url(); $urls[] = $oldPage->url() . '.json'; } $urls[] = page('sitemap')->url(); $urls[] = page('sitemap')->url() . '.xml'; return $urls; },
The function may return:
- a single Page object
- a single URL string
- a Pages collection of Page objects
- an array of URL strings and/or Page objects
- null, empty array, or empty Pages collection (this will cause no cache to be cleared)
Duplicate URLs will automatically be filtered out.
All URL strings must be absolute URLs (https://www.example.com/blog
), not relative (/blog
);
License
MIT
Credits
Maintained by Markus Denhoff, originally developed by Neil Daniels of The Streamable