¿Por qué otro plugin de galería?
Durante el desarrollo de aplicaciones para inmuebles, portafolios y sistemas de gestión de contenido, notamos un patrón: los componentes estándar funcionaban, pero siempre necesitaban ajustes. Los clientes querían interfaces modernas, control sobre qué imagen destacar, vistas previas a pantalla completa. Los desarrolladores querían validación robusta antes de subir archivos, drag-and-drop, y compatibilidad con Spatie Media Library.
Premium Gallery Plugin existe porque escuchamos esas necesidades y las convertimos en código.
Características que Marcan la Diferencia
🖼️Interfaz Premium Moderna
Construida con los tokens de diseño estándar de Filament, el componente se integra perfectamente con tus paneles administrativos. La cuadrícula responsive mantiene una experiencia visual consistente, con un diseño que se siente pulido en cada dispositivo.
⬆️Control Manual de Carga
A diferencia de uploads automáticos que pueden generar dolores de cabeza, Premium Gallery permite validar archivos antes de enviarlos. Esto es crítico para aplicaciones donde la calidad de imagen o ciertos metadatos deben verificarse antes de guardarse.
⭐Marca la Imagen Principal en Un Clic
¿Cuál es la foto de portada? Con Premium Gallery, tus usuarios pueden establecer una imagen como principal con un simple click. El componente integra esta funcionalidad con Spatie Media Library automáticamente, almacenando la preferencia en propiedades personalizadas.
👁️Visor Lightbox Integrado
La vista previa a pantalla completa no es solo una comodidad—es esencial. Filament merecía un lightbox integrado que funcionara de serie. Premium Gallery lo incluye sin dependencias externas complicadas.
📱Verdaderamente Responsive
Desde el escritorio hasta móvil, la interfaz se adapta perfectamente. En dispositivos móviles, el drag-and-drop se comporta como esperarías, y las imágenes se cargan con cuidado del ancho de banda.
⚡Optimizado para Rendimiento
Soporta reordenamiento por drag-and-drop nativo. Las validaciones se ejecutan localmente primero, reduciendo peticiones innecesarias al servidor. Compatible tanto con Filament 4.x como 3.x.
Casos de Uso Donde Brilla
📍 Aplicaciones Inmobiliarias:
Agentes de bienes raíces pueden subir múltiples fotos de propiedades, establecer la imagen principal automáticamente, y los clientes ven una experiencia pulida desde el día uno.
🎨 Portafolios y Galerías:
Diseñadores, fotógrafos y agencias necesitan gestionar colecciones de proyectos sin fricción. Premium Gallery proporciona exactamente eso.
🛍️ E-commerce y Catálogos:
Productos con múltiples imágenes, donde establecer la imagen destacada es crítico para conversiones. El componente maneja esto elegantemente.
📝 Sistemas de Gestión de Contenido:
CMSs construidos con Filament que necesitan gestionar galerías asociadas a artículos, secciones o categorías.
💼 Aplicaciones SaaS Internas:
Cualquier aplicación donde usuarios no-técnicos necesitan subir y organizar imágenes sin complejidad.
Instalación: Tres Pasos Simples
1. Agregar el Repositorio
En tu composer.json raíz, añade nuestro repositorio Git:
"repositories": [
{
"type": "vcs",
"url": "https://github.com/danielriveraayala/premium-gallery-plugin.git"
}
]
2. Instalar el Paquete
composer require kreativos-pro/premium-gallery
3. Usar en Tus Formularios
use KreativosPro\PremiumGallery\Forms\Components\PremiumGalleryUpload;
PremiumGalleryUpload::make('gallery')
->label('Fotos de la Propiedad')
->collection('gallery')
->maxFiles(10)
->maxSize(5120) // 5MB
->acceptedFileTypes(['image/jpeg', 'image/png', 'image/webp'])
->columnSpanFull();
Eso es todo. No necesitas configuración adicional complicada.
Integración con Spatie Media Library
Premium Gallery se integra profundamente con Spatie Media Library. El componente automáticamente maneja la propiedad personalizada is_primary para marcar la imagen principal.
En tus modelos, acceder a la imagen principal es trivial:
PHP
// Obtener la imagen principal
$primaryImage = $record->getMedia('gallery')
->firstWhere('custom_properties.is_primary', true);
// Fallback inteligente a la primera imagen
$cover = $primaryImage ?? $record->getFirstMedia('gallery');
Esto significa que en tu frontend, puedes mostrar la imagen correcta sin lógica condicional adicional.
Seguridad Incorporada
La seguridad no es un add-on en Premium Gallery, es fundamental:
- Validación Estricta: Los archivos se validan en el servidor, no solo en el cliente.
- Verificaciones de Autorización: Las políticas de Filament se respetan al eliminar medios.
- Tipos de Archivo Restringibles: Define exactamente qué formatos permite tu aplicación.
Para aplicaciones que manejan imágenes de usuarios, esto es crítico.
Requisitos Técnicos
- PHP 8.2 o superior
- Filament 4.x o 3.x
- Laravel 11/12
- Spatie Media Library (para funcionalidad completa)
El Flujo de Desarrollo Ideal
Imagina este flujo de trabajo común:
- Creas un Recurso de Filament para gestionar propiedades inmobiliarias.
- Añades Premium Gallery con una línea de código.
- Usuarios no-técnicos suben fotos, establecen la principal, todo funciona sin que tengas que escribir validación personalizada.
- El frontend obtiene la imagen principal automáticamente.
- Todos están contentos y tu código se mantiene limpio.
Esto es lo opuesto a pasar horas construyendo lógica de galería personalizada.
Open Source y Transparente
El código está disponible públicamente en GitHub. Puedes revisar exactamente qué hace, contribuir mejoras, y confiar en que no hay sorpresas ocultas. Para desarrolladores que valoran transparencia y control, esto importa.
Crecimiento Desde la Experiencia Real
Premium Gallery existe porque la construimos para clientes reales. Cada característica, desde el lightbox hasta el drag-and-drop, surgió de necesidades concretas en producción. No es un plugin teórico—es pragmático y práctico.
Próximos Pasos
Premium Gallery Plugin está disponible ahora para tus proyectos de Filament. Si trabajas con colecciones de imágenes en Filament, te ahorrará tiempo y reducirá complejidad significativamente.
¿Usando Filament en tus aplicaciones? ¿Necesitas gestionar galerías? Integra Premium Gallery y experimenta la diferencia de un componente construido para producción.
Más de Kreativos Pro
En Kreativos Pro, no solo creamos estrategias de marketing digital—también construimos soluciones de software que generan valor real para nuestros clientes. Premium Gallery Plugin es un ejemplo de esa mentalidad: herramientas que funcionan, que resuelven problemas reales, y que se integran perfectamente en aplicaciones profesionales.
Si estás desarrollando aplicaciones Laravel/Filament y necesitas una solución de galería que simplemente funcione, Premium Gallery Plugin es tu aliada.
¿Preguntas o sugerencias? Abre un issue en GitHub o contacta directamente a nuestro equipo de desarrollo.
