WebBlocks Redirect Manager
Requisitos
Versión del paquete documentado: 0.1.18. WebBlocks CMS ^1.32; PHP >=8.1.
WebBlocks Redirect Manager es un pequeño complemento WebBlocks CMS para crear y administrar redireccionamientos 301/302 simples desde el área de administración de WebBlocks CMS.
Compatibilidad
- Mango enchufable:
webblocks-redirect-manager - Versión del complemento:
0.1.18 - Producto host de destino:
webblocks-cms - Versión de CMS requerida:
^1.32 - PHP:
>=8.1
Flujo de instalación manual de ZIP
- Construya el artefacto del complemento localmente:
composer plugin:build - Cargue
build/releases/webblocks-redirect-manager-0.1.18.zipal flujo de carga del complemento WebBlocks CMS. - Después de la carga, el CMS debe registrar primero el complemento en estado deshabilitado.
- Revise los metadatos y permisos del complemento.
- Enable el complemento cuando esté listo.
- Ejecute la migración del complemento a través del ciclo de vida del complemento CMS o el comando de migración requerido por la instalación del host.
Configuración y migración
El complemento posee una tabla:
webblocks_redirect_manager_redirects
La migración crea registros de redireccionamiento con:
source_pathtarget_urlstatus_codeis_enabledhit_countlast_hit_at- marcas de tiempo
Permisos
webblocks-redirect-manager.viewwebblocks-redirect-manager.manage
Redirecciones en tiempo de ejecución
- Las redirecciones habilitadas se evalúan para solicitudes públicas
GETyHEADno coincidentes antes de que el CMS devuelva un 404. - CMS 1.32.112 descubre proveedores de complementos instalados para metadatos
definition()pero no los registra ni los inicia como proveedores de servicios Laravel. Por lo tanto, Redirect Manager registra su ruta alternativa pública desdedefinition()en lugar de depender de la mutación del grupo de middleware del proveedorboot(). - Se omiten las solicitudes
POST,PUT,PATCHyDELETE. - Se omiten los espacios de nombres estáticos y de administrador, incluidos
/webadmin/...,/cms/...,/storage/...,/assets/...,/static/...,/build/...,/vendor/...y/webblocks-ui/.... - Las rutas de origen están normalizadas con una barra diagonal inicial y sin barra diagonal final, por lo que
/test-1,test-1y/test-1/coinciden con la misma regla. - Las cadenas de consulta entrantes se ignoran para realizar coincidencias.
/test-1?x=1coincide con la fuente/test-1. - Las cadenas de consulta entrantes no se agregan a la URL de destino. Una regla de
/test-1a/test-2redirige/test-1?x=1a/test-2. - Las redirecciones coincidentes de
GETyHEADincrementanhit_county actualizanlast_hit_at. - Las redirecciones internas de orientación automática se rechazan durante la validación de creación/edición del administrador y se omiten en tiempo de ejecución como protección de bucle.
- Si falta la tabla de complementos porque no se han ejecutado las migraciones de complementos, las solicitudes públicas omiten el middleware sin que se produzca un error de SQL.
Prueba del contador de visitas
Los navegadores pueden almacenar en caché las redirecciones 301. Mientras prueba los contadores de visitas, utilice redireccionamientos 302, borre la memoria caché del navegador, utilice el modo incógnito o pruebe con curl.
Limitaciones
- Las migraciones de complementos no se ejecutan automáticamente; ejecútelos durante el ciclo de vida del complemento CMS al instalarlos o actualizarlos.
- No se incluyen comportamientos de npm, Vite, Tailwind, Node, Marketplace, pago, licencia, instalación remota o actualización automática.