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

  1. Costruisci l'artefatto ZIP con composer plugin:build.
  2. Caricalo tramite System -> Plugins.
  3. Rivedi la schermata dei dettagli del plugin.
  4. Ebilita il plugin.
  5. Se i report sullo stato Setup required o Plugin migrations pending, esegui Run Plugin Migrations dalla schermata dei dettagli del plug-in.
  6. Apri /webadmin/plugins/webblocks-ui-manager/releases dalla barra laterale o direttamente al termine della configurazione.
  7. 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.