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
- Créez l'artefact ZIP avec
composer plugin:build. - Téléchargez-le via
System -> Plugins. - Examinez l'écran de détails du plugin.
- EActivez le plugin.
- Si les rapports d'intégrité
Setup requiredouPlugin migrations pending, exécutezRun Plugin Migrationsà partir de l'écran de détail du plug-in. - Ouvrez
/webadmin/plugins/webblocks-ui-manager/releasesà partir de la barre latérale ou directement une fois la configuration terminée. - 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.