Manual de configuración · Módulo Core¶
Para quién es este manual. Para la persona de la junta directiva que decide los ajustes de la asociación en Convoca: qué planes de cuota hay, el horario del centro, los datos de cobro y cómo se guardan las copias de seguridad. Se lee con la web abierta al lado.
Dónde está cada cosa¶
- El asistente de configuración («Configuración del Ecosistema») es la pantalla con los 7 pasos. Se abre desde el propio módulo y avisa de que «Sigue los pasos para asegurar que tu plataforma Convoca esté lista».
- Dentro del asistente, cada paso tiene su botón de guardar y dos enlaces al pie: «Anterior» y «Siguiente», más «Omitir asistente y configurar manualmente».
- Los ajustes de cada módulo (por ejemplo, socios y cuotas) están además en el menú de ese módulo: los verás en el manual de configuración del módulo Miembros.
Los 7 pasos del asistente, uno a uno¶
| Paso / ajuste | Para qué sirve | Valor recomendado |
|---|---|---|
| 1. Infraestructura y Base de Datos | Comprueba que el motor está listo: «Convoca Common — Plugin activo», «Tabla convoca_logs — Correcto», «Tabla convoca_locks — Correcto» | No hay nada que rellenar: pasa al siguiente cuando las tres líneas salgan con el visto bueno (✓) |
| 2. Páginas del Sistema | Comprueba que existen las páginas públicas que necesitan los módulos: Alta de Socios, Mi Panel de Socio, Página de Pago, Verificar Socio/a y Verificar Certificado | Deja las cinco marcadas con ✅. Si alguna falta, créala antes de seguir (es la página donde el socio se da de alta y ve sus datos) |
| 3. Planes de Membresía | Define los planes que puede elegir un socio y su precio anual | Marca solo los planes que ofrecéis de verdad. Los precios, «Precio anual» en euros |
| 4. Configuración de Redsys | Guarda las claves de cobro con tarjeta y Bizum: «Merchant Code» y «Secret Key» | Rellénalo solo cuando el banco te dé los datos. Si todavía no cobras por tarjeta, Por confirmar si el asistente obliga a rellenarlo |
| 5. Convoca Shifts | Fija el «Horario del centro» de los turnos de voluntariado: «Hora de apertura» y «Hora de cierre» | El horario real del centro. En la demo está de 09:00 a 22:00 |
| 6. El Ecosistema Convoca | Lista los módulos instalados y deja elegir el «Tema de los documentos» (Claro (por defecto) / Oscuro) con el botón «Guardar tema» | «Claro (por defecto)» si vas a imprimir documentos; «Oscuro» solo si todo se lee en pantalla |
| 7. Finalización | Resumen de lo configurado, con el botón «Finalizar configuración» | Repasa el resumen antes de pulsar; si algo está mal, vuelve atrás con «Anterior» |
Ajuste por ajuste: paso 3 (planes de cuota)¶
El paso 3 dice literalmente: «Marca los planes disponibles, edita su nombre, modalidad y precio anual:». Cada plan tiene cinco columnas:
| Columna | Para qué sirve | Valor recomendado |
|---|---|---|
| Activo | Marca si el plan se ofrece o no | Marca solo los que vayáis a cobrar este año |
| Nombre visible | El nombre que verá el socio | Uno corto y claro (en la demo: «🥉 Bronce», «🥈 Plata», «🥇 Oro») |
| ID corto | Nombre interno del plan (Por confirmar si se puede cambiar después sin romper cuotas ya cobradas) | Déjalo como viene |
| Modalidad | Distingue planes Numerario, Familiar o Juvenil | La que corresponda a ese precio |
| Precio (€) | Cuota anual del plan | El importe que apruebe la asamblea |
En la demo medida hay 9 planes activos, con estos nombres y precios: Bronce 30,00 € · Plata 50,00 € · Oro 100,00 € · Familiar Bronce 45,00 € · Familiar Plata 75,00 € · Familiar Oro 150,00 € · Juvenil Bronce 15,00 € · Juvenil Plata 25,00 € · Juvenil Oro 50,00 €. Son un buen punto de partida, no una obligación.
Ajuste por ajuste: pasos 4 y 5 (cobros y turnos)¶
| Ajuste | Para qué sirve | Valor recomendado |
|---|---|---|
| Merchant Code (paso 4) | Identifica a la asociación ante el banco para cobrar con tarjeta o Bizum | El número que te da el banco, sin espacios |
| Secret Key (paso 4) | Clave de seguridad del cobro | La del banco. Se guarda cifrada: no se ve al volver a la pantalla |
| Hora de apertura (paso 5) | Primera hora en la que puede empezar un turno de voluntariado | La hora real a la que abre el centro |
| Hora de cierre (paso 5) | Última hora a la que puede terminar un turno | La hora real a la que cierra el centro |
El paso 4 tiene un botón «Guardar» propio y el paso 5 también: si cambias un valor, guárdalo antes de pasar de página.
Otros ajustes del módulo Core¶
| Ajuste | Para qué sirve | Valor recomendado |
|---|---|---|
| Licencia (Convoca → Licencia) | Activa las funciones de pago del ecosistema | La clave que te haya dado Convoca. Dato medido: el carnet de socio se sirve igualmente sin licencia de pago |
| Copia de Seguridad → Descargar ZIP de Seguridad | Genera un archivo comprimido con las tablas de datos en CSV y la configuración | Descárgala antes de cualquier cambio grande (actualizaciones, importaciones masivas) |
| Copia de Seguridad → Validar archivo y previsualizar | Sube una copia hecha con Convoca para ver qué va a restaurar antes de aplicarlo | Úsala para restaurar; revisa la previsualización antes de confirmar |
| Salud del Sistema y Registros | Revisan el estado del motor y dejan rastro de lo que ha pasado | Míralos cuando algo falle y tengas que avisar al soporte |
| Desinstalación | Quita Convoca de la web | No lo uses sin copia de seguridad reciente |
Por confirmar: el detalle de las pantallas «Salud del Sistema», «Registros», «Notificaciones» y «Licencia». En la comprobación de hoy se ha verificado que las cuatro responden y se abren, pero no se ha guardado captura de su contenido interno.
Cuándo revisar estos ajustes¶
- Al empezar el año: precios de los planes y modalidades (lo que haya aprobado la asamblea).
- Antes de la campaña de cuotas: Merchant Code, Secret Key e IBAN (el IBAN se configura en el módulo Miembros).
- Al cambiar el horario del centro: hora de apertura y cierre de los turnos.
- Antes de cualquier actualización: descarga una copia de seguridad.
Problemas conocidos¶
- core#18 — El enlace de las notificaciones apunta a una pantalla que no existe: si sigues el enlace de una notificación, acabarás en «Lo siento, no tienes permisos». Entra por el menú.
- core#19 — El número de versión de los ficheros comunes no es la versión del módulo: puede hacer que el navegador sirva estilos o gráficas antiguas. Recarga con Ctrl+F5.
- Los avisos que afectan a socios, cuotas y horas están en el manual del módulo Miembros.
¿Administras el sistema y buscas los detalles técnicos (ganchos, capacidades, API)? Están en la referencia técnica: docs/plugins/convoca-core.md.