WebBlocks UI Manager

Anforderungen

Dokumentierte Paketversion: 0.2.0. WebBlocks CMS ^1.32; PHP >=8.3.

Internes Operator-Plugin für WebBlocks UI-Release-Metadaten und lokale CDN-Vorbereitung durch Erstanbieter Arbeitsabläufe. Es ist nicht für allgemeine Installationen gedacht: Es gehört zu den Betreiber-Hosts, die WebBlocks veröffentlichen Benutzeroberfläche, z. B. webblocksui.com.

Was es tut und was es ablehnt

Das Plugin zeichnet WebBlocks UI-Releases auf und validiert einen Satz dist-Dateien anhand des gespeicherten SHA-256 Prüfsummen und schreibt sie in ein projekteigenes statisches Stammverzeichnis unter public/cdn/webblocks-ui/{version}.

WebBlocks UI wird nicht erstellt, auf externer Produktionsinfrastruktur bereitgestellt, Update-Server veröffentlicht Metadaten oder ändern Sie, was das CMS verbraucht. Versionierte Artefaktverzeichnisse sind unveränderlich: eine vorhandene Eine Datei, deren Prüfsumme übereinstimmt, wird übersprungen, und eine Datei, deren Prüfsumme abweicht, blockiert die Ausführung, anstatt ersetzt wird. latest wird nie geschrieben.

Der Trockenlauf meldet jedes Schreiben, Überspringen und Blockieren, ohne das Dateisystem zu berühren. Führen Sie es vor einer Bewerbung aus.

Manueller Lebenszyklus

  1. Erstellen Sie das ZIP-Artefakt mit composer plugin:build.
  2. Laden Sie es über System -> Plugins hoch.
  3. Sehen Sie sich den Plugin-Detailbildschirm an.
  4. Aktivieren Sie das Plugin.
  5. Wenn der Zustand Setup required oder Plugin migrations pending meldet, führen Sie Run Plugin Migrations über den Plugin-Detailbildschirm aus.
  6. Öffnen Sie /webadmin/plugins/webblocks-ui-manager/releases über die Seitenleiste oder direkt nach Abschluss des Setups.
  7. Vor der Deinstallation deaktivieren. Durch die Deinstallation werden das hochgeladene Paket und der aktivierte Status entfernt, die webblocks_ui_manager_*-Tabellen bleiben jedoch erhalten.

Der Bildschirm „Releases“ prüft vor der Abfrage, ob webblocks_ui_manager_releases, webblocks_ui_manager_artifacts und webblocks_ui_manager_publish_runs vorhanden sind. Fehlende Tabellen stellen eine kontrollierte Einrichtungsanleitung auf der Release-URL dar, einschließlich eines Plugin-Detail-Links und einer Superadministrator-Migrationsaktion, anstelle eines Rohdatenbankfehlers oder einer Dashboard-Umleitung.

EAktivierte Admin-Routen verwenden Plugin-eigene Berechtigungen. webblocks-ui-manager.view schützt Release-Listen-/Detailseiten, webblocks-ui-manager.manage schützt Release-Metadatenänderungen und die Einstellungsseite und webblocks-ui-manager.publish schützt Veröffentlichungsaktionen. CMS super_admin-Benutzer sind für diese aktiven Plugin-Berechtigungen berechtigt; Andere Rollen erfordern eine explizite CMS-Berechtigungserteilung vor dem Zugriff auf das Plugin.

CMS v1.32.75+ überbrückt den gesamten WebBlocks UI Manager-Administrator-Release-/Einstellungs-Routenbaum durch den CMS-Kern, einschließlich neuer Release-, Bearbeitungs-/Aktualisierungs-, Probelauf- und Veröffentlichungsaktionen. Dadurch bleiben kompatible manuelle Plugin-Aktionen auf /webadmin/plugins/webblocks-ui-manager/... aktiviert, selbst wenn die hochgeladene Artefaktkopie einen veralteten Routen-/Quellkontext aufweist.

-Befehle

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

Konventionen

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 ist aus Absicht von manage getrennt: Aufzeichnen, dass eine Version vorhanden ist, und Schreiben von Dateien in das CDN-Root sind unterschiedliche Aktionen, und eine Installation durch einen Operator sollte in der Lage sein, eine ohne zu gewähren der andere.