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:

  1. Cero dependencias externas: Todo resuelto con PHP nativo, PDO y CSS moderno.
  2. Proporción exacta 16:9: Sin imágenes deformadas, estiradas ni videos cortados.
  3. 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 .htaccess para 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 corto youtu.be/..., formato shorts o 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; y object-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.jpg con fallback automático a mqdefault.jpg y 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.