=== Monolytics ===
Contributors: monolytics
Tags: analytics, conversion-optimization, session-recording, datalayer, behavior-analytics
Requires at least: 6.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Behavior analytics for WordPress with connected setup and direct access to the Monolytics dashboard.

== Description ==

Monolytics helps WordPress teams connect their site to Monolytics Cloud without manually copying tracking code.

With the plugin installed, a WordPress admin can:

* connect the current site to Monolytics from `wp-admin`
* verify whether the site is connected
* review whether DataLayer event tracking is enabled
* see how many sessions have been tracked for the connected domain in the current billing cycle
* disconnect the site locally without deleting the Monolytics domain or historical analytics data
* open the connected Monolytics dashboard in the correct site context

= External services =

This plugin connects to Monolytics-hosted services to authenticate the WordPress admin, create or reuse the connected site in Monolytics, and fetch canonical domain settings.

The plugin does not contact Monolytics until a WordPress administrator explicitly starts the connect flow from `wp-admin`.

It communicates with:

* `https://monolytics.app/` as the public Monolytics service website
* `https://api.monolytics.app` for plugin onboarding, connection state, and canonical domain settings
* `https://cloud.monolytics.app` for the hosted Monolytics authentication and dashboard experience
* `https://cloud.monolytics.app/tracker.js` only after the site is connected and local tracking stays enabled on the public front end

When a site is connected, the plugin may send:

* the current WordPress site URL
* the WordPress site name
* the generated installation and domain identifiers required for the connected setup flow
* plugin setting updates such as the DataLayer interception state

These requests are required so Monolytics can create or reuse the correct connected site and keep WordPress plugin settings aligned with the canonical Monolytics domain configuration.

Service website: https://monolytics.app/
Privacy policy: https://monolytics.app/privacy_policy
Terms of use: https://monolytics.app/terms_of_use

== Installation ==

1. Upload the plugin zip through the WordPress plugin installer, or install it from the WordPress.org plugin directory once it is published.
2. Activate `Monolytics`.
3. Open `Monolytics` in the WordPress admin sidebar.
4. Click `Connect Monolytics`.
5. Complete the Monolytics login, signup, or Google auth flow.
6. Return to WordPress and confirm the connected status.

== Screenshots ==

1. The disconnected Monolytics plugin page in `wp-admin` with `Connect Monolytics` as the primary call to action.
2. The connected Monolytics plugin page in `wp-admin` with connection status, DataLayer tracking state, sessions tracked, and dashboard handoff.

== Frequently Asked Questions ==

= Do I need a Monolytics account? =

Yes. The plugin uses a Monolytics-hosted connect flow. You can either log into an existing account or create one during setup.

= Does the plugin track all of wp-admin? =

No. The plugin is designed to avoid globally tracking the WordPress admin area by default.

= Does disconnecting or uninstalling the plugin delete my Monolytics domain? =

No. Disconnecting or uninstalling removes the local WordPress-side connection state and stops local tracker injection, but it does not delete the remote Monolytics domain or historical analytics data.

== Changelog ==

= 1.1.3 =

* See the GitHub release notes or `CHANGELOG.md` for the full list of changes in this version.

= 1.1.2 =

* See the GitHub release notes or `CHANGELOG.md` for the full list of changes in this version.

= 1.1.1 =

* See the GitHub release notes or `CHANGELOG.md` for the full list of changes in this version.

== Upgrade Notice ==

= 1.1.3 =

Review the latest GitHub release notes before upgrading.