readme.txt

=== Simple Analytics ===

Contributors: simpleanalytics
Donate link: https://simpleanalytics.com
Tags: privacy-first, privacy-friendly, free analytics, website analytics, simple analytics, analytics, statistics, website traffic, traffic monitoring
Requires at least: 7.0.6
Tested up to: 7.1.3
Requires PHP: 7.4.0
Stable tag: 1.113
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Simple, free, and privacy-friendly website analytics

https://vimeo.com/1033359807/dde00e7f39

== Description ==

Simple Analytics gives you the analytics you need without invading the privacy of your users, with a clean interface and simple integration.

1.  **Privacy-friendly by design**: Simple Analytics is built with privacy in mind. Get the insights you need while respecting your users’ privacy.
2.  **Simple interface**: Google Analytics is a monstrosity of custom dashboards and features. At Simple Analytics, we provide the insights you need in a clear and straightforward interface.
3.  **No cookiebanner required**. Simple Analytics does not use cookies or any other identifiers, meaning you don’t need to add an annoying cookiebanner to your website. You can use Simple Analytics without the need for consent.
4.  **GDPR-compliant**. Simple Analytics is GDPR-compliant and out-of-the-box since we don’t collect, store, or process personally identifiable information.
5.  **Easy integration**. Simple Analytics is easy to install. You can use our WordPress plugin to get started right away. It’s also possible to import your historical Google Analytics traffic so you don’t lose any data switching to Simple Analytics.
6.  **It’s free**. Simple Analytics has a free option to get started. There is a 14-day free trial to explore our paid features. However, you can use Simple Analytics for free forever if you like.

Check our [live demo](https://dashboard.simpleanalytics.com/simpleanalytics.com)

Simple Analytics is entirely self-funded and proudly supported by our 18500+ users. We don't sell your data, we don't do ads, and we don't have investors that tell us what to do. We're here to build a product that you love.

Use it for free as long as you need, or if you're happy, consider one of our paid options for more features and more data history.

== Features ==

**Events**
-   Event Tracking: Monitor specific user interactions that are not captured by standard page views, such as button clicks, form submissions, or video plays.

![The Events Explorer](https://assets.simpleanalytics.com/plugins/wordpress/event-explorer.png)

**Goals**
-   Goal Tracking: Set specific goals to monitor user interactions on your website, such as conversions or engagement metrics.
-   Goal Cards: Visual representations of your goals that allow for quick performance assessments.
-   Custom Filters: Create filters to refine the data associated with each goal, making it easier to analyze specific user behaviors.

![Goals dashboard](https://assets.simpleanalytics.com/plugins/wordpress/goals.png)

**Ai Analytics**
-   Chat with your analytics to generate custom insights and dashboards.

https://vimeo.com/1033359881/7e93b527ab

**Custom Views**
-   Permanent Filters: Establish permanent filters on your dashboard to focus on specific data sets.
-   Multi-Domain Merging: Combine data from multiple domains into a single dashboard for a comprehensive overview.
-   Access Control: Share limited views of your analytics data with team members or stakeholders.

**Filters**
-   Data Filtering: Apply filters to exclude certain traffic sources or user behaviors, allowing for cleaner, more relevant data analysis.

**Export Your Data**
-   Data Export Options: Easily export your analytics data in various formats for further analysis or reporting.

**Import Google Analytics Data**
-   Data Migration: Import historical data from Google Analytics to maintain continuity in your analytics tracking.

**Email Reports**
-   Automated Reporting: Set up automated email reports to receive regular updates on your website’s performance metrics.

**Bypass Ad-Blockers**
-   Ad-Blocker Resilience: The tracking script is designed to bypass common ad-blockers, ensuring that you capture more accurate visitor data.

**Robot Blocking**
-   Bot Traffic Management: Automatically block known bots from skewing your analytics data, leading to more reliable insights.

**Hide Referral SPAM**
-   Spam Filtering: Filter out referral spam to ensure that your analytics data reflects genuine user interactions.

**Embed Chart on Your Site**
-   Data Visualization: Embed analytics charts directly on your website for live data displays, enhancing transparency.

**Trend Lines**
-   Performance Tracking: Utilize trend lines in your analytics to visualize performance over time, aiding in identifying patterns and forecasting.

**Annotations**
-   Event Marking: Add annotations to your data to mark significant events or changes, providing context for fluctuations in your analytics.

**Block Your Visits Extension**
-   Personal Visit Exclusion: Use an extension to block your own visits from being tracked, ensuring that your analytics reflect genuine user activity.

**iOS App**
-   Mobile Access: Access your analytics data on the go with a dedicated iOS app, allowing for real-time insights wherever you are.

== Installation ==

Installing "Simple Analytics" can be done in multiple ways.

= Install via WordPress Plugins =

1. Search for `simpleanalytics` plugin in your WordPress admin
1. Upload the ZIP file through the 'Plugins > Add New > Upload' screen in your WordPress dashboard
1. Activate the plugin through the 'Plugins' menu in WordPress

= Download the ZIP via WordPress.org =

1. Download the plugin via [wordpress.org/plugins/simpleanalytics](https://wordpress.org/plugins/simpleanalytics/)
1. Upload the ZIP file through the 'Plugins > Add New > Upload' screen in your WordPress dashboard
1. Activate the plugin through the 'Plugins' menu in WordPress

= Download the ZIP via GitHub =

1. Download the plugin via [github.com/simpleanalytics/wordpress-plugin](https://github.com/simpleanalytics/wordpress-plugin/releases)
1. Upload the ZIP file through the 'Plugins > Add New > Upload' screen in your WordPress dashboard
1. Activate the plugin through the 'Plugins' menu in WordPress

== Frequently Asked Questions ==

= Is Simple Analytics free? =

Yes. You can use Simple Analytics for free forever. You only need to create an account at [Simple Analytics](https://simpleanalytics.com/?ref=wordpress).

= Where can I see my dashboard? =

You can [see your dashboard here](https://simpleanalytics.com/websites?ref=wordpress).

= Where can I find the documentation and features? =

See our [documentation here](https://docs.simpleanalytics.com/?ref=wordpress).

= Where can I leave feedback? =

You can [leave your feedback here](https://simpleanalytics.com/feedback?ref=wordpress).

== Upgrade Notice ==

No changes needed for upgrades.

== Changelog ==

= 1.113 =
* 2026-10-12
* Tested up to WordPress 7.1.3
* Requires WordPress 7.0.6
* Requires PHP 7.4.0


= 1.112 =
* 2026-09-28
* Tested up to WordPress 7.1.2
* Requires WordPress 7.0.5
* Requires PHP 7.4.0


= 1.111 =
* 2026-09-21
* Tested up to WordPress 7.1.1
* Requires WordPress 7.0.4
* Requires PHP 7.4.0


= 1.110 =
* 2026-09-16
* Tested up to WordPress 7.1
* Requires WordPress 7.0.3
* Requires PHP 7.4.0
* Changes:
* Use release app client ID (#53)
* Use release app for protected branch updates (#52)
* Execute the configured analytics load callback safely (#47)
* Preserve IP exclusions on their first save (#44)
* Preserve settings until the plugin is uninstalled (#45)
* Respect both states of automated event settings (#43)
* Fix manual pageview collection setting (#42)
* Update wp-env to fix PHP 7.4 CI (#49)


= 1.109 =
* 2026-07-20
* Tested up to WordPress 7.0.2
* Requires WordPress 6.9.4
* Requires PHP 7.2.0


= 1.108 =
* 2026-07-13
* Tested up to WordPress 7.0.1
* Requires WordPress 6.9.3
* Requires PHP 7.2.0


= 1.107 =
* 2026-06-18
* Changes:
* Improve General tab guidance and move custom domain to Advanced. (#35)
* Add wordpress platform marker to script tag (#30)
* Fix missing REMOTE_ADDR fallback in tracking rules. (#33)
* Clarify script injection behavior and stabilize browser coverage. (#32)
* Improve e2e workflow reliability (#31)
* Fix flaky / failing tests. (#29)
* hotfix: styles not loading (#27)
* Update README.md to remove paid sub requirement [no ci]


= 1.106 =
* 2026-05-20
* Tested up to WordPress 7.0
* Requires WordPress 6.9.3
* Requires PHP 7.2.0
* Changes:
* Update release versions (#26)
* Fix E2E tests stability (#23)


= 1.105 =
* 2026-04-27
* Changes:
* Update GitHub actions to latest major versions (#22) [no ci]
* Release 1.104: Code updates


= 1.104 =
* 2026-04-13
* Changes:
* Automated browser tests (#12)
* Release 1.103: Code updates


= 1.103 =
* 2026-04-06
* Changes:
* Release 1.102: Code updates


= 1.102 =
* 2026-03-30
* Changes:
* Release 1.101: Code updates


= 1.101 =
* 2026-03-23
* Changes:
* Release 1.100: Code updates and support for WordPress 6.9.4


= 1.100 =
* 2026-03-16
* Tested up to WordPress 6.9.4
* Changes:
* Release 1.99: Code updates


= 1.99 =
* 2026-03-09
* Changes:
* Release 1.98: Code updates


= 1.98 =
* 2026-03-02
* Changes:
* Release 1.97: Code updates


= 1.97 =
* 2026-02-23
* Changes:
* Release 1.96: Code updates


= 1.96 =
* 2026-02-16
* Changes:
* Release 1.95: Code updates and support for WordPress 6.9.1


= 1.95 =
* 2026-02-09
* Tested up to WordPress 6.9.1
* Changes:
* Release 1.94: Code updates


= 1.94 =
* 2026-02-02
* Changes:
* Release 1.93: Code updates


= 1.93 =
* 2026-01-26
* Changes:
* Release 1.92: Code updates


= 1.92 =
* 2026-01-19
* Changes:
* Release 1.91: Code updates


= 1.91 =
* 2026-01-12
* Changes:
* Release 1.90: Code updates


= 1.90 =
* 2026-01-05
* Changes:
* Release 1.89: Code updates


= 1.89 =
* 2025-12-29
* Changes:
* Release 1.88: Code updates


= 1.88 =
* 2025-12-22
* Changes:
* Release 1.87: Code updates


= 1.87 =
* 2025-12-15
* Changes:
* Release 1.86: Code updates and support for WordPress 6.9


= 1.86 =
* 2025-12-08
* Tested up to WordPress 6.9
* Changes:
* Release 1.85: Code updates


= 1.85 =
* 2025-12-01
* Changes:
* Release 1.84: Code updates


= 1.84 =
* 2025-11-24
* Changes:
* Release 1.83: Code updates


= 1.83 =
* 2025-11-17
* Changes:
* Release 1.82: Code updates


= 1.82 =
* 2025-11-10
* Changes:
* Release 1.81: Code updates


= 1.81 =
* 2025-11-03
* Changes:
* Release 1.80: Code updates


= 1.80 =
* 2025-10-27
* Changes:
* Release 1.79: Code updates


= 1.79 =
* 2025-10-20
* Changes:
* Release 1.78: Code updates


= 1.78 =
* 2025-10-13
* Changes:
* Release 1.77: Code updates and support for WordPress 6.8.3


= 1.77 =
* 2025-10-06
* Tested up to WordPress 6.8.3
* Changes:
* Release 1.76: Code updates


= 1.76 =
* 2025-09-29
* Changes:
* Release 1.75: Code updates


= 1.75 =
* 2025-09-22
* Changes:
* Release 1.74: Code updates


= 1.74 =
* 2025-09-15
* Changes:
* Release 1.73: Code updates


= 1.73 =
* 2025-09-08
* Changes:
* Release 1.72: Code updates


= 1.72 =
* 2025-09-01
* Changes:
* Release 1.71: Code updates


= 1.71 =
* 2025-08-25
* Changes:
* Release 1.70: Code updates


= 1.70 =
* 2025-08-18
* Changes:
* Release 1.69: Code updates


= 1.69 =
* 2025-08-11
* Changes:
* Release 1.68: Code updates


= 1.68 =
* 2025-08-06
* Changes:
* fix: Handle IP address absence
* Release 1.67: Code updates


= 1.67 =
* 2025-08-04
* Changes:
* Release 1.66: Code updates


= 1.66 =
* 2025-07-28
* Changes:
* Release 1.65: Code updates and support for WordPress 6.8.2


= 1.65 =
* 2025-07-21
* Tested up to WordPress 6.8.2
* Changes:
* Release 1.64: Code updates


= 1.64 =
* 2025-07-14
* Changes:
* Release 1.63: Code updates


= 1.63 =
* 2025-07-07
* Changes:
* Release 1.62: Code updates


= 1.62 =
* 2025-06-30
* Changes:
* Release 1.61: Code updates


= 1.61 =
* 2025-06-23
* Changes:
* Release 1.60: Code updates


= 1.60 =
* 2025-06-16
* Changes:
* Release 1.59: Code updates


= 1.59 =
* 2025-06-09
* Changes:
* Release 1.58: Code updates


= 1.58 =
* 2025-06-02
* Changes:
* Release 1.57: Code updates


= 1.57 =
* 2025-05-19
* Changes:
* Release 1.56: Code updates


= 1.56 =
* 2025-05-12
* Changes:
* Release 1.55: Code updates and support for WordPress 6.8.1


= 1.55 =
* 2025-05-05
* Tested up to WordPress 6.8.1
* Changes:
* Release 1.54: Code updates


= 1.54 =
* 2025-04-28
* Changes:
* Release 1.53: Code updates


= 1.53 =
* 2025-04-22
* Changes:
* Remove "Enabled" checkbox
* Release 1.52: Code updates and support for WordPress 6.8


= 1.52 =
* 2025-04-21
* Tested up to WordPress 6.8
* Changes:
* Release 1.51: Code updates


= 1.51 =
* 2025-04-14
* Changes:
* Release 1.50: Code updates


= 1.50 =
* 2025-04-07
* Changes:
* Release 1.49: Code updates


= 1.49 =
* 2025-03-31
* Changes:
* Release 1.48: Code updates


= 1.48 =
* 2025-03-24
* Changes:
* Release 1.47: Code updates


= 1.47 =
* 2025-03-17
* Changes:
* Release 1.46: Code updates


= 1.46 =
* 2025-03-10
* Changes:
* Release 1.45: Code updates


= 1.45 =
* 2025-03-03
* Changes:
* Release 1.44: Code updates


= 1.44 =
* 2025-02-24
* Changes:
* Release 1.43: Code updates and support for WordPress 6.7.2


= 1.43 =
* 2025-02-17
* Tested up to WordPress 6.7.2
* Changes:
* Release 1.42: Code updates


= 1.42 =
* 2025-02-10
* Changes:
* Release 1.41: Code updates


= 1.41 =
* 2025-02-03
* Changes:
* Release 1.40: Code updates


= 1.40 =
* 2025-01-28
* Changes:
* Use new 10up/action-wordpress-plugin-deploy version
* Release 1.39: Code updates


= 1.39 =
* 2025-01-28
* Changes:
* Add links to images and videos
* Update wordpress readme.txt
* Release 1.38: Code updates


= 1.38 =
* 2025-01-27
* Changes:
* Release 1.37: Code updates


= 1.37 =
* 2025-01-20
* Changes:
* Release 1.36: Code updates


= 1.36 =
* 2025-01-13
* Changes:
* Release 1.35: Code updates


= 1.35 =
* 2025-01-06
* Changes:
* Release 1.34: Code updates


= 1.34 =
* 2024-12-30
* Changes:
* Release 1.33: Code updates


= 1.33 =
* 2024-12-23
* Changes:
* Release 1.32: Code updates


= 1.32 =
* 2024-12-16
* Changes:
* Release 1.31: Code updates


= 1.31 =
* 2024-12-09
* Changes:
* Release 1.30: Code updates


= 1.30 =
* 2024-12-02
* Changes:
* Release 1.29: Code updates


= 1.29 =
* 2024-11-25
* Changes:
* Release 1.28: Code updates and support for WordPress 6.7.1


= 1.28 =
* 2024-11-21
* Tested up to WordPress 6.7.1
* Changes:
* Fix invalid changelog multiline format
* Fix invalid changelog format
* Run awk instead of sed to consistently run on mac and linux
* Run prettier to cleanup code
* Remove rebase in git pull
* Improve release.sh script and changelog
* Use changelog from release script
* Allow regualar commits
* Set the checkbox default in the UI when empty
* Fix boolean value default retrieval
* Update version to support WordPress 6.7


= 1.27 =
* 2024-11-18
* Upgraded to WordPress 6.7

= 1.26 =
* 2024-09-13
* Upgraded to WordPress 6.6.2

= 1.25 =
* 2024-07-30
* Upgraded to WordPress 6.6.1

= 1.24 =
* 2024-07-22
* Upgraded to WordPress 6.6

= 1.23 =
* 2024-07-01
* Upgraded to WordPress 6.5.5

= 1.22 =
* 2024-06-10
* Upgraded to WordPress 6.5.4

= 1.21 =
* 2024-05-13
* Upgraded to WordPress 6.5.3

= 1.20 =
* 2024-04-15
* Upgraded to WordPress 6.5.2

= 1.19 =
* 2024-04-08
* Upgraded to WordPress 6.5

= 1.18 =
* 2024-02-05
* Upgraded to WordPress 6.4.3

= 1.17 =
* 2023-12-11
* Upgraded to WordPress 6.4.2

= 1.16 =
* 2023-11-13
* Upgraded to WordPress 6.4.1

= 1.15 =
* 2023-10-16
* Upgraded to WordPress 6.3.2

= 1.14 =
* 2023-10-12
* Upgraded to WordPress 6.3.1

= 1.13 =
* 2023-07-17
* Allow custom domains (thanks to Ostap Brehin)

= 1.12 =
* 2023-07-05
* Upgraded to WordPress 6.2.2

= 1.11 =
* 2023-05-02
* Upgraded to WordPress 6.2

= 1.10 =
* 2023-01-07
* Upgraded to WordPress 6.1.1

= 1.9 =
* 2022-09-26
* Upgraded to WordPress 6.0.2

= 1.8 =
* 2022-06-27
* Fix for WordPress 6.0

= 1.7 =
* 2021-10-22
* Fix for WordPress 5.8.1

= 1.6 =
* 2020-12-07
* Test with latest WordPress version

= 1.5 =
* 2019-06-12
* Add assets and more

= 1.4 =
* 2019-06-12
* Use code how WordPress recommends it

= 1.3 =
* 2019-05-28
* Use wp_enqueue_script, init, and global $is_running var

= 1.2 =
* 2019-05-16
* Rename to "Simple Analytics Official Plugin"

= 1.1 =
* 2019-05-09
* Skip requests from admins

= 1.0 =
* 2019-05-09
* Initial release