Skip to content

A package that helps automatically purge CloudFlare cache.

License

Notifications You must be signed in to change notification settings

thecogworks/Cogworks.CogFlare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cogworks.CogFlare

CogFlare

NuGet release

A package that helps automatically purge CloudFlare cache

Usage

Basic Functionality

  • When any content node is changed(Published/Unpublished/Deleted), that node and any nodes referencing it will be purged from CloudFlare's cache
  • When any media item is changed(Saved), it will be purged from CloudFlare's cache
  • The ability to toggle the package functionality on/off in the settings
  • The ability to toggle the cloudfarte cache by adding the property "disableCloudFlareCache" to the node you wish to ignore
  • If you want to bypass a form page now you have 2 options, using the "disableCloudFlareCache" in the form node or using the "BlockListPropertyAlias" and "FormBlockAlias" in the settings

Advanced Functionality

  • A list of Ids for Key Nodes on the site can be configured in the Settings
  • A Key Node is any content node that will require a FULL site cache purge to be trigger if that node or any content nodes referenced by it is change (Site Settings, Navigation, Footers...)

Backoffice Dashboard

  • A dashboard has been added to the Settings section of the backoffice
  • Currenlty only Admins can access it
  • This dashboard contains a button to manually trigger a FULL site cache purge
  • There is also an option to view the current configuration for the package

Logs

There is logged message every time a node eligible for caching is changed and also to show the result of the purge request to CloudFlare

CogFlare Logs

There's also a logged message to show the result of the purge request to CloudFlare

CogFlare CloudFlare Logs

Installation

Install through dotnet CLI:

dotnet add package Cogworks.CogFlare

Or the NuGet Package Manager:

Install-Package Cogworks.CogFlare

Add these settings to the appsettings.json

  "CogFlareSettings": {
    "ApiKey": "xxx",
    "Email": "xxx@xxx.com",
    "Endpoint": "https://api.cloudflare.com/client/v4/zones/[zoneId]/purge_cache",
    "KeyNodes": "1234, 031089",
    "IsEnabled": true,
    "BlockListPropertyAlias": "",
    "FormBlockAlias": "",
    "Domain": "https://www.example.com"
  }

Backoffice User:

Email: admin@admin.com
Password: 0123456789

License

Licensed under the MIT License

© 2024 Cogworks

About

A package that helps automatically purge CloudFlare cache.

Resources

License

Stars

Watchers

Forks

Packages

No packages published