Boilerplate v1.5.1 – Mejoras en la Imagen de Perfil y Actualización de Tablas

 

Boilerplate v1.5.1 – Mejoras en la Imagen de Perfil y Actualización de Tablas

Con la llegada de Boilerplate v1.5.1, una de las mejoras más notables es la gestión de la imagen de perfil de usuario. Hasta la versión anterior, si un usuario no tenía asignada una imagen, el sistema no siempre mostraba una opción de respaldo (fallback). Esto podía ocasionar que en algunos menús o vistas se mostrara un espacio vacío o un ícono roto.

En esta actualización, ahora el sistema valida correctamente si el usuario tiene una imagen de perfil registrada en la base de datos. Si el campo está vacío o en NULL, automáticamente se mostrará un avatar por defecto, evitando errores visuales y manteniendo la interfaz consistente.

---

🔧 Cómo actualizar a la versión v1.5.1

Para actualizar tu proyecto a la nueva versión, solo necesitas ejecutar en la raíz de tu proyecto:

composer update julio101290/boilerplate

Esto descargará la última versión desde Packagist/GitHub e instalará los cambios de forma automática.

---

🗄️ Actualizar tablas y campos nuevos

Además de la mejora en la imagen de perfil, se añadieron nuevos campos relacionados a la gestión de usuarios. Para actualizar la base de datos, ejecuta el siguiente comando:

php spark boilerplate:updatecommand

Esto se encargará de correr las migraciones necesarias y asegurarse de que todos los campos nuevos estén disponibles en tu instalación.

---

👤 Ejemplo práctico: Mostrar la imagen de perfil

El siguiente snippet muestra cómo cargar la imagen del usuario actual con un fallback en caso de que no exista ninguna asignada:

<img id="profileImage"
     class="profile-user-img img-fluid img-circle"
     src="<?= (!empty(user()->profile_image) 
            ? base_url(user()->profile_image) 
            : 'https://cdn.jsdelivr.net/npm/admin-lte@3.0.2/dist/img/avatar.png') ?>"
     alt="User profile picture">

Con este cambio, si el campo profile_image en la base de datos está vacío o en NULL, el sistema automáticamente mostrará la imagen por defecto.

---

📌 Cambios destacados en Boilerplate v1.5.1

• ✅ Validación automática de imagen de perfil nula o inexistente.
• ✅ Soporte para avatar por defecto si no hay imagen configurada.
• ✅ Ajustes visuales en el menú de navegación y sidebar.
• ✅ Nuevas migraciones y actualización de campos en la tabla users.
• ✅ Mejor integración con AdminLTE en la vista de usuario.

---

💡 Preguntas frecuentes (FAQ)

1. ¿Es obligatorio ejecutar el comando spark después de actualizar?

Sí. De esta forma se aseguran los cambios en las tablas y se agregan los campos nuevos necesarios para la funcionalidad de la imagen de perfil.

2. ¿Puedo usar mi propio avatar por defecto?

Claro. Solo necesitas reemplazar la URL en el snippet por la ruta de tu propio recurso.

3. ¿Qué pasa si el usuario ya tiene una imagen previa?

El sistema seguirá mostrándola normalmente, sin necesidad de modificaciones adicionales.

---

📥 Conclusión

La actualización Boilerplate v1.5.1 no solo mejora la experiencia visual con un manejo más robusto de la imagen de perfil, sino que también facilita la administración de usuarios y mantiene el sistema alineado con buenas prácticas de desarrollo.

Recomendamos a todos los usuarios actualizar cuanto antes para disfrutar de estas mejoras y mantener sus proyectos al día.

➡️ Descarga la versión desde el repositorio oficial en GitHub: https://github.com/julio101290/boilerplate/releases/tag/v1.5.1