WebBlocks UI Manager

Exigences

Version du package documentée : 0.2.0. WebBlocks CMS ^1.32 ; PHP >=8.3.

Plugin opérateur interne pour les métadonnées de la version WebBlocks UI et la préparation du CDN local de première partie flux de travail. Ce n'est pas destiné aux installations générales : il appartient aux hôtes de l'opérateur qui publient WebBlocks. Interface utilisateur, telle que webblocksui.com.

Ce qu'il fait et ce qu'il refuse de faire

Le plugin enregistre les versions de WebBlocks UI et valide un ensemble de fichiers de distribution par rapport au SHA-256 stocké. sommes de contrôle et les écrit dans une racine statique appartenant au projet sous public/cdn/webblocks-ui/{version}.

Il ne construit pas WebBlocks UI, ne déploie pas sur une infrastructure de production externe, ne publie pas le serveur de mise à jour métadonnées, ou modifier ce que le CMS consomme. Les répertoires d'artefacts versionnés sont immuables : un répertoire existant le fichier dont la somme de contrôle correspond est ignoré, et celui dont la somme de contrôle diffère bloque l'exécution plutôt que en cours de remplacement. latest n’est jamais écrit.

Dry-run rapporte chaque écriture, saut et blocage sans toucher au système de fichiers. Exécutez-le avant un apply.

Cycle de vie manuel

  1. Créez l'artefact ZIP avec composer plugin:build.
  2. Téléchargez-le via System -> Plugins.
  3. Examinez l'écran de détails du plugin.
  4. EActivez le plugin.
  5. Si les rapports d'intégrité Setup required ou Plugin migrations pending, exécutez Run Plugin Migrations à partir de l'écran de détail du plug-in.
  6. Ouvrez /webadmin/plugins/webblocks-ui-manager/releases à partir de la barre latérale ou directement une fois la configuration terminée.
  7. Désactiver avant la désinstallation. La désinstallation supprime le package téléchargé et l'état activé, mais préserve les tables webblocks_ui_manager_*.

L'écran Releases recherche webblocks_ui_manager_releases, webblocks_ui_manager_artifacts et webblocks_ui_manager_publish_runs avant d'effectuer une requête. Les tables manquantes affichent des conseils de configuration contrôlée sur l'URL des versions, y compris un lien détaillé du plug-in et une action de migration du super-administrateur, au lieu d'une erreur de base de données brute ou d'une redirection du tableau de bord.

E utilisent les autorisations appartenant au plugin. webblocks-ui-manager.view protège les pages de liste/de détail des versions, webblocks-ui-manager.manage protège les modifications des métadonnées de la version et la page des paramètres, et webblocks-ui-manager.publish protège les actions de publication. Les utilisateurs du CMS super_admin sont autorisés à bénéficier de ces autorisations de plugin actives ; d'autres rôles nécessitent une autorisation explicite du CMS avant d'accéder au plugin.

CMS v1.32.75+ relie l'arborescence complète des versions/paramètres de l'administrateur WebBlocks UI Manager via le noyau du CMS, y compris les actions de nouvelle version, d'édition/mise à jour, d'exécution à sec et de publication. Cela maintient les actions de plug-in manuelles compatibles activées sur /webadmin/plugins/webblocks-ui-manager/... même lorsque la copie d'artefact téléchargée a un contexte de route/source obsolète.

Commandes

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

Congrès

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 est volontairement séparé de manage : enregistrement de l'existence d'une version et écriture de fichiers dans la racine CDN sont des actes différents, et un opérateur d'installation devrait pouvoir en accorder un sans l'autre.