MokoSuiteAnalytics/README.md

# MokoSuiteAnalytics

Joomla analytics package — site traffic, ad platform insights, reporting dashboards, and visitor metrics.

![Joomla](https://img.shields.io/badge/Joomla-5.x%20%7C%206.x-blue?style=flat-square&logo=joomla&logoColor=white)
![PHP](https://img.shields.io/badge/PHP-%E2%89%A5%208.1-777BB4?style=flat-square&logo=php&logoColor=white)
![License](https://img.shields.io/badge/license-GPL--3.0--or--later-green?style=flat-square)

## Features

- Privacy-first site analytics (no third-party tracking)
- Page views, unique visitors, referrers, device breakdown
- Ad platform integration (Google Ads, Meta Ads, LinkedIn Ads)
- Campaign performance tracking
- Admin dashboard with charts and date range filters
- CSV/PDF report export
- REST API for metrics data
- Scheduled email reports
- GDPR-compliant (no cookies, IP anonymization)

## Installation

```bash
git clone https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteAnalytics.git
cd MokoSuiteAnalytics
composer install
make build
```

Upload `dist/pkg_mokosuiteanalytics-*.zip` via **System > Install > Extensions** in Joomla admin.

## Links

- **Help:** [mokoconsulting.tech/support/products/mokosuiteanalytics](https://mokoconsulting.tech/support/products/mokosuiteanalytics)
- **Wiki:** [Organization Wiki](https://git.mokoconsulting.tech/MokoConsulting/.profile/wiki)
- **Platform:** [mokoplatform Wiki](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

GPL-3.0-or-later. See [LICENSE](LICENSE).