Cloudflare Cache Purge

Introduction

Cloudflare Cache Purge clears your Cloudflare cache when your Joomla site changes, and adds a box to the administrator home page to clear it by hand: the whole cache, or just the addresses you type. Visitors and search engine crawlers see fresh content instead of a stale cached page.

It is best-effort: if the purge call ever fails, your save is never blocked; the failure is logged and shown in the box.

Features

Automatic purge when an article, category, menu item, site module, custom field or tag is saved, changes state or is deleted. Each kind of change has its own switch.
Whole cache or only the changed addresses (article, its categories, home page, fixed extras such as the sitemap). Optionally also when you use System > Clear Cache.
Administrator home page box: traffic light of the Cloudflare connection, Clear the whole cache, a field for one or more addresses, and the outcome of the last purge. Shown only to Super Users and the user groups you choose; every request is checked on the server.
Guided setup with a Verify connection button: where to find the Zone ID, how to create a token with only the Zone > Cache Purge > Purge permission, and plain-language messages when something is wrong. With the optional Zone > Zone > Read permission it finds the Zone ID by itself.
Works with the standard back-end, the front-end article form and the Joomla Web Services API.
One-click updates through the Joomla Update System. English and Italian.
Clean, complete uninstall: no custom database tables, no leftover files (the log is removed too).

Configuration

Install the package; it enables the plugins and publishes the box on the home page.
Open System > Plugins > Content - Cloudflare Cache Purge and follow the four steps at the top: Zone ID, API token, paste, Verify connection, Save.
Optionally choose what to clear and which changes trigger it.

External service & privacy

This extension connects to the Cloudflare API (https://api.cloudflare.com) to verify your token and zone and to request a cache purge for your configured zone. It sends only authenticated API requests (your API token, the Zone ID and, when you purge only some pages, the public addresses of your own site), over HTTPS. No visitor data and no personal data are ever sent. The verification sends one purge request for an address that does not exist, to prove the token may purge. The token is stored in the plugin options and written nowhere else (not in the log). A Cloudflare account and a site served through Cloudflare are required for the extension to do anything.

Documentation & support

User guide: https://github.com/WebG-it/cloudflare-cache-purge/blob/main/docs/cfpurge/USAGE.md
Source code & issue tracker: https://github.com/WebG-it/cloudflare-cache-purge

Released under the GNU General Public License v2 or later.

Cloudflare Cache Purge svuota la cache di Cloudflare quando il tuo sito Joomla cambia, e aggiunge un riquadro nella home dell'amministrazione per svuotarla a mano: tutta la cache oppure solo gli indirizzi che scrivi. Visitatori e motori di ricerca vedono contenuti aggiornati invece di una pagina vecchia in cache.

Lavora in modalità best effort: se la richiesta di svuotamento fallisce, il salvataggio non viene mai bloccato; l'errore viene registrato e mostrato nel riquadro.

Funzioni

Svuotamento automatico quando un articolo, una categoria, una voce di menu, un modulo del sito, un campo personalizzato o un tag viene salvato, cambia stato o viene eliminato. Ogni tipo di modifica ha un suo interruttore.
Tutta la cache o solo gli indirizzi modificati (articolo, sue categorie, home page, indirizzi fissi come la sitemap). Facoltativamente anche quando usi Sistema > Svuota cache.
Riquadro nella home dell'amministrazione: semaforo della connessione a Cloudflare, Svuota tutta la cache, un campo per uno o più indirizzi e l'esito dell'ultimo svuotamento. Lo vedono solo i Super Utenti e i gruppi che scegli; ogni richiesta è controllata sul server.
Configurazione guidata con il pulsante Verifica connessione: dove trovare lo Zone ID, come creare un token con il solo permesso Zone > Cache Purge > Purge e messaggi chiari quando qualcosa non va. Con il permesso facoltativo Zone > Zone > Read trova da solo lo Zone ID.
Funziona con il back end standard, con il modulo di inserimento articoli del front end e con le Web Services API di Joomla.
Aggiornamenti con un clic dal sistema di aggiornamento di Joomla. Inglese e italiano.
Disinstallazione pulita e completa: nessuna tabella personalizzata nel database, nessun file residuo (anche il registro viene rimosso).

Configurazione

Installa il pacchetto: attiva i plugin e pubblica il riquadro nella home.
Apri Sistema > Plugin > Contenuto - Cloudflare Cache Purge e segui i quattro passi in alto: Zone ID, token API, incolla, Verifica connessione, Salva.
Se vuoi, scegli cosa svuotare e quali modifiche lo attivano.

Servizio esterno e privacy

Questa estensione si collega alle API di Cloudflare (https://api.cloudflare.com) per verificare token e zona e per richiedere lo svuotamento della cache della zona che hai configurato. Invia solo richieste autenticate (il tuo token API, lo Zone ID e, quando svuoti solo alcune pagine, gli indirizzi pubblici del tuo sito), tramite HTTPS. Non vengono mai inviati dati dei visitatori né dati personali. La verifica invia una richiesta di svuotamento per un indirizzo che non esiste, per provare che il token può svuotare. Il token è salvato nelle opzioni del plugin e scritto in nessun altro posto (nemmeno nel registro). Servono un account Cloudflare e un sito servito tramite Cloudflare, altrimenti l'estensione non fa nulla.

Documentazione e supporto

Guida in italiano: https://github.com/WebG-it/cloudflare-cache-purge/blob/main/docs/cfpurge/USO.md
Codice sorgente e segnalazioni: https://github.com/WebG-it/cloudflare-cache-purge

Rilasciato con licenza GNU General Public License v2 o successiva.