=== Websiteanalist ===
Contributors: websiteanalist
Tags: analytics, tracking, websiteanalist, custom events, event tracking
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add powerful WordPress analytics and event tracking to your website with fully configurable custom tracking actions.


== Description ==

Websiteanalist is a WordPress plugin that integrates the Websiteanalist analytics platform into your WordPress website.

The plugin itself is free to install and use. To view analytics data, an active Websiteanalist account is required. New accounts include a 14-day free trial.

= Key Features =

* **Custom Event Tracking** - Configure unlimited custom tracking actions
* **Flexible Event Types** - Click, change, blur, input, mousedown, mouseup, submit
* **Dynamic Values** - Element value, text, HTML, data attributes, or fixed values
* **Click Tracking** - Track phone (tel:) and email (mailto:) link clicks
* **Form Tracking** - Track form submissions
* **UTM Parameter Tracking** - Automatic campaign tracking
* **Privacy Friendly** - Analytics data is sent only to your configured Websiteanalist installation

= Custom Tracking Actions =

The power of Websiteanalist lies in its custom tracking functionality. Configure easily via the WordPress admin:

1. **CSS Selector** - Which element to track (e.g., `#filter-category`, `.radio-button`)
2. **Event Type** - When to track (click, change, blur, etc.)
3. **Action Name** - First parameter of trackAction
4. **Label** - Second parameter (can be dynamic)
5. **Value** - Third parameter (element value, text, data attribute, or fixed)

= Examples =

**Radio Station Tracking:**
* Selector: `.element-item.audio`
* Event: Click
* Action: Radio Click
* Label: Element Text (automatically captures station name)
* Value: Data Attribute `data-id`

**Form Field Tracking:**
* Selector: `#nf-field-40`
* Event: Change
* Action: Form Submission
* Label: Contact Form
* Value: Element Value (captures the entered email address)

**Product Filter Tracking:**
* Selector: `#category-filter`
* Event: Change
* Action: Filters
* Label: Category Selected
* Value: Element Value

= Use Cases =

* **E-commerce** - Product filters, add to cart, checkout steps
* **Job Boards** - Filter tracking, application clicks
* **Media Sites** - Radio/video plays, category filters
* **Corporate Sites** - Contact forms, downloads, language switches

= Requirements =

* An active Websiteanalist account
* New accounts include a 14-day free trial
* WordPress 5.0 or higher
* PHP 7.4 or higher

= Multilingual =

The plugin is available in:
* Dutch
* English

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin
2. Go to Plugins > Add New
3. Search for "Websiteanalist"
4. Click "Install" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP
2. Upload via Plugins > Add New > Upload Plugin
3. Activate the plugin
4. Go to Settings > Websiteanalist

= Configuration =

1. **Basic Tab:**
   * Enter your Site ID (get it from Websiteanalist)
   * Optional: Adjust the Base URL (default: https://login.Websiteanalist.nl/)
   * Check "Enable Tracking"

2. **Click Tracking Tab:**
   * Enable/disable phone link tracking
   * Enable/disable email link tracking

3. **Custom Tracking Tab:**
   * Click "+ Add Custom Tracking"
   * Enter the CSS selector
   * Choose the event type
   * Configure Action Name, Label, and Value
   * Click "Save Changes"

== Frequently Asked Questions ==

= Do I need a Websiteanalist account? =

Yes, you need a Websiteanalist account to view the tracking data. New accounts include a 14-day free trial.

= Where do I find my Site ID? =

Log in to your Websiteanalist dashboard and go to site settings. There you'll find your unique Site ID.

= How do I find the right CSS selector? =

1. Open your website in Chrome or Firefox
2. Right-click on the element → "Inspect"
3. In developer tools you'll see the element highlighted
4. Look for `id=""` or `class=""` attributes
5. Test the selector in console: `document.querySelector('your-selector')`

= Does this work with dynamically loaded content? =

Yes! The plugin uses event delegation, so elements that are added later (e.g., via AJAX) are correctly tracked.

= Can I add multiple custom actions? =

Yes, you can add unlimited custom tracking actions.

= Which event types are available? =

* `click` - Element is clicked
* `change` - Value changes (dropdowns, selects)
* `blur` - Field loses focus
* `input` - While typing
* `mousedown` - Mouse press (for submit buttons)
* `mouseup` - Mouse release (for sliders)
* `submit` - Form submission

= How do I track a form field? =

Use the Custom Tracking tab:
* Selector: The CSS selector of the field (e.g., `#email-field`)
* Event: `change` or `blur`
* Value: Choose "Element Value (.val())"

= Is the plugin GDPR compliant? =

The plugin itself doesn't store any data. Websiteanalist is a self-hosted analytics solution where you have full control over your data. Consult the Websiteanalist documentation for GDPR compliance.

= Can I temporarily disable tracking? =

Yes, go to the Basic tab and uncheck "Enable Tracking".

== Screenshots ==

1. Basic settings - Site ID and tracking toggle
2. Custom Tracking configuration - Add unlimited custom actions
3. Click Tracking settings - Phone and email tracking
4. Custom Action example - Radio station tracking configuration

== Changelog ==
= 1.0.0 =
* Initial release
* Basic tracking functionality
* Phone and email click tracking
* Form tracking

== Support ==

For questions or support:
* Website: [websiteanalist.nl](https://websiteanalist.nl)
* Plugin Support: [WordPress.org Support Forum](https://wordpress.org/support/plugin/websiteanalist/)

== Privacy ==

This plugin:
* Adds tracking code to your website
* Sends data to your Websiteanalist installation
* Only stores configuration locally (Site ID, settings)
* Does not use cookies or local storage
* Makes no external API calls (except to your own Websiteanalist installation)

For more information about data privacy, see the Websiteanalist documentation.

== Third Party Services ==

This plugin connects to an external analytics service to track website visitor data.

The Websiteanalist platform is a proprietary analytics service. This plugin acts as a connector between WordPress and your Websiteanalist account.

**Service:** Websiteanalist Analytics Platform
**Default URL:** https://login.websiteanalist.nl/
**Configurable:** Yes, you can specify your own Websiteanalist installation URL

**Data Transmission:**
* Tracking data is sent to your configured Websiteanalist installation
* No data is transmitted without explicit user configuration
* Users must enable tracking and provide a Site ID

**Privacy & Control:**
* You have full control over where data is sent (self-hosted or SaaS)
* No tracking occurs unless explicitly enabled by the site administrator
* No cookies or local storage used by the plugin itself
* All tracking is handled by the Websiteanalist service

**Service Information:**
* Website: [https://websiteanalist.nl](https://websiteanalist.nl)
* Terms of Service: [https://websiteanalist.nl/algemene-voorwaarden/](https://websiteanalist.nl/algemene-voorwaarden/)
* Privacy Policy: [https://websiteanalist.nl/privacyverklaring/](https://websiteanalist.nl/privacyverklaring/)

**User Consent:**
It is the website owner's responsibility to ensure proper user consent and privacy compliance (GDPR, CCPA, etc.) when using analytics tracking.