En el diseño de plataformas de contenido modernas, la experiencia visual no debe comprometer la velocidad ni la simplicidad arquitectónica. Recientemente en ColimaDev dimos un salto importante en el gestor de contenidos: integramos un sistema modular de portadas multimedia, permitiendo que cada artículo cuente con imagen propia (subida local o enlace externo) o incluso un video embebido de YouTube con proporción cinematográfica.
En esta nota explicamos cómo diseñamos e implementamos esta funcionalidad de principio a fin.
1. El objetivo: Flexibilidad sin sobrepeso
Muchos CMS tradicionales resuelven la multimedia arrastrando plugins pesados o manipulando dependencias de terceros que ralentizan el renderizado inicial. En ColimaDev nos propusimos tres principios fundamentales:
- Cero dependencias externas: Todo resuelto con PHP nativo, PDO y CSS moderno.
- Proporción exacta 16:9: Sin imágenes deformadas, estiradas ni videos cortados.
- Versatilidad editorial: Libertad de elegir entre subida de archivos, enlaces CDN o integración con YouTube según el tipo de artículo.
2. Las tres modalidades de portada
En el panel de administración (admin/post-edit.php), añadimos un selector dinámico que adapta el formulario en tiempo real según el tipo de portada elegido:
A. Subida de imagen local (upload)
- Permite subir archivos directamente desde el equipo (
.jpg,.jpeg,.png,.webp). - Seguridad y sanitización: Se valida la extensión y el tipo MIME, generando un nombre único con hash criptográfico para evitar sobreescrituras accidentales.
- Los archivos se almacenan en la carpeta
assets/uploads/posts/, protegida con directivas.htaccesspara impedir la ejecución de scripts maliciosos.
B. Enlace de imagen externa (url)
- Diseñado para utilizar imágenes alojadas en CDNs de alto rendimiento como Unsplash, Cloudinary o servidores dedicados.
- Se valida la estructura de la URL y se sanitiza antes de guardarse en la base de datos.
C. Video de YouTube (youtube)
- El usuario simplemente pega cualquier URL de YouTube (sea formato estándar
youtube.com/watch?v=..., enlace cortoyoutu.be/..., formatoshortso URL embebida). - Un helper en PHP extrae automáticamente el ID único del video de 11 caracteres mediante expresiones regulares:
function getYouTubeVideoId($url) {
if (empty($url)) return null;
$url = trim($url);
if (preg_match('/^[a-zA-Z0-9_-]{11}$/', $url)) {
return $url;
}
$pattern = '~(?:youtube\.com\/(?:[^\/]+\/.+\/|(?:v|e(?:mbed)?|shorts)\/|.*[?&]v=)|youtu\.be\/)([^"&?\/ ]{11})~i';
if (preg_match($pattern, $url, $matches)) {
return $matches[1];
}
return null;
}
3. Optimización de renderizado y proporción 16:9
Uno de los principales desafíos fue garantizar que las miniaturas en la lista de artículos y los videos en la vista completa mantuvieran siempre la proporción correcta 16:9 sin saltos de contenido (Cumulative Layout Shift):
Tarjetas en el feed (.post-card-media)
- Usamos CSS nativo con
aspect-ratio: 16 / 9;yobject-fit: cover;para que cualquier imagen o miniatura se adapte con elegancia sin bordes deformados. - Para los videos de YouTube, no cargamos el iframe completo en el feed para ahorrar ancho de banda: consumimos directamente la miniatura de alta definición
img.youtube.com/vi/{ID}/maxresdefault.jpgcon fallback automático amqdefault.jpgy añadimos un distintivo botón de reproducción superpuesto.
Vista individual del artículo (.video-responsive)
- En el artículo completo, el video se inserta a través de un reproductor responsive con
youtube-nocookie.com, garantizando privacidad para los visitantes y compatibilidad total con dispositivos móviles.
4. Persistencia en Base de Datos
En la tabla posts de MySQL, la estructura se amplió con dos campos clave:
ALTER TABLE posts
ADD COLUMN cover_type VARCHAR(20) DEFAULT 'none' AFTER content,
ADD COLUMN cover_url VARCHAR(500) DEFAULT NULL AFTER cover_type;
Esta solución mantiene las consultas ultrarrápidas, con tipado limpio y fallback hacia cover_type = 'none' para artículos puramente tipográficos.
Conclusión
Con esta mejora, ColimaDev ofrece un soporte multimedia completo y elegante sin sacrificar la velocidad instantánea ni la estética minimalista que define al proyecto.