Glossario · ThinkClouds

Repository di plugin

Archivio da cui i siti scaricano plugin e aggiornamenti; per i plugin non pubblici serve un repository privato con controlli di accesso e di integrità.

Un repository di plugin è l’archivio da cui i siti WordPress scaricano i plugin e ne ricevono gli aggiornamenti. Il più grande è la directory ufficiale di WordPress.org, da cui arrivano gli aggiornamenti che compaiono nella bacheca. I plugin sviluppati per uso proprio o commerciale, che non stanno in quella directory, hanno bisogno di un repository privato: un server che conserva le versioni, dice a ogni sito se ce n’è una nuova e gli consegna il pacchetto.

Che cosa deve garantire

Un repository privato decide quale codice gira sui siti, quindi deve garantire tre cose. L’accesso: solo i siti autorizzati devono ricevere i pacchetti. L’integrità: il pacchetto installato deve essere identico a quello pubblicato, verificato con un’impronta SHA-256 o con una firma digitale. Il controllo delle versioni: deve essere possibile tenere una versione in prova su pochi siti prima di distribuirla a tutti, e ritirarla se si scopre un problema.

WordPress, dalla versione 5.8 del 2021, permette ai plugin di dichiarare nell’intestazione un Update URI, l’indirizzo da cui devono essere aggiornati. Serve a evitare che un plugin privato venga sostituito per errore da un plugin pubblico con lo stesso nome nella directory ufficiale.

In ThinkRepo

ThinkRepo trasforma thinkclouds.com nel repository privato dei plugin ThinkClouds. Ogni release si carica con il suo SHA-256, che viene confrontato con il file ricevuto; l’intestazione del plugin deve contenere una versione valida e un Update URI che punta al repository, altrimenti il caricamento viene rifiutato. Se è impostata una chiave pubblica Ed25519, il repository accetta solo pacchetti firmati. Ogni release si pubblica, si tiene in anteprima o si ritira, e porta con sé il changelog.

I plugin contengono la libreria ThinkClouds Updater: al primo contatto il sito si presenta con il proprio indirizzo e un segreto generato in locale, di cui il server conserva solo l’impronta, e resta in attesa finché non viene approvato, a mano o in automatico se il dominio è fra quelli ammessi. Da lì controlla tutti i suoi plugin con una sola richiesta, ogni sei ore, e riceve link firmati ai pacchetti, validi sette giorni. Un sito può essere spostato sul canale di prova per ricevere anche le release in anteprima. Il catalogo pubblico mostra una scheda per ogni plugin, e i download manuali sono riservati alle persone abilitate, con un codice OTP via email. ThinkWatch, sui siti, permette di aggiornare subito dal Catalogo, verificando l’impronta prima dell’installazione.

Serve aiuto?

Installiamo, configuriamo e colleghiamo il plugin al tuo sito, con i template Elementor già pronti.