=== Reportia — Reportes PDF y Excel ===
Contributors: reportia
Tags: reports, pdf, excel, json, generator
Requires at least: 5.6
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: MIT
License URI: https://opensource.org/licenses/MIT

Genera reportes profesionales en PDF y Excel a partir de datos JSON directamente desde tu sitio WordPress.

== Description ==

Reportia te permite convertir datos JSON en reportes listos para descargar en formato PDF o Excel. Ideal para dashboards, paneles de administracion, portales de clientes o cualquier pagina donde necesites ofrecer reportes descargables.

**Caracteristicas principales:**

* Shortcode `[reportia]` para insertar el generador de reportes en cualquier pagina o entrada.
* Los usuarios pegan datos JSON, eligen formato (PDF o Excel) y descargan el resultado con un clic.
* Conexion segura a la API de Reportia con tu API key.
* Estilo limpio y responsivo integrado (sin archivos CSS externos).
* Opcion para mostrar u ocultar la insignia de atribucion.
* Links de descarga temporales con expiracion automatica de 5 minutos.
* Limpieza automatica de archivos temporales.

**Casos de uso:**

* Portales de clientes que generan facturas o resúmenes.
* Dashboards internos con exportacion de datos.
* Herramientas internas de equipos que necesitan reportes rapidos.
* Cualquier sitio donde los usuarios proporcionan datos y necesitan un documento profesional.

== Installation ==

1. Sube la carpeta `reportia-wordpress` al directorio `/wp-content/plugins/`.
2. Activa el plugin desde el menu "Plugins" en WordPress.
3. Ve a **Ajustes > Reportia** e introduce tu API key (obtenla en [reportia.4l3.org](https://reportia.4l3.org)).
4. Inserta el shortcode `[reportia]` en cualquier pagina o entrada donde quieras mostrar el generador de reportes.

== Frequently Asked Questions ==

= Donde obtengo mi API key? =

Registrate en [reportia.4l3.org](https://reportia.4l3.org) y copia tu API key desde el panel de tu cuenta.

= Que formatos de reporte soporta? =

PDF y Excel (XLSX).

= Necesito instalar algo adicional en mi servidor? =

No. El plugin se conecta a la API de Reportia en la nube. Solo necesitas WordPress con PHP 7.4 o superior.

= Puedo ocultar el texto "Generado por Reportia"? =

Si. Ve a **Ajustes > Reportia** y desmarca la opcion "Mostrar insignia de atribucion".

= El shortcode funciona en el editor de bloques (Gutenberg)? =

Si. Puedes usar un bloque de "Shortcode" e insertar `[reportia]`.

= Que estructura debe tener el JSON? =

Reportia acepta cualquier objeto JSON valido. La API interpreta los datos y genera tablas, secciones y formatos automaticamente. Consulta la documentacion en [reportia.4l3.org](https://reportia.4l3.org) para ejemplos avanzados.

= Los archivos generados se almacenan en mi servidor? =

Los archivos se guardan temporalmente (maximo 5 minutos) para permitir la descarga y luego se eliminan automaticamente. Ademas, un cron diario limpia cualquier archivo residual.

== Screenshots ==

1. Formulario de generacion de reportes en el frontend.
2. Pagina de configuracion del plugin.

== Changelog ==

= 1.0.0 =
* Lanzamiento inicial.
* Shortcode `[reportia]` con formulario de generacion.
* Pagina de ajustes con API key e insignia de atribucion.
* Integracion con la API de Reportia para PDF y Excel.
* Descarga segura con tokens temporales.
* Limpieza automatica de archivos temporales.

== Upgrade Notice ==

= 1.0.0 =
Primera version del plugin.
