Solución de problemas frecuentes #

Checklist de diagnóstico rápido para los problemas más comunes.

🔴 Las páginas muestran el shortcode literal ([mrc_panel_ventas]) #

Causa: el plugin correspondiente está desactivado o tuvo un error fatal.

Solución:

1. Plugins → Plugins instalados.
2. Verificá que los 6 plugins medi-rep-* estén activos (fondo azul).
3. Si alguno está desactivado, reactivalo. Si falla al activar, WP muestra el motivo arriba.
4. Revisá /wp-content/debug.log para ver el error exacto.
5. Asegurate de que los archivos del plugin estén completos (que no falten archivos de la subida).

🔴 «No tienes permiso para ver esta página» #

Causa: el usuario no tiene las capacidades del rol asignadas (común tras una reactivación del plugin).

Solución:

1. Cerrá sesión y volvé a iniciarla (refresca caps del usuario en la sesión).
2. Si persiste, desactivá y reactivá el plugin medi-rep-core una vez desde Plugins → Plugins instalados.
3. Como último recurso, editá el usuario desde Usuarios → Todos, cambiá el rol a Suscriptor, guardá, y volvé a cambiarlo al rol correcto.

🔴 El dashboard se queda «pensando» (spinner infinito) #

Causa: el AJAX falla silenciosamente. Suele ser un error PHP o el nonce caducado.

Solución:

1. Abrí la consola del navegador (F12 → pestaña Console).
2. Buscá mensajes en rojo.
3. Los más comunes:

• 403 Forbidden → nonce caducado: recargá la página con Ctrl + F5.
• 500 Internal Server Error → error PHP: mirá /wp-content/debug.log.
• MRC is not defined → el script mrc-global.js no se cargó: desactivá plugins de caché/minificación y probá de nuevo.

🔴 No llegan los emails de recuperación de contraseña #

Causa: SMTP no configurado.

Solución:

1. Instalá WP Mail SMTP (gratuito).
2. Configurá un servicio transaccional (Brevo/Sendinblue es gratis hasta 300 emails/día).
3. Probá el envío desde WP Mail SMTP → Email Test.

Hasta que configures SMTP, WordPress usa el PHP mail del servidor, que suele ser bloqueado por Gmail y Outlook.

🔴 «Error al importar ventas: cliente no encontrado» #

Causa: el codigo_cliente del Excel no coincide con ningún cliente en la BD.

Solución:

1. Exportá la lista actual de clientes desde Clientes → Exportar.
2. Cruzá los códigos del archivo de ventas contra la lista oficial.
3. Corregí el Excel o creá los clientes faltantes antes de reimportar.

🔴 Un representante no ve a sus clientes #

Causa: los clientes no están asignados al rep o el rep no está en ningún equipo.

Solución:

1. Iniciá sesión como Gerente de Ventas.
2. Configuración App → Asignaciones: verificá que el rep esté en algún DM.
3. Clientes → Filtrar por Representante = [nombre]: ¿aparecen los clientes? Si no, asignalos desde el detalle de cada cliente.

🔴 El Panel del Gerente de Distrito muestra 0 en todos los KPIs #

Causa: el DM no tiene representantes asignados, o sus reps no tienen actividades en el período.

Solución:

1. Configuración App → Asignaciones: asigná representantes al DM.
2. Verificá que haya actividades registradas en el mes: Actividades → Filtrar por rep (cada rep individual).
3. Si hay actividades pero no aparecen: revisá el filtro de fechas en el panel (esquina superior derecha).

🔴 El Excel exportado sale vacío o corrupto #

Causa: un warning PHP se filtró al archivo binario.

Solución:

1. Activá WP_DEBUG = true temporalmente.
2. Reproducí la exportación.
3. Revisá /wp-content/debug.log por warnings o notices.
4. El plugin ya limpia los buffers, pero un plugin de terceros puede interferir. Desactivalos uno a uno para identificar el culpable.

🔴 «No tengo acceso al login / olvidé la contraseña del admin» #

Solución de emergencia (solo para administradores con acceso al servidor):

1. Conectate por FTP o cPanel.
2. Andá a /wp-content/plugins/.
3. Renombrá la carpeta medi-rep-auth a medi-rep-auth.off.
4. Ahora podés ingresar por el login estándar de WordPress en /wp-login.php.
5. Restablecé la contraseña desde ahí.
6. Volvé a renombrar la carpeta a medi-rep-auth para reactivar el login personalizado.

🔴 La BD creció demasiado rápido #

Causa: actividades de prueba o importaciones duplicadas.

Solución:

1. wp-admin → Medi Rep Cloud → Actividades: filtrá por fecha y revisá si hay duplicados.
2. Eliminá los registros que no corresponden.
3. Optimizá las tablas: wp-admin → WP-Optimize → Database (plugin gratuito).

Checklist general antes de escalar a soporte #

Antes de contactar a contacto@innovadevs.pro:

• [ ] ¿Revisaste el /wp-content/debug.log?
• [ ] ¿Recargaste con Ctrl + F5?
• [ ] ¿Cerraste y abriste sesión?
• [ ] ¿Probaste en otro navegador o modo incógnito?
• [ ] ¿Desactivaste otros plugins para descartar conflictos?
• [ ] ¿Tenés un backup reciente en caso de que haya que restaurar?

Si todo lo anterior no resuelve, envianos: captura del error, log de PHP, y versión de WP/PHP.