VuFind Configuration Skill

VuFind Configuration Skill

Este skill consolida todo el conocimiento necesario para configurar y personalizar VuFind en el entorno Docker.

Parte 1: Guía de Configuración

Esta sección explica la arquitectura y las tareas comunes.

1. Arquitectura de Configuración

VuFind utiliza un sistema de configuración en cascada.

• Configuración Base: vufind/config/vufind/ (NO EDITAR).
• Configuración Local: vufind/local/docker/config/vufind/ (EDITAR AQUÍ).

Los archivos en el directorio local sobrescriben las configuraciones base.

2. Archivos Clave

Archivo	Propósito	Principales Ajustes
config.ini	Configuración Global	URL, Tema, Base de Datos, Autenticación
NoILS.ini	Driver Simulado	Configuración cuando no hay ILS real
searches.ini	Búsqueda	Tipos de búsqueda, ordenamiento, recomendaciones
facets.ini	Filtros (Facetas)	Qué filtros mostrar en resultados
permissions.ini	Seguridad	Permisos de acceso

3. Tareas Comunes

Cambiar Tema

En vufind/local/docker/config/vufind/config.ini:

[Site]
theme = mi-tema

Cambiar Posición de Sidebar

En vufind/local/docker/config/vufind/config.ini:

[Site]
sidebarOnLeft = true

Limpiar Caché

php public/index.php util/cleanup_record_cache

---

Parte 2: Referencia Completa de Opciones

Esta sección actúa como un diccionario detallado de todas las opciones disponibles en los archivos .ini principales.

1. config.ini (Configuración Global)

[System]

• available: true/false. Pone el sistema en modo mantenimiento.
• debug: true/false. Muestra mensajes de depuración en pantalla.
• autoConfigure: true/false. Deshabilita la pantalla de auto-configuración tras la instalación.
• healthCheckFile: Ruta a un archivo que simula un error del servidor (para balanceadores de carga).

[Site]

