WebBlocks CMS genera un conjunto fijo de variantes de imagen propias del producto a partir de archivos multimedia públicos JPEG, PNG y WebP. Los editores siguen gestionando únicamente el elemento multimedia original; los archivos generados son artefactos derivados de caché y no aparecen como registros independientes en la biblioteca.
Variantes del sistema
La configuración media_transforms.php, propiedad del paquete, define las variantes de miniatura, tarjeta, contenido adaptable, hero y redes sociales. Estas definiciones forman parte del comportamiento del producto CMS. Esta versión no añade deliberadamente variantes definidas por el proyecto ni una pantalla de administración para cambiar las dimensiones y la calidad.
Las transformaciones se generan en el primer uso y se almacenan en el disco del medio de origen bajo media/transforms/{media_id}. La huella de la caché incluye únicamente la identidad del origen relevante para la transformación, las dimensiones, los datos MIME, el punto focal y la definición de la variante; los cambios en los metadatos editoriales no la invalidan. Sustituir o eliminar un medio y cambiar su punto focal elimina las transformaciones obsoletas. La pantalla de edición de Medios muestra las variantes existentes sin generar los archivos que falten y permite borrar y regenerar explícitamente todas las variantes del sistema.
SVG y los formatos rasterizados no compatibles usan de forma segura su URL pública original. Los archivos originales nunca se sobrescriben. Los archivos de transformación derivados no son contenido editorial independiente y pueden regenerarse después de una transferencia o restauración.
Flujo de trabajo editorial
Los medios de imagen ofrecen un selector de punto focal en la pantalla de edición de Medios. La posición X/Y normalizada seleccionada guía las variantes de recorte, como miniatura, tarjeta, hero y redes sociales. Las variantes de ajuste conservan la relación de aspecto original.
La misma pantalla muestra una vista previa de cada variante del sistema. Los selectores de medios usan la variante de miniatura, mientras que el bloque Imagen público emite candidatos srcset adaptables y de carga diferida a partir de las variantes de ajuste.
Las variantes de ajuste conservan la relación de aspecto y usan directamente el original cuando este no es más ancho que la variante solicitada. Las variantes de recorte calculan un recorte del origen con la relación de aspecto configurada alrededor del punto focal. Los originales pequeños nunca se amplían: la proporción de salida configurada se reduce uniformemente para ajustarse al origen y después se recorta sin distorsión.
El marcado de Imagen adaptable y Galería usa las dimensiones medidas del resultado, ordena los candidatos por su anchura real, elimina las URL duplicadas y omite srcset a menos que queden al menos dos candidatos distintos. sizes de la Galería sigue el número de columnas configurado. Las imágenes sociales de la página o del sitio usan el recorte social para los metadatos de Open Graph y Twitter. card y hero permanecen reservados porque el paquete actual no dispone de un campo de Biblioteca multimedia de primera clase para esas funciones de bloque.
Cultivos móviles separados (1.91.0)
Los bloques de imagen, diapositiva, héroe, sección, tarjeta, CTA, encabezado de contenido y lista de enlaces pueden seleccionar una imagen móvil opcional de la biblioteca multimedia. La imagen móvil es un registro de medios editorial independiente, no una variante generada. Elija un recorte del mismo tema que se lea mejor en una pantalla estrecha.
El renderizador público la selecciona en anchos de ventana gráfica de hasta 768 px y vuelve a la imagen predeterminada cuando falta la selección móvil, es privada o se elimina. El texto alternativo, el título, la posición, el ajuste, la superposición y los enlaces permanecen compartidos tanto en las imágenes como en todas las configuraciones regionales. El Visor de galería del bloque de imágenes abre la imagen predeterminada de resolución completa.
Las herramientas API asignan o borran esta selección con mobile_media_id; ver Internal Content API. El uso de medios, la copia en bloque y la exportación preservan la relación entre el móvil y la imagen. Los elementos de la galería, logotipos, videos y audio no exponen esta selección.
Requisitos de almacenamiento y ejecución
Las transformaciones usan PHP GD y discos del sistema de archivos de Laravel. La generación de JPEG, PNG y WebP depende del códec GD correspondiente. Si el formato de origen o el códec de ejecución no está disponible, la representación pública recurre a la URL del medio original en lugar de fallar.
El canal alfa de PNG se conserva. Los fallos de decodificación, redimensionamiento, codificación y almacenamiento eliminan la salida incompleta y activan una alternativa segura. ext-gd sigue siendo opcional en suggest de Composer.
Los operadores pueden regenerar todas las imágenes aptas en lotes limitados, dirigirse a un único id o depurar de forma segura directorios de huellas obsoletos sin alterar los originales ni las transformaciones actuales:
php artisan webblocks:media-variants:regenerate
php artisan webblocks:media-variants:regenerate --media=123
php artisan webblocks:media-variants:regenerate --pruneLa generación es síncrona y no requiere deliberadamente una cola. Las bibliotecas grandes deben regenerarse durante una ventana de mantenimiento.
La pantalla Limpieza del sistema informa los bytes de la biblioteca multimedia original por separado del recuento y los bytes del archivo variante generado. Su vista previa de limpieza de variantes generadas incluye sólo directorios de huellas dactilares obsoletos; Las variantes actuales y los archivos originales nunca son candidatos. La misma pantalla también informa el recuento de bloques en vivo junto a la identificación de bloque asignada más alta para que un operador pueda distinguir el contenido almacenado del abandono normal de incremento automático.