=== SGN Portal Lite === Contributors: robirasdesign Tags: facturas, clientes, locales, portal, notificaciones, administración Requires at least: 6.2 Tested up to: 6.6 Requires PHP: 8.0 Stable tag: 2.3.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sistema de gestión de facturas, clientes y locales para portales privados de empresas. Permite la publicación manual o masiva de facturas PDF y la notificación automática a los clientes por correo electrónico.

== Descripción ==

SGN Portal Lite es un plugin desarrollado por Robiras Design para la gestión interna de clientes y facturas dentro de un entorno WordPress.
Está pensado para empresas que desean ofrecer a sus clientes un acceso privado a sus facturas y documentos, sin depender de plataformas externas.

Este sistema permite:

• Publicar facturas PDF individualmente o mediante importaciones masivas (ZIP).
• Asociar facturas a clientes y locales específicos.
• Enviar notificaciones por correo electrónico con plantilla HTML.
• Gestionar de forma centralizada clientes, locales y documentos desde el panel de administración.
• Eliminar automáticamente los archivos físicos al borrar facturas.

El plugin integra un flujo completo Cliente → Local → Factura, manteniendo la organización de los documentos en carpetas por cliente dentro del directorio /uploads/sgn-facturas/.

---

== Características principales ==

🧾 Gestión de facturas

• Subida manual con selector de cliente, local, año y mes.
• Importación masiva desde archivos .zip con asignación automática.
• Eliminación de archivos físicos al borrar facturas.
• Redirección automática al listado tras publicar o guardar.

🏢 Gestión de locales

• Creación de locales asociados a clientes.
• Campos detallados: dirección, localidad, provincia, código postal y teléfono.
• Listado con búsqueda por nombre, dirección o cliente propietario.

👤 Gestión de clientes

• Alta y edición directa de clientes desde el panel SGN Portal.
• Asociación múltiple de locales a cada cliente.
• Campos personalizados de contacto, empresa y dirección.
• Búsqueda rápida por DNI, nombre o correo.

📬 Notificaciones automáticas

• Envío de correo electrónico al cliente cuando se publica o importa una factura.
• Plantilla HTML personalizada (email-nueva-factura.html).
• Variables dinámicas: {display_name} y {portal_url}.
• Activación/desactivación desde el panel de ajustes del plugin.

⚙️ Configuración

• Sección de ajustes dedicada dentro del panel SGN Portal.
• Parámetros: URL del portal del cliente y activación de envío de correos.

🔒 Integración segura

• Compatible con PHP 8.2+ y WordPress 6.6+.
• Cumple con las buenas prácticas de codificación y seguridad WordPress.
• Funciona tanto en entornos locales (Laragon, LocalWP) como en servidores productivos.

---

== Instalación ==

1. Sube el archivo sgn-portal-lite.zip al directorio /wp-content/plugins/ o instálalo directamente desde el panel de administración de WordPress.
2. Activa el plugin desde el menú “Plugins”.
3. Accede al nuevo menú SGN Portal en el panel de administración.
4. Configura la URL del portal y activa el envío de correos desde la sección “Ajustes”.
5. Crea clientes, locales y comienza a subir facturas.

---

== Uso ==

1. Clientes:
   Crea o edita clientes desde el menú SGN Portal → Clientes.
   Puedes asignar múltiples locales a un mismo cliente.

2. Locales:
   Añade nuevos locales desde el menú SGN Portal → Locales, seleccionando el cliente propietario.

3. Facturas:

   • Para subir una factura manual: SGN Portal → Facturas → “Añadir nueva”.
   • Para importar en masa: SGN Portal → Importar → selecciona un archivo ZIP.

4. Notificaciones:
   Si está activada la opción “Enviar correo”, cada cliente recibirá un email con la nueva factura publicada.

---

== FAQ ==

= ¿Qué formato debe tener el nombre de los archivos PDF en la importación masiva? = El formato recomendado es: