=== ShopLens Analytics ===
Tags: analytics, privacy, woocommerce, traffic, statistics
Requires at least: 6.2
Requires PHP: 7.4
Stable tag: 0.10.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds ShopLens tracking and optional WooCommerce events after an administrator-approved connection.

== Description ==

ShopLens Analytics is an installable plugin distributed directly by
ShopLens. It is not currently listed in the WordPress.org plugin directory.

After a WordPress administrator approves a connection in a separate, top-level
ShopLens page, the plugin stores the public ShopLens site ID in WordPress and
adds the ShopLens tracker to public pages. ShopLens does not receive your
WordPress password or administrator session cookie.

The base tracker records pageviews. When WooCommerce is active, the plugin also
reports explicit cart, checkout, and paid-order confirmation events. The paid
order event includes WooCommerce's reported order total, currency, and an
internal order ID used for deduplication. Later refunds and cancellations are
not reconciled automatically.

ShopLens does not set analytics cookies. That fact alone does not decide your
consent, disclosure, or regulatory duties. Those depend on your jurisdiction,
site configuration, and other tools.

== Installation ==

1. In WordPress, open Plugins -> Add New Plugin -> Upload Plugin.
2. Upload the ShopLens ZIP, install it, and activate ShopLens Analytics.
3. Open Settings -> ShopLens and click Connect to ShopLens.
4. Log in or create a ShopLens account, return to WordPress if needed, and
   approve the displayed connection. Reinstalling or reconnecting can require
   approval again.
5. Visit the public site in a private window and confirm that the known visit
   appears in ShopLens. A saved site ID by itself is not verification.

The guided connection requires an HTTPS WordPress site. An administrator of an
HTTP-only or otherwise unsupported installation can use ShopLens' documented
manual script placement instead.

== External services ==

This plugin connects to ShopLens, an external analytics service operated by OA
Systems at https://shoplens.io.

Nothing is sent until a WordPress administrator connects the plugin. After
connection, public pages load https://shoplens.io/lens.js and the visitor's
browser sends analytics requests to https://shoplens.io/api/e. Requests can
include the public ShopLens site ID, event type, current path, referrer URL,
screen width, UTM values, browser user agent, and network IP address. ShopLens
uses the IP address and user agent to produce a daily-changing visitor hash.

On WooCommerce sites, explicit events can also include cart/checkout activity
and, on a paid order confirmation page, the order total, currency, and internal
WooCommerce order ID. The plugin does not intentionally send a customer name,
email, address, or payment details. Avoid placing personal or sensitive data in
URL paths or campaign values.

Service terms: https://shoplens.io/terms
Privacy policy: https://shoplens.io/privacy
Support: mailto:oasystems01@gmail.com

== Frequently Asked Questions ==

= Is installation automatic? =

No. An administrator uploads and activates the plugin, then approves the
displayed connection in ShopLens. The plugin places the tracker after that
approval. Reinstalling or reconnecting can require approval again. The dashboard
verifies setup only after an accepted public pageview arrives.

= Does ShopLens require a cookie banner? =

ShopLens does not set analytics cookies, but the plugin does not make a legal
determination about your site. Review your jurisdiction, configuration, other
tools, and privacy disclosures.

= What should I check if the test visit does not appear? =

Clear any WordPress page cache, plugin cache, and CDN cache, then retry from a
private window. If the site uses Content Security Policy, allow
https://shoplens.io in both script-src and connect-src. Browser privacy tools
and network filters can still block the script or analytics request.

= What WooCommerce value is recorded? =

For orders WooCommerce marks paid, the confirmation page reports the order
total, currency, and an internal order ID for deduplication. ShopLens does not
automatically reconcile later refunds, cancellations, taxes, fees, or payouts,
so this is not an accounting ledger.

= Does deactivation delete my ShopLens data? =

No. Disconnecting or uninstalling stops this WordPress site from loading the
tracker. Existing ShopLens data remains until the account owner deletes the
website or account in ShopLens.

== Changelog ==

= 0.10.0 =
* Include verified-site credentials in tracker requests so browser collection remains bound to the approved WordPress domain.

= 0.9.1 =
* Queue WooCommerce add-to-cart events safely while the ShopLens tracker is still loading or unavailable.

= 0.9.0 =
* Initial direct-download package with administrator-approved connection.
* Base pageview tracking and explicit WooCommerce cart, checkout, and paid-order events.
* Honest configuration-versus-verification status and external-service disclosure.
