=== Casaca ===
Contributors: aguiart0, apiki
Tags: tainacan, reports, analytics, museum, collections
Requires at least: 6.6
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Advanced reporting and analytics add-on for Tainacan digital collections platform.

== Description ==

Casaca is a powerful add-on that extends the Tainacan digital collections platform with comprehensive reporting and analytics capabilities. This plugin provides detailed insights into your collections, items, and user interactions.

= Features =

* Generate detailed reports on collections and items
* Analytics dashboard with visual charts and graphs
* Export reports in multiple formats
* Custom report filters and parameters
* User activity tracking and statistics
* Performance metrics and insights

= Requirements =

- PHP version 7.4 or higher
- Tainacan plugin installed and activated
- WordPress 5.0 or higher

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/casaca` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Make sure you have Tainacan plugin installed and activated.
4. Access the reports through the Tainacan admin menu.

== Source Code ==

This plugin uses compiled JavaScript and CSS files for performance and compatibility reasons.

**All source code is included in this plugin:**

* Source files: `/assets/` directory
* Compiled files: `/dist/` directory
* Block definitions: `/assets/blocks/*/block.json`

**Build Instructions:**

1. Install dependencies:
   ```
   npm install
   ```

2. Build assets:
   ```
   npm run build
   ```

All source code is human-readable and included for review.

== External Services ==

This plugin uses Google Charts API for data visualization and chart rendering functionality.

**What the service is and what it is used for:**
Google Charts API is used to generate interactive charts (bar charts, pie charts, and tables) in reports. The charts are rendered dynamically to help users visualize collection data and statistics.

**What data is sent and when:**
When a user creates or views a report with charts enabled, the plugin loads the Google Charts JavaScript library from Google's servers (gstatic.com). The chart configuration data (labels, values, colors) may be processed by Google's servers to render the charts. This happens:
- When editing a report in the WordPress admin
- When viewing a generated report with charts
- During PDF report generation with chart visualization

No personal information or sensitive data is transmitted. Only chart configuration (numerical values, labels, and chart settings) is processed.

**Service Provider:**
- Service: Google Charts API
- Provider: Google LLC
- Charts Library URL: https://www.gstatic.com/charts/
- Terms of Service: https://developers.google.com/chart/terms
- Privacy Policy: https://policies.google.com/privacy

Note: Google Charts is a free service provided by Google. No API key or user account is required to use this service with the plugin.

== Screenshots ==

1. Reports dashboard with analytics overview
2. Detailed collection statistics
3. Export options and filters

== Changelog ==

= 1.0.0 = 2022-08-11
* Initial Release
* Basic reporting functionality
* Analytics dashboard
* Export capabilities

