WebBlocks UI Manager

Requisitos

Versión del paquete documentado: 0.2.0. WebBlocks CMS ^1.32; PHP >=8.3.

Complemento de operador interno para metadatos de lanzamiento de WebBlocks UI y preparación de CDN local propia flujos de trabajo. No es para instalaciones generales: pertenece a los hosts del operador que publican WebBlocks. Interfaz de usuario, como webblocksui.com.

Qué hace y qué se niega a hacer

El complemento registra las versiones de WebBlocks UI y valida un conjunto de archivos dist con el SHA-256 almacenado. sumas de verificación y las escribe en una raíz estática propiedad del proyecto en public/cdn/webblocks-ui/{version}.

No construye WebBlocks UI, no lo implementa en una infraestructura de producción externa, no publica el servidor de actualizaciones. metadatos o cambiar lo que consume el CMS. Los directorios de artefactos versionados son inmutables: un existente El archivo cuya suma de verificación coincide se omite, y uno cuya suma de verificación difiere bloquea la ejecución en lugar de siendo reemplazado. latest nunca se escribe.

Dry-run informa cada escritura, salto y bloqueo sin tocar el sistema de archivos. Ejecútelo antes de aplicar.

Ciclo de vida manual

  1. Construya el artefacto ZIP con composer plugin:build.
  2. Usúbelo a través de System -> Plugins.
  3. Revise la pantalla de detalles del complemento.
  4. Habilite el complemento.
  5. Si los informes de estado son Setup required o Plugin migrations pending, ejecute Run Plugin Migrations desde la pantalla de detalles del complemento.
  6. Obra /webadmin/plugins/webblocks-ui-manager/releases desde la barra lateral o directamente después de que se complete la configuración.
  7. Desactivar antes de desinstalar. La desinstalación elimina el paquete cargado y el estado habilitado, pero conserva las tablas webblocks_ui_manager_*.

La pantalla Versiones busca webblocks_ui_manager_releases, webblocks_ui_manager_artifacts y webblocks_ui_manager_publish_runs antes de realizar la consulta. Las tablas que faltan muestran una guía de configuración controlada en la URL de las versiones, incluido un enlace de detalles del complemento y una acción de migración de superadministrador, en lugar de un error de base de datos sin formato o una redirección del panel.

Errutas de administración habilitadas utilizan permisos propiedad del complemento. webblocks-ui-manager.view protege las páginas de detalles/lista de versiones, webblocks-ui-manager.manage protege los cambios de metadatos de la versión y la página de configuración, y webblocks-ui-manager.publish protege las acciones de publicación. Los usuarios de CMS super_admin tienen permisos para estos complementos activos; otras funciones requieren una concesión de permiso CMS explícita antes de acceder al complemento.

CMS v1.32.75+ une el árbol de rutas de configuración/versión de administrador completo de WebBlocks UI Manager a través del núcleo de CMS, incluidas las acciones de nueva versión, edición/actualización, ejecución en seco y publicación. Esto mantiene habilitadas las acciones de complementos manuales compatibles en /webadmin/plugins/webblocks-ui-manager/... incluso cuando la copia del artefacto cargado tiene un contexto de ruta/fuente obsoleto.

Comandos

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

Convenciones

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á separado de manage a propósito: registrar que existe una versión y escribir archivos en la raíz de CDN son actos diferentes, y la instalación de un operador debería poder otorgar uno sin el otro.