WebBlocks UI Manager
Requisiti
Versione pacchetto documentato: 0.2.0. WebBlocks CMS ^1.32; PHP >=8.3.
Plugin operatore interno per metadati di rilascio WebBlocks UI e preparazione CDN locale di prima parte flussi di lavoro. Non è per installazioni generali: appartiene agli host degli operatori che pubblicano WebBlocks UI, come webblocksui.com.
Cosa fa e cosa si rifiuta di fare
Il plugin registra le versioni WebBlocks UI, convalida una serie di file dist rispetto a SHA-256 archiviati
checksum e li scrive in una radice statica di proprietà del progetto in public/cdn/webblocks-ui/{version}.
Non crea WebBlocks UI, distribuisce su un'infrastruttura di produzione esterna, pubblica il server di aggiornamento
metadati o modificare ciò che consuma il CMS. Le directory degli artefatti con versione sono immutabili: un file esistente
file il cui checksum corrisponde viene saltato e uno il cui checksum è diverso blocca l'esecuzione anziché
essere sostituito. latest non viene mai scritto.
L'esecuzione a secco segnala ogni scrittura, salto e blocco senza toccare il filesystem. Eseguirlo prima di applicare.
Ciclo di vita manuale
- Costruisci l'artefatto ZIP con
composer plugin:build. - Caricalo tramite
System -> Plugins. - Rivedi la schermata dei dettagli del plugin.
- Ebilita il plugin.
- Se i report sullo stato
Setup requiredoPlugin migrations pending, eseguiRun Plugin Migrationsdalla schermata dei dettagli del plug-in. - Apri
/webadmin/plugins/webblocks-ui-manager/releasesdalla barra laterale o direttamente al termine della configurazione. - Disabilitare prima della disinstallazione. La disinstallazione rimuove il pacchetto caricato e lo stato abilitato, ma conserva le tabelle
webblocks_ui_manager_*.
La schermata Versioni controlla webblocks_ui_manager_releases, webblocks_ui_manager_artifacts e webblocks_ui_manager_publish_runs prima di eseguire una query. Le tabelle mancanti forniscono indicazioni di configurazione controllate sull'URL delle versioni, incluso un collegamento ai dettagli del plug-in e un'azione di migrazione del super amministratore, invece di un errore del database non elaborato o un reindirizzamento del dashboard.
E i percorsi amministrativi abilitati utilizzano le autorizzazioni di proprietà del plug-in. webblocks-ui-manager.view protegge le pagine di elenco/dettagli delle versioni, webblocks-ui-manager.manage protegge le modifiche ai metadati delle versioni e la pagina delle impostazioni e webblocks-ui-manager.publish protegge le azioni di pubblicazione. Agli utenti CMS super_admin sono consentite queste autorizzazioni di plug-in attive; altri ruoli richiedono una concessione esplicita dell'autorizzazione CMS prima di accedere al plugin.
CMS v1.32.75+ collega l'intero albero del percorso delle impostazioni/rilasci dell'amministratore di WebBlocks UI Manager attraverso il core CMS, incluse le azioni Nuova versione, modifica/aggiornamento, esecuzione a prova e pubblicazione. Ciò mantiene abilitate le azioni manuali compatibili del plug-in su /webadmin/plugins/webblocks-ui-manager/... anche quando la copia dell'artefatto caricata ha un contesto di percorso/origine non aggiornato.
Comandi
php artisan webblocks-ui-manager:prepare-release v2.7.9 --artifact=/path/to/webblocks-ui.css
php artisan webblocks-ui-manager:publish-release v2.7.9 --dry-run
php artisan webblocks-ui-manager:publish-release v2.7.9
Convenzioni
handle webblocks-ui-manager
settings namespace webblocks_ui_manager
database prefix webblocks_ui_manager_
view namespace webblocks-ui-manager::
admin routes /webadmin/plugins/webblocks-ui-manager
route names webblocks.plugins.webblocks_ui_manager.*
commands webblocks-ui-manager:prepare-release, :publish-release
permissions webblocks-ui-manager.view, .manage, .publish
publish è separato da manage apposta: registrare l'esistenza di una versione e scrivere file
nella root CDN ci sono atti diversi e l'installazione di un operatore dovrebbe essere in grado di concederne uno senza
l'altro.