SecureDocs

2. 🚀 Primeros pasos

📄 Paso 1: Crear las páginas necesarias

Necesitas crear dos páginas en WordPress con los siguientes shortcodes:

🏷️ Paso 2: Crear la primera categoría

1. Accede al panel admin (página con [gestdoc_admin])
2. Ve a la pestaña Categorías
3. Haz clic en Nueva Categoría
4. Rellena: Nombre, slug (opcional), descripción e icono
5. Haz clic en Crear Categoría

👤 Paso 3: Crear tu primer cliente

1. Ve a la pestaña Clientes
2. Haz clic en Nuevo Cliente
3. Rellena los campos obligatorios: usuario, nombre, email, contraseña
4. Opcionalmente, añade empresa, teléfono, dirección, etc.
5. Haz clic en Crear Cliente

📤 Paso 4: Subir tu primer documento

1. Ve a la pestaña Subir Documento
2. Selecciona un cliente del desplegable
3. Selecciona una categoría
4. Arrastra un archivo o haz clic para seleccionarlo
5. Espera a que la subida termine (barra de progreso)
6. Activa "Enviar notificación por email" si deseas
7. Haz clic en Publicar documento

3. 📊 Panel de Administración

El panel está organizado en 8 pestañas. En la siguiente tabla se explica cada una:

4. 👥 Gestión de Clientes

➕ Crear un nuevo cliente

1. Ve a la pestaña Clientes
2. Haz clic en Nuevo Cliente
3. Rellena los campos obligatorios: usuario, nombre, email, contraseña
4. Campos opcionales: empresa, DNI/CIF, teléfono, dirección, ciudad, provincia, CP
5. Haz clic en Crear Cliente

✏️ Editar un cliente

1. Busca el cliente en la tabla
2. Haz clic en el botón Editar (azul)
3. Modifica los datos necesarios
4. Haz clic en Actualizar Cliente

🗑️ Eliminar un cliente (con limpieza completa)

1. Busca el cliente en la tabla
2. Haz clic en el botón Eliminar (rojo)
3. Se abre un modal de confirmación con el resumen
4. Confirma la eliminación

👤 Suplantar un cliente ("Portal")

1. Busca el cliente en la tabla
2. Haz clic en el botón Portal
3. Verás exactamente lo que ve ese cliente
4. Para volver, aparece una barra amarilla: Volver al panel admin

5. 🏷️ Gestión de Categorías

Las categorías organizan los documentos y mejoran la navegación en el área del cliente.

➕ Crear una categoría

1. Ve a la pestaña Categorías
2. Haz clic en Nueva Categoría
3. Rellena los campos:
   • Nombre (obligatorio)
   • Slug (opcional, para URL amigable)
   • Descripción (opcional)
   • Icono - imagen que se mostrará en el área cliente
4. Haz clic en Crear Categoría

✏️ Editar una categoría

1. Busca la categoría en el listado con diseño de tarjetas
2. Haz clic en Editar
3. Modifica los datos y guarda

🗑️ Eliminar una categoría

1. Haz clic en Eliminar en la tarjeta de la categoría
2. Confirma la eliminación

6. 📄 Gestión de Documentos

📤 Subir un documento (método privado)

1. Ve a la pestaña Subir Documento
2. Selecciona Cliente y Categoría
3. Arrastra el archivo o haz clic para seleccionarlo
4. Espera a que la subida termine (barra de progreso)
5. Activa/desactiva el envío de email
6. Haz clic en Publicar documento

📋 Ver todos los documentos

1. Ve a la pestaña Lista Documentos
2. Verás todos los documentos con detalles
3. Puedes filtrar por cliente o categoría

🔍 Sistema de seguridad de archivos

• Los archivos se guardan en /wp-content/gestdoc_archivos/
• El nombre se convierte en un hash único (ej: d41d8cd98f00b204e98...)
• El cliente descarga con el nombre original (no el hash)
• No se puede acceder directamente por URL
• El archivo .htaccess bloquea el acceso directo

🗑️ Eliminar un documento

1. En Lista Documentos, busca el documento
2. Haz clic en Eliminar (botón rojo)
3. Confirma en el modal

7. 🔐 Área del Cliente

Los clientes acceden a su área privada mediante la página con el shortcode [gestdoc_area].

🏠 Estructura del área cliente

• Cabecera: Título, nombre del cliente, botón cerrar sesión
• Pestañas de categorías: Solo muestra categorías con documentos asignados
• Tabla de documentos: Documentos con fecha, contador de descargas y botón de descarga

⬇️ Descargar documentos

