Project Browser
Proporciona una interfaz de usuario para explorar, buscar e instalar módulos, temas y recetas de Drupal desde la interfaz de administración de Drupal.
project_browser
Install
composer require 'drupal/project_browser:^2.0'
Overview
Project Browser (PB) permite encontrar e instalar módulos, temas y recetas directamente dentro de tu instalación de Drupal. Elimina la necesidad de salir de la interfaz de administración y visitar Drupal.org para descubrir e instalar proyectos, proporcionando una experiencia más intuitiva que el listado de módulos en Drupal.org.
El módulo consulta la API de Drupal.org en tiempo real para asegurar que el contenido esté actualizado, mostrando solo proyectos compatibles con tu sitio. Las capacidades de filtrado mejoradas proporcionan una vista optimizada de los proyectos disponibles, incluyendo filtrado por categoría, estado de mantenimiento, cobertura de seguridad y estado de desarrollo.
Project Browser cuenta con un frontend moderno basado en Svelte con una vista de cuadrícula o lista responsiva, paginación e información detallada del proyecto incluyendo capturas de pantalla, descripciones y estadísticas de uso. Soporta múltiples fuentes de proyectos a través de una arquitectura de plugins, permitiendo explorar módulos contribuidos desde Drupal.org, módulos del core, módulos instalados localmente y recetas.
Cuando Package Manager (de Automatic Updates) está instalado, Project Browser también puede descargar e instalar módulos directamente desde la interfaz, proporcionando una experiencia completa de descubrimiento e instalación de módulos sin requerir acceso a la línea de comandos.
Features
- Explorar módulos contribuidos desde Drupal.org en tiempo real mostrando solo módulos compatibles
- Explorar y habilitar módulos del core de Drupal con categorización por paquete
- Explorar módulos instalados localmente (ya descargados vía Composer)
- Explorar y aplicar recetas de Drupal desde el core y fuentes personalizadas
- Explorar complementos recomendados curados desde fuentes configurables
- Frontend responsivo moderno basado en Svelte.js con vistas de cuadrícula y lista
- Filtrado avanzado por categorías, cobertura de seguridad, estado de mantenimiento y estado de desarrollo
- Múltiples opciones de ordenamiento incluyendo relevancia, alfabético, más recientes y popularidad
- Vista detallada del proyecto con capturas de pantalla, descripciones completas y estadísticas de uso
- Instalación de módulos basada en la interfaz cuando Package Manager está habilitado (experimental)
- Arquitectura de plugins extensible para fuentes de proyectos personalizadas
- Visualización basada en bloques permitiendo colocar Project Browser en cualquier lugar
- Generación de comandos de Composer para instalación manual
- Integración con el sistema de recetas de Drupal incluyendo manejo de formularios de entrada
- Comando Drush para limpiar datos de proyectos almacenados
- Sistema de caché para mejor rendimiento
Use Cases
Descubrimiento de módulos para constructores de sitios
Los constructores de sitios pueden explorar el catálogo completo de módulos de Drupal.org directamente desde la interfaz de administración de su sitio. Filtrar por categoría (ej. Comercio, SEO, Media) y cobertura de seguridad para encontrar módulos que cumplan con los requisitos del proyecto. Ver descripciones detalladas, capturas de pantalla y estadísticas de uso sin salir de la administración de Drupal.
Instalación de módulos para usuarios no técnicos
Para sitios con Package Manager instalado, usuarios no técnicos o administradores de contenido pueden instalar módulos a través de la interfaz sin acceso a la línea de comandos. Selecciona módulos desde el navegador, haz clic en Instalar, y Project Browser maneja el require de Composer y la habilitación del módulo automáticamente.
Gestión de módulos del core
Los administradores pueden explorar todos los módulos del core de Drupal disponibles organizados por paquete. Encuentra y habilita rápidamente funcionalidades del core como Views, Media o Workflows sin buscar en la lista estándar de módulos.
Aplicación de recetas
Explora y aplica recetas de Drupal desde el core y fuentes contribuidas. Las recetas proporcionan paquetes de funcionalidad preconfigurada. Project Browser maneja la recolección de entrada de recetas y aplica recetas con checkpointing adecuado para capacidad de reversión.
Catálogo de módulos personalizado
Las organizaciones pueden crear plugins de fuentes personalizados de Project Browser para exponer catálogos de módulos internos, listas de módulos aprobados o repositorios de terceros. La arquitectura de plugins permite integración con cualquier fuente de datos.
Recomendaciones de proveedores de hosting
Los proveedores de hosting o distribuciones de Drupal pueden configurar la fuente de Recomendados para mostrar recomendaciones de módulos curadas a sus clientes, guiándolos hacia módulos probados y soportados.
Tips
- Usa la opción de ordenamiento 'Más relevante' al buscar para obtener las mejores coincidencias para tus términos de búsqueda
- Habilita solo los plugins de fuentes que necesitas en la configuración para reducir el desorden y mejorar el rendimiento
- La vista de cuadrícula muestra más proyectos a la vez, mientras que la vista de lista proporciona más detalle por proyecto
- Para sitios grandes, considera deshabilitar la instalación por interfaz y usa Composer directamente para mejor control
- Project Browser cachea los resultados por 24 horas por defecto; usa la pestaña de Acciones para forzar la actualización si es necesario
- Crea plugins de fuentes personalizados para integrar con catálogos de módulos internos o listas de módulos aprobados
- El bloque de Project Browser puede colocarse en dashboards para acceso rápido al descubrimiento de proyectos
Technical Details
Admin Pages 3
/admin/modules/browse/{source}
Interfaz principal de exploración de proyectos donde los usuarios pueden buscar, filtrar y descubrir módulos, temas y recetas de Drupal disponibles. La página muestra una cuadrícula o lista responsiva de proyectos con opciones de filtrado, paginación e información detallada del proyecto. Los usuarios pueden ver detalles del proyecto en un modal, ver comandos de Composer para la instalación y, si Package Manager está habilitado, instalar proyectos directamente desde la interfaz.
/admin/config/development/project_browser
Configura qué fuentes de proyectos están habilitadas y su orden de visualización. Habilita o deshabilita la capacidad de instalación basada en la interfaz. Administra las fuentes que Project Browser consulta para proyectos.
/admin/config/development/project_browser/actions
Acciones administrativas para Project Browser incluyendo limpiar datos de proyectos en caché de todas las fuentes.
Permissions 2
Hooks 1
hook_project_browser_source_info_alter
Altera las definiciones de plugins de fuentes de Project Browser descubiertas por el administrador de plugins.
Drush Commands 1
drush project-browser:storage-clear
Limpia todos los datos de proyectos almacenados de las fuentes de Project Browser. Útil para forzar la recuperación de datos frescos o solucionar problemas de caché.
Troubleshooting 5
Verifica la capacidad de tu servidor para conectarse a drupal.org. Verifica que ninguna regla de firewall esté bloqueando solicitudes HTTPS salientes. Revisa el registro de errores de Drupal (Informes > Mensajes de registro recientes) para información detallada del error. Intenta limpiar el almacenamiento de Project Browser en /admin/config/development/project_browser/actions.
La instalación por interfaz requiere Package Manager versión 2.5 o posterior del módulo Automatic Updates. Instala y habilita el módulo automatic_updates, luego la opción estará disponible en la configuración de Project Browser.
Otro proceso de instalación puede estar en progreso. Espera unos minutos e intenta de nuevo. Si el problema persiste, usa el enlace de desbloqueo proporcionado en el mensaje de error, o visita /admin/modules/project_browser/install/unlock para desbloquear manualmente el proceso de instalación.
Limpia la caché de Project Browser yendo a /admin/config/development/project_browser/actions y haciendo clic en 'Limpiar almacenamiento'. También intenta limpiar la caché de Drupal vía drush cr o admin/config/development/performance.
Asegúrate de que las recetas estén instaladas en la ubicación correcta. Las recetas del core están en core/recipes/. Las recetas contribuidas deben instalarse donde Composer esté configurado para colocarlas (revisa installer-paths en composer.json). Limpia el almacenamiento de Project Browser después de agregar nuevas recetas.
Security Notes 6
- Project Browser respeta el sistema de permisos de Drupal - solo usuarios con 'administrar módulos' pueden explorar e instalar proyectos
- La instalación por interfaz requiere tanto el permiso 'administrar módulos' como que Package Manager esté habilitado en la configuración
- El filtro de cobertura de seguridad está habilitado por defecto para mostrar solo módulos cubiertos por la política de avisos de seguridad de Drupal
- Todas las solicitudes API a drupal.org se realizan del lado del servidor, sin exponer credenciales o tokens
- El sandbox de instalación se limpia automáticamente después de instalaciones exitosas o fallidas
- La aplicación de recetas crea un checkpoint que puede usarse para reversión si ocurren problemas