# Krawlup Analytics for WordPress & WooCommerce

[![License](https://img.shields.io/badge/License-GPL--2.0--or--later-blue.svg)](LICENSE)
[![WordPress](https://img.shields.io/badge/WordPress-5.6%2B-blue)](https://wordpress.org)
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-purple)](https://php.net)

Official WordPress & WooCommerce plugin for [Krawlup](https://krawlup.com) — the 100% cookieless, privacy-first analytics and AI crawler intelligence platform.

---

## Features

- **100% Cookieless**: No cookies, no local storage tracking, zero GDPR/PECR cookie banners needed.
- **Automated WooCommerce Revenue Attribution**: Captures purchase conversions, order totals, and currency on `woocommerce_thankyou` with refresh idempotency guards.
- **Admin Exclusion**: Prevents logged-in administrator and editor visits from skewing organic metrics.
- **Tiny Footprint**: The tracker is 3,287 bytes parsed, 1,383 bytes gzipped, loaded deferred and render-free, preserving Core Web Vitals and PageSpeed scores.
- **Custom Endpoint**: Supports reverse-proxying analytics requests through custom domains.

---

## Installation

### Manual Installation
1. Download the latest release `.zip` from this repository or the Krawlup dashboard — about 24 KB.
2. In WordPress admin, go to **Plugins** → **Add New Plugin** → **Upload Plugin**.
3. Select the `.zip` file and click **Install Now**.
4. Activate the plugin and configure your **Site Analytics Token** (from your [Krawlup Dashboard](https://krawlup.com/dashboard)) in **Settings** → **Krawlup Analytics**.

---

## Open Source & Licensing

Licensed under the **GNU General Public License v2.0 or later** ([GPL-2.0-or-later](LICENSE)).