1. Cliente inicia sesión
2. Selecciona una categoría
3. Haz clic en Descargar
4. El archivo se descarga con el NOMBRE ORIGINAL

8. 📧 Logs de Envíos

Muestra el historial completo de emails enviados a clientes al subir documentos.

📊 Información que muestra

• Fecha y hora del envío
• ID del documento
• Cliente destinatario
• Email del cliente
• Estado: ✅ Enviado / ❌ Fallido
• Mensaje de error (si falló)

⚙️ Acciones disponibles

• Exportar CSV: Descarga todos los logs en formato compatible con Excel
• Limpiar logs: Elimina todo el historial (recomendable periódicamente)

9. 📥 Exportar Datos

📄 Exportar documentos

Exporta documentos a CSV con filtros opcionales:

• Filtrar por cliente específico
• Filtrar por categoría
• Rango de fechas (desde/hasta)

👥 Exportar clientes

Exporta todos los clientes con:

• ID, usuario, nombre, email
• Empresa, teléfono, dirección, ciudad, provincia, CP
• Número de documentos asignados

10. ⚙️ Configuración

La pestaña de Configuración permite personalizar la apariencia del plugin.

🔤 Tamaño de letra

• Panel Administración: Pequeño (12px) / Normal (14px) / Grande (16px) / Muy grande (18px)
• Área Cliente: Independiente del admin

🎨 Tema del área cliente

• Claro: Fondo blanco, texto oscuro (por defecto)
• Oscuro: Fondo oscuro, texto claro (modo nocturno)

♿ Alto contraste (accesibilidad)

Fondo negro, texto blanco, bordes amarillos. Recomendado para usuarios con problemas de visión.

📐 Espaciado

• Compacto: Menos espacio, más información visible
• Normal: Espaciado estándar
• Holgado: Más espacio, fácil de leer

11. 🔒 Seguridad

SecureDocs incluye múltiples capas de seguridad para proteger la información.

📁 Protección de archivos

• Carpeta privada: /wp-content/gestdoc_archivos/
• Archivo .htaccess bloquea acceso directo
• Archivo index.php evita listado de directorios
• Nombres hash: md5(uniqid() . name . time())
• Solo descarga vía ?gestdoc_descargar=ID

👤 Control de permisos

• Administradores: Acceso total (capability gestdoc_admin)
• SecureDocs Manager: Rol específico con permisos limitados
• Clientes: Solo ven sus propios documentos

🔐 Nonces de seguridad

Todos los formularios y peticiones AJAX incluyen nonces de un solo uso.

📋 Logs de seguridad

Se registran en la base de datos (tabla gestdoc_security_logs):

• Intentos de acceso no autorizado
• Suplantaciones de clientes
• Eliminaciones de documentos y clientes
• IP, usuario, fecha y acción

12. ❓ Preguntas frecuentes

¿Dónde se guardan los archivos físicamente?

En /wp-content/gestdoc_archivos/. Los nombres son hashes únicos para mayor seguridad.

¿El cliente ve el nombre del archivo?

Sí, el cliente descarga el archivo con el NOMBRE ORIGINAL que subió el administrador.

¿Puedo subir archivos de más de 5MB?

Actualmente el límite es 5MB. Puedes aumentarlo modificando la constante $max_size en el archivo principal del plugin.

¿Qué pasa si elimino un cliente por error?

La eliminación es irreversible. Hay un modal de confirmación para evitarlo, pero no hay papelera.

¿Funciona con PHP 8.x?

Sí, el plugin es compatible con PHP 7.4, 8.0, 8.1 y 8.2.

¿Los clientes pueden subir documentos?

Actualmente solo el administrador sube documentos. Es una funcionalidad planificada para futura versión.

¿Cómo accede el cliente a su área?

Mediante la página con [gestdoc_area] e iniciando sesión con usuario/contraseña dados por el administrador.

¿Recibe el cliente notificación al subir documento?

Sí, si activas "Enviar notificación por email" al subir el documento.

¿Los documentos antiguos (Media Library) siguen funcionando?

Sí, hay retrocompatibilidad total. Los documentos anteriores siguen siendo accesibles.

13. 📞 Soporte técnico

Contacto

📋 Información necesaria para reportar errores

• Descripción detallada del problema
• Pasos para reproducirlo
• Capturas de pantalla (si aplica)
• Versiones: WordPress, PHP y del plugin
• ¿Activo algún tema o plugin conflictivo?

💡 Sugerencias de mejora

¿Tienes una idea para mejorar el plugin? Escríbenos con tu propuesta.