=== Suziwan Referrer Log ===
Contributors: suziwan
Tags: analytics, referrer, utm, privacy, log
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A lightweight, privacy-friendly way to log referrers, UTM parameters, and visitor metadata directly in your WordPress database.

== Description ==

Suziwan Referrer Log is a simple yet powerful analytics tool developed in Nice, France, with privacy in mind. Unlike heavy third-party services, this plugin stores visitor source data locally on your server, giving you full ownership of your data.

It is specifically designed to track:
* **External Referrers**: See which websites are sending traffic to your site.
* **Full UTM Tracking**: Log source, medium, campaign, term, and content for your marketing campaigns.
* **Visitor Metadata**: Capture landing URLs, browser languages, and user agents.
* **Data Management**: Includes a settings page to easily clear all logs or purge old data (e.g., keep only the last 30 days) to keep your database lean.

**Privacy First:**
To comply with global privacy standards like GDPR, this plugin automatically anonymizes IP addresses by masking the last octet before saving them to the database. No personally identifiable information (PII) is stored.

== Installation ==

1. Upload the `suziwan-referrer-log` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Visit the 'Suziwan Referrers' menu in your dashboard to view statistics and manage settings.

== Frequently Asked Questions ==

= Does this plugin use cookies? =
No, this plugin does not set any cookies on the visitor's browser.

= Where is the data stored? =
All data is stored in a dedicated table within your WordPress database. No data is ever sent to external servers.

= Can I limit the amount of data stored? =
Yes, you can go to the Settings page to delete old entries automatically based on a number of days you define.

== Screenshots ==

1. The main statistics dashboard showing referrers and UTM data.
2. The settings page for database maintenance and purging.

== Changelog ==

= 1.0.0 =
* Initial release.
* Anonymized IP tracking (GDPR compliant).
* Full UTM and Referrer logging.
* Added data management features (Clear all/Purge by date).