Convoca Members
Guía para administradores: gestión de socios, membresías, cuotas y voluntariado.
1. Introducción¶
Convoca Members gestiona el ciclo de vida completo de los socios de la asociación: altas, renovaciones, bajas, cuotas, estados de membresía, horas de voluntariado, certificados, y documentación. Ideal para asociaciones, ONGs y entidades sin ánimo de lucro.
Requiere: convoca-core activo.
2. Configuración inicial¶
Accede a Convoca → Members → Ajustes:
| Ajuste | Descripción |
|---|---|
| Tipos de membresía | Define los tipos (Numerario, Juvenil, Familiar…) |
| Período de membresía | Duración estándar en meses (por defecto 12) |
| Tipos de cuota | Abono de cuota, Voluntariado |
| Importes por tipo | Precio de cada tipo de membresía |
| Email de bienvenida | Plantilla del email que recibe el nuevo socio |
| Email de renovación | Plantilla del recordatorio de renovación |
Tipos de membresía predefinidos¶
| Tipo | Características |
|---|---|
| Numerario | Miembro de pleno derecho con voz y voto |
| Juvenil | Para menores de 30 años |
| Familiar | Unidad familiar (2+ personas) |
Los tipos son personalizables desde el panel de ajustes.
3. Alta de socio¶
Desde el formulario público¶
El futuro socio accede a la página de alta (/alta-socios/) y completa:
- Datos personales (nombre, DNI, email, teléfono, dirección)
- Tipo de membresía deseada
- Forma de contribución (cuota o voluntariado)
- Aceptación de RGPD y comunicaciones
- El sistema crea el registro y envía email de bienvenida
Desde el panel de administración¶
- Ve a Socios → Añadir nuevo
- Rellena los campos obligatorios en el panel lateral Datos del socio:
| Campo | Obligatorio | Notas |
|---|---|---|
| DNI/NIE | ✅ | Validación automática de formato |
| ✅ | Se usará para comunicaciones y acceso | |
| Teléfono | Recomendado | Formato: XXX XXX XXX |
| Fecha de nacimiento | Recomendado | Para calcular edad y tipo juvenil |
| Dirección postal | Opcional | Calle, ciudad, CP |
| Tipo de membresía | ✅ | Numerario, Juvenil, Familiar |
| Tipo de cuota | ✅ | Abono de cuota o Voluntariado |
| Fecha de alta | ✅ | Se establece automáticamente al publicar |
| Consentimiento RGPD | ✅ | Marcar como "Sí" |
- Haz clic en Publicar
Shortcode para el formulario público¶
Coloca este shortcode en la página de alta de socios.
4. Estados de membresía¶
Cada socio tiene un estado visible en el listado Socios → Todos los socios:
| Estado | Significado | Acción |
|---|---|---|
| Pendiente documentación | Alta reciente, falta documentación | Completar documentación |
| Pendiente pago | Alta con cuota pendiente de pago | Confirmar pago (Redsys/manual) |
| Activo | Membresía vigente | — |
| Suspendido | Temporalmente inactivo (impago, sanción) | Reactivar desde el perfil del socio |
| Baja solicitada | El socio pidió la baja, pendiente de confirmar | Confirmar o reactivar |
| Baja | El socio ha causado baja | Conservar para histórico |
Cambiar estado¶
- Edita el socio
- En el panel lateral Estado del socio, selecciona el nuevo estado
- Fecha de renovación se recalcula automáticamente al activar/reactivar
- Haz clic en Actualizar
5. Renovaciones¶
Renovación automática¶
El sistema detecta automáticamente cuando un socio rellena de nuevo el formulario de alta:
- Si el email/DNI ya existe → se considera renovación
- La fecha de fin se extiende 12 meses desde la nueva solicitud
- Se registra en el historial del socio
Renovación manual¶
- Edita el socio
- Actualiza Fecha de renovación a la nueva fecha
- Cambia el estado a Activo si estaba pendiente/baja
- Añade una nota en Observaciones explicando el motivo
6. Bajas¶
Las bajas son siempre lógicas (el registro se conserva para histórico):
- Edita el socio
- Cambia el estado a Baja
- Establece Fecha de baja a la fecha actual
- Añade el motivo en Observaciones
⚠️ Nunca elimines un socio manualmente. El sistema conserva todo el histórico.
7. Gestión de cuotas y pagos¶
Convoca Members se integra con Convoca Gateway para gestionar pagos.
Registrar un pago manual¶
- Ve a Socios → [nombre] → Pagos
- Haz clic en Añadir pago
- Rellena importe, concepto y fecha
- El estado del socio se actualiza automáticamente
Ver historial de pagos¶
El panel Pagos muestra todos los pagos del socio con fechas, importes y estados.
8. Voluntariado¶
Activar a un socio como voluntario¶
- Edita el socio
- En Tipo de cuota, selecciona Voluntariado
- Marca Es voluntario/a como "Sí"
- El sistema crea automáticamente:
- Ficha de voluntariado en Voluntariado → Fichas
- Registro de horas
Registrar horas de voluntariado¶
- Ve a Voluntariado → Registrar horas
- Selecciona el voluntario
- Introduce fecha, horas y descripción de la actividad
- Las horas quedan pendientes de aprobación
- Un administrador las aprueba desde Voluntariado → Pendientes
Gamificación de voluntariado¶
El sistema asigna insignias automáticamente según las horas acumuladas:
| Insignia | Horas |
|---|---|
| 🌱 Semilla | 10h |
| 🌿 Brote | 50h |
| 🌳 Guardián | 150h |
| 🏆 Maestro | 500h |
Las insignias son visibles en el perfil público del voluntario.
9. Certificados¶
Generar certificado de voluntariado¶
- Ve a Voluntariado → [nombre] → Certificados
- Haz clic en Generar certificado
- Selecciona el período (desde/hasta)
- El sistema genera un PDF con:
- Datos del voluntario
- Horas totales en el período
- Actividades realizadas
- Código único de verificación (formato
VOL-AAAA-XXXXX)
Verificar un certificado¶
Cualquier persona puede verificar un certificado en la página pública:
Introduciendo el código VOL-AAAA-XXXXX se muestra la validez del certificado.
10. Verificación pública de membresía¶
Los socios pueden verificar su estado sin iniciar sesión:
Introducen el código de socio (recibido por email) y ven: - Estado de la membresía - Fecha de alta y vencimiento - Tipo de socio
11. GDPR y protección de datos¶
Exportar datos de un socio¶
- Edita el socio
- Ve a Herramientas GDPR en el panel lateral
- Haz clic en Exportar datos → descarga un JSON con todos los datos
Derecho al olvido¶
- En Herramientas GDPR, haz clic en Anonimizar
- Se conserva el ID y fechas, se eliminan datos personales
- ⚠️ Esta acción es irreversible
12. Email Manager¶
El sistema envía automáticamente:
| Cuándo se envía | |
|---|---|
| Bienvenida | Al activar un nuevo socio |
| Renovación | 30, 15 y 7 días antes del vencimiento |
| Recordatorio de pago | 7 y 3 días después del vencimiento |
| Certificado | Al generar un certificado de voluntariado |
Las plantillas se personalizan en Convoca → Members → Plantillas de email.
13. Auditoría¶
Cada cambio en un socio genera una entrada de auditoría:
- Ve a Convoca → Registros
- Filtra por tipo "members"
- Cada entrada muestra: fecha, usuario que hizo el cambio, campo modificado, valor anterior y nuevo
14. Shortcodes públicos¶
| Shortcode | Descripción |
|---|---|
[convoca_alta_socio] |
Formulario de alta para nuevos socios |
[convoca_mi_area] |
Panel completo del socio (carnet, inscripciones, voluntariado, pagos) |
[convoca_mi_perfil] |
Perfil del socio logueado (nombre, email, estado, inscripciones) |
[convoca_renovar] |
Renovación de membresía: muestra el plan y genera el pago (página /renovar/) |
[convoca_voluntariado] |
Formulario de alta de voluntariado |
[convoca_verificar_socio] |
Verificación pública de membresía |
[convoca_verificar_certificado] |
Verificación pública de certificados |
15. Panel del socio (área personal)¶
El panel [convoca_mi_area] (página Mi Cuenta) ofrece al socio autenticado:
| Pestaña | Funcionalidad |
|---|---|
| Mis Datos | Ver y editar dirección, teléfono, email y cumpleaños; solicitar baja |
| Carnet Digital | Carnet de socio descargable |
| Inscripciones | Actividades activas y pasadas |
| Voluntariado | Registrar y consultar horas |
| Pagos y Cuotas | Historial de pagos + botón "Renovar membresía" |
| Buscar | Búsqueda de actividades |
| Notificaciones | Avisos internos del sistema |
Reglas de edición de datos¶
| Dato | Regla |
|---|---|
| Dirección | Editable libremente |
| Teléfono | Editable libremente; verificable con enlace por email |
| Cambio pendiente hasta confirmar con el enlace enviado al correo (24h) | |
| Cumpleaños | Solo se puede establecer una vez; no se modifica después |
Verificación de datos (email y teléfono)¶
Ambos datos se verifican con un enlace enviado al email del socio:
- Teléfono: botón "Verificar teléfono" en Mis Datos → el socio recibe un email con enlace → al pulsarlo, el teléfono queda marcado como verificado.
- Email: al cambiar el email → queda en pendiente → el socio recibe un enlace de confirmación → solo se aplica al pulsarlo.
El estado de verificación se muestra en el perfil (✅ verificado / pendiente).
Renovación de membresía¶
- Botón "Renovar membresía" (Pagos y Cuotas): genera el pago de un año más y redirige al TPV.
- Página
/renovar/(shortcode[convoca_renovar]): la misma función desde un enlace directo (por ejemplo, el de los emails de renovación). Los socios con pago recurrente se renuevan automáticamente.
16. Proveedor de email (verificación y avisos)¶
El envío de emails (confirmaciones, renovaciones, avisos) usa un proveedor configurable en Ajustes → General → Proveedor de email:
| Proveedor | Descripción |
|---|---|
| WordPress (wp_mail) | Usa el correo configurado en WordPress (por defecto) |
| Mailgun | Envío transaccional vía API de Mailgun (requiere API Key, dominio y región US/EU) |
El proveedor se puede extender con el filtro convoca_email_providers.
16.1 Estructura de datos¶
| Tipo | Descripción |
|---|---|
CPT miembro |
Socios de la asociación |
CPT convoca_documento |
Documentos del socio (carnet, certificados, adjuntos) |
Taxonomía tipo_miembro |
Tipo de miembro (numerario, juvenil, familiar, honorífico) |
17. API REST¶
Namespace: convoca-members/v1. Los endpoints /me/* requieren sesión de socio (cookie convoca_member_session + nonce X-WP-Nonce); /login y /alta son públicos.
| Método | Ruta | Descripción |
|---|---|---|
| POST | /login |
Iniciar sesión de socio (email + código) |
| POST | /alta |
Alta de socio |
| GET | /me |
Perfil del socio (datos, estado, verificación email/teléfono) |
| POST | /me/profile |
Editar perfil (dirección, teléfono, email con confirmación, cumpleaños una vez) |
| POST | /me/verify-phone |
Enviar enlace de verificación de teléfono al email |
| POST | /me/confirm-email |
Confirmar email pendiente con token |
| POST | /me/renovar |
Renovar membresía (genera pago y devuelve payment_url) |
| POST | /me/unsubscribe |
Solicitar baja (baja_solicitada) |
| GET | /me/card |
Datos del carnet digital |
| GET | /me/certificate |
Certificado de socio |
| GET | /me/certificate/download |
Descargar certificado PDF |
| GET | /me/gamification |
Datos de gamificación del socio (insignias, niveles) |
| GET | /me/pagos |
Historial de pagos |
| GET | /me/horas |
Horas de voluntariado |
| GET | /me/inscripciones |
Inscripciones del socio |
| GET | /proyectos |
Proyectos |
| GET | /search |
Búsqueda de socios (admin) |
| GET | /admin/members/search |
Búsqueda admin de miembros |
| GET | /documentos/{id} |
Documento del socio |
| GET | /member/notifications |
Notificaciones del socio |
| POST | /member/notifications/read |
Marcar notificación leída |
| POST | /member/notifications/read-all |
Marcar todas leídas |
18. Problemas comunes¶
| Problema | Solución |
|---|---|
| No se envían emails | Verifica Convoca → Registros para ver errores de envío; revisa el proveedor configurado |
| Socio duplicado | Fusiona desde Socios → Herramientas → Fusionar. Detecta por DNI/email |
| Membresía no se renueva | Verifica que el estado es "Activo" y la fecha de fin es futura |
| No aparece en listados | Comprueba que el estado no es "Borrador" |
| Error al generar PDF | Verifica que Dompdf está instalado (composer install en convoca-core) |
| Certificado no válido | Si fue revocado, aparece como "Revocado" en la verificación |
| El email de verificación no llega | Revisa que el proveedor de email está configurado y que la carpeta de spam no lo bloqueó |
| No puedo cambiar mi cumpleaños | Es intencional: solo se puede establecer una vez |