• url: URL base de la instalación (ej. http://localhost:8080).
• email: Dirección de correo para soporte.
• title: Título del sitio web.
• theme: Tema activo (ej. bootstrap5, sandal5).
• mobile_theme: Tema para dispositivos móviles.
• admin_theme: Tema para el panel de administración.
• language: Idioma por defecto (ej. es, en).
• locale: Configuración regional (ej. es_ES, en_US).
• timezone: Zona horaria (ej. America/New_York).
• defaultModule: Módulo de inicio (usualmente Search).
• defaultAccountPage: Página de inicio tras login (usualmente Favorites o Holds).
• sidebarOnLeft: true para barra lateral a la izquierda.
• showBookBag: true/false para activar el "carrito".

[Catalog]

• driver: Driver del ILS. Opciones: Aleph, Alma, Koha, NoILS, etc.
• holds_mode: Controla la visibilidad de enlaces de reservas (all, holds, recalls, disabled).
• renewals_enabled: true/false para permitir renovaciones.
• cancel_holds_enabled: true/false para cancelar reservas.

[Authentication]

• method: Método de autenticación. Database, LDAP, Shibboleth, CAS, ILS.
• hideLogin: true para ocultar el botón de login.
• change_password: true/false para permitir cambio de contraseña.
• recover_password: true/false para permitir recuperación por email.

[Index]

• url: URL del servidor Solr (ej. http://solr:8983/solr).
• default_core: Core bibliográfico (usualmente biblio).

[Database]

• database: Cadena de conexión (ej. mysql://user:pass@host/db).
• schema: Esquema (para PostgreSQL).

[Mail]

• host: Servidor SMTP.
• port: Puerto SMTP.
• secure: tls o ssl.
• email_action: enabled, disabled, require_login para enviar registros por correo.

[Content]

Configuración para contenido enriquecido (portadas, reseñas):

• coverimages: Proveedores de portadas (Google, OpenLibrary, etc.).
• reviews: Proveedores de reseñas.
• excerpts: Proveedores de extractos.

---

2. searches.ini (Búsqueda)

[General]

• default_handler: Búsqueda por defecto (AllFields).
• default_sort: Ordenación por defecto (relevance, year, title, author).
• default_view: Vista por defecto (list, grid).
• default_limit: Resultados por página (ej. 20).
• highlighting: true para resaltar términos de búsqueda.
• snippets: true para mostrar fragmentos con contexto.

[Basic_Searches]

Mapeo de nombres de búsqueda a índices de Solr:

• AllFields = "Todos los campos"
• Title = "Título"
• Author = "Autor"

[Advanced_Searches]

Campos disponibles en búsqueda avanzada.

[Sorting]

Opciones de ordenación disponibles para el usuario:

• relevance = "Relevancia"
• year = "Año (Descendente)"
• year asc = "Año (Ascendente)"

[Autocomplete]

• enabled: true/false.
• default_handler: Handler usado para sugerencias (usualmente Solr).

---

3. facets.ini (Filtros)

[Results]

Facetas que aparecen en la barra lateral de resultados:

• institution = "Institución"
• format = "Formato"
• author_facet = "Autor"
• language = "Idioma"
• publishDateRange = "Año de publicación"

[ResultsTop]

Facetas que aparecen encima de los resultados (horizontal).

[Advanced]

Facetas disponibles en la pantalla de búsqueda avanzada.

[SpecialFacets]

Configuración especial para:

• dateRange: Faceta de rango de fechas (slider).
• hierarchical: Facetas jerárquicas.

---

4. permissions.ini (Seguridad y Acceso)

Define quién puede acceder a qué partes del sistema.

[default.AdminModule]

Controla acceso al panel de administración.

• role = loggedin: Solo usuarios logueados.
• ipRange = 127.0.0.1: Solo desde localhost.

---

5. export.ini (Exportación)

Formatos disponibles para exportar registros:

• [RefWorks]
• [EndNote]
• [MARC]
• [BibTeX]
• [RIS]

Cada sección define:

• requiredMethods: Métodos necesarios en el driver.
• headers: Headers HTTP para la descarga.

---

6. NoILS.ini (Driver Simulado)

Usado cuando driver = NoILS en config.ini.

[settings]

• mode: ils-none (sin ILS) o ils-offline (ILS caído).
• hideLogin: Ocultar login cuando se usa este driver.

[Holdings]

Mensajes estáticos para disponibilidad:

• availability = false
• status = "Library System Unavailable"

---

7. Lista de Otros Archivos .ini Disponibles

Además de los anteriores, VuFind incluye configuraciones específicas para:

Drivers ILS

• Aleph.ini, Alma.ini, Amicus.ini, DAIA.ini, Demo.ini, Evergreen.ini, Folio.ini, GeniePlus.ini, Horizon.ini, Innovative.ini, Koha.ini, MultiBackend.ini, NewGenLib.ini, PAIA.ini, Polaris.ini, Primo.ini, Sierra.ini, Symphony.ini, Unicorn.ini, Virtua.ini, Voyager.ini, XCNCIP2.ini.

Funcionalidades Específicas

• AccountMenu.yaml: Menú de usuario.
• AdminMenu.yaml: Menú de administración.
• alpha_browse.ini: Navegación alfabética.
• authority.ini: Búsqueda de autoridades.
• browse.ini: Navegación por materias/autores.
• channels.ini: Canales de descubrimiento visual.
• Collection.ini: Configuración de colecciones.
• contentsecuritypolicy.ini: Cabeceras de seguridad CSP.
• CookieConsent.yaml: Configuración de consentimiento de cookies.
• FeedbackForms.yaml: Formularios de contacto.
• fulltext.ini: Búsqueda en texto completo.
• geofeatures.ini: Búsqueda por mapa.
• NetCommons.ini: Integración NetCommons.
• oai.ini: Servidor OAI-PMH.
• OAuth2Server.yaml: Servidor OAuth2.
• OpenIDConnect.ini: Login OIDC.
• Primo.ini: Búsqueda en Primo Central.
• QRCode.ini: Generación de códigos QR.
• RateLimiter.yaml: Límite de peticiones (anti-abuse).
• RecordTabs.ini: Pestañas en la vista de detalle del registro.
• reserves.ini: Búsqueda de reservas de cursos.
• searchspecs.yaml: Mapeo avanzado de campos Solr.
• sitemap.ini: Generación de sitemap.xml.
• sms.ini: Configuración de envío SMS.
• Summon.ini: Búsqueda en Summon.
• website.ini: Búsqueda en sitio web (Core separado).
• WorldCat.ini: API de WorldCat.

---

Recomendación Final

Para cualquier personalización:

1. NO edites los archivos en config/vufind/.
2. COPIA el archivo deseado a local/docker/config/vufind/.
3. EDITA solo las líneas que necesitas cambiar en la copia local.