=== GA Google Analytics Pro ===

Plugin Name: GA Google Analytics Pro
Plugin URI: https://plugin-planet.com/ga-google-analytics-pro/
Description: Adds GA Tracking to your WordPress site. Pro version features opt-out box, multiple trackers, code previews and more.
Tags: analytics, ga, google, google analytics, tracking, statistics, stats
Author: Jeff Starr
Author URI: https://plugin-planet.com/
Donate link: https://monzillamedia.com/donate.html
Contributors: specialk
Requires at least: 4.1
Tested up to: 5.8
Stable tag: 2.1
Version: 2.1
Requires PHP: 5.6.20
Text Domain: ga-google-analytics-pro
Domain Path: /languages
License: The GA Google Analytics Pro license is comprised of two parts (see "License" section below for details)



Adds GA Tracking to your WordPress site. Pro version features opt-out box, multiple trackers, code previews and more.



== Description ==

> Super easy, lightweight and flexible
> Connects WordPress to your Google Analytics account

GA Pro makes it easy to enable Analytics Tracking on your WordPress site. Simply enter your Tracking ID and done. Lightweight and fast with lots of great options and exclusive pro features.

> Connects Google Analytics to WordPress
> Supports Universal Analytics / analytics.js
> Supports Global Site Tag / gtag.js
> Supports Google Analytics 4


### GA Tracking Options ###

* [Universal Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) / analytics.js
* [Global Site Tag](https://developers.google.com/analytics/devguides/collection/gtagjs/) / gtag.js
* [Legacy](https://developers.google.com/analytics/devguides/collection/gajs/) / ga.js

To enable __Google Analytics 4__: 

1. Follow [this guide](https://support.google.com/analytics/answer/9306384) to create a GA 4 account
2. During account creation, you'll get a tracking (measurement) ID
3. Add your new tracking ID to the plugin setting, "GA Tracking ID"
4. Select "Global Site Tag" for the plugin setting, "Tracking Method"

Save changes and done. Wait 24-48 hours before viewing collected data in your GA account. Note: this information also is available at [Plugin Planet](https://plugin-planet.com/ga-pro-enable-google-analytics-4/).


### GA Feature Support ###

* Supports [Google Analytics 4](https://support.google.com/analytics/answer/9306384)
* Supports [Display Advertising](https://support.google.com/analytics/answer/2444872)
* Supports [Enhanced Link Attribution](https://developers.google.com/analytics/devguides/collection/analyticsjs/enhanced-link-attribution)
* Supports [IP Anonymization](https://developers.google.com/analytics/devguides/collection/analyticsjs/ip-anonymization)
* Supports [Force SSL](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#forceSSL)
* Supports [Tracker Objects](https://developers.google.com/analytics/devguides/collection/analyticsjs/creating-trackers)
* Supports [Google Optimize](https://support.google.com/optimize/answer/6262084)
* Supports [User Opt-Out](https://developers.google.com/analytics/devguides/collection/analyticsjs/user-opt-out)

Plus with the plugin's Custom Code options, it is possible to implement just about any Analytics feature, for example [tracking outbound links with gtag.js](https://support.google.com/analytics/answer/7478520) and many others. Learn more about [Google Analytics](https://www.google.com/analytics/)!


### Features ###

* Blazing fast performance
* Does one thing and does it well
* Drop-dead simple and easy to use
* Regularly updated and "future proof"
* Stays current with the latest tracking code
* Includes tracking code in header or footer
* Includes tracking code on all WordPress web pages
* Includes option to add your own custom markup
* Sleek plugin Settings page with toggling panels
* Option to disable tracking of admin-level users
* Option to enable page tracking in the Admin Area
* Works with or without Gutenberg Block Editor
* Easy to customize the tracking code


### Pro Features ###

* Option to add an Opt-Out Box for visitors
* Add multiple tracking codes to any post IDs
* Provides live preview of each tracking code
* Stays current with the latest tracking code
* Enable tracking on specific posts and pages
* Enable tracking on Admin Area and/or frontend
* Enable tracking on the WordPress Login Page
* Include tracking code in page header or footer
* Includes option to add your own custom markup
* Sleek tabbed interface on plugin Settings page
* Option to disable tracking of admin-level users
* Option to disable tracking for logged-in users
* Supports many GA tracking features (see below)

This plugin is built with care and attention to detail:

* Built with the WP API
* Blazing fast performance
* Drop-dead simple and easy to use
* Regularly updated and "future proof"

__Note:__ This plugin adds the required GA tracking code to your web pages. To view your site statistics, visit your Google Analytics account.


### Opt-Out Box ###

GA Pro provides opt-out functionality for Google Analytics. You can show a banner to your users automatically, or you can use the following shortcode in any of your posts: 

	[ga_pro_optout]

To try this method, simply enable it in under the "Opt Out" tab in the plugin settings. Then view your site on the front-end, you will see the Opt-Out Box. To learn more about how this works, visit the Help tab in the plugin settings.


### More Information ###

Visit the [GA Pro Homepage](https://plugin-planet.com/ga-google-analytics-pro/) for features, screenshots, and details. For complete documentation, visit the Help tab on the plugin settings screen in the WP Admin Area.


### Getting Started ###

Check out the Quick Start Guide:

* [GA Pro Quick-Start Guide](https://plugin-planet.com/google-analytics-pro-quick-start/)


### Documentation ###

GA Pro documentation:

* [GA Pro Settings](https://plugin-planet.com/google-analytics-pro-settings/)


### Resources ###

Further resources and information:

* [GA Pro Docs](https://plugin-planet.com/docs/ga-google-analytics/)
* [GA Pro Forum](https://plugin-planet.com/forum/ga-google-analytics/)
* [GA Pro Tutorials](https://plugin-planet.com/category/tuts+ga-pro/)
* [GA Pro FAQs](https://plugin-planet.com/google-analytics-pro-faqs/)


### Stay Current ###

Stay current with Google Analytics Pro!

* [GA Pro News](https://plugin-planet.com/category/news+ga-pro/)
* [Grab the News Feed](https://plugin-planet.com/category/news/feed/)
* [Grab the Tutorials Feed](https://plugin-planet.com/category/tuts/feed/)


### Getting Help ###

There are two channels for getting help:

* [Ask a question in the GA Pro Forum](https://plugin-planet.com/forum/ga-google-analytics/) ([login required](https://plugin-planet.com/wp/wp-login.php))
* [Send an email via the contact form](https://plugin-planet.com/ga-google-analytics-pro/#contact)

The contact form is best for direct support, bug reports, and feedback.


### Downloads ###

To download the plugin at any time, [log in to your account](https://plugin-planet.com/wp/wp-login.php).

To learn more about GA Google Analytics Pro, visit [Plugin-Planet.com](https://plugin-planet.com/ga-google-analytics-pro/).

For complete documentation, visit the Help tab on the plugin settings screen in the WP Admin Area. 


### Cookie Use ###

When enabled, this plugin sets a few small/simple cookies in the visitor's web browser. This enables the Opt-Out Box to work its magic.


### Privacy ###

__User Data:__ This plugin does not collect any user data. Even so, the tracking code added by this plugin is used by Google to collect all sorts of user data. You can learn more about Google Privacy [here](https://policies.google.com/privacy?hl=en-US).

__Cookies:__ This plugin uses simple cookies for the visitor Opt-Out Box to remember user preference for opt-in or out of Google Analytics.

__Services:__ This plugin does not connect to any third-party locations or services, but it does enable Google to collect all sorts of data.



== Installation ==

### How to install the plugin ###

1. Upload the plugin and activate via the WP Plugins screen
2. Visit GA Pro &gt; License to enter your license
3. Visit the settings to configure your options

Done. GA Pro is now ready for use. 

_For complete documentation, visit the Help tab on the plugin settings screen in the WP Admin Area._

__Note:__ this plugin adds the required GA code to your web pages. In order for the code to do anything, it must correspond to an active, properly configured Google Analytics account. Learn more at the [Google Analytics Help Center](https://support.google.com/analytics/?hl=en#topic=3544906).

__Tip:__ After configuring your settings, you can verify that GA tracking code is included by viewing the source code of your web pages.

[More info on installing WP plugins](https://wordpress.org/support/article/managing-plugins/#installing-plugins).


### How to use the plugin ###

To enable Google Analytics tracking on your site, follow these steps:

1. Visit GA Pro settings (Configure tab)
2. Enter your GA Tracking ID
3. Choose either [Universal Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) or [Global Site Tag](https://developers.google.com/analytics/devguides/collection/gtagjs/)*
4. Configure any other plugin settings as desired (optional)

Done! Google Analytics is now enabled on your front-end pages. After 24-48 hours, you can log into your Google Analytics account to view collected data and statistics.

Further options are available for customizing your tracking code, adding multiple trackers, displaying the Opt-Out Box, and more. For more information, visit the Help tab on the GA Pro settings screen.


__Notes:__ 

Global Site Tag is required for Google Analytics 4. For steps on setting up GA 4, check out the [plugin homepage](https://wordpress.org/plugins/ga-google-analytics/) (under "GA Tracking Options").

This plugin adds the required GA code to your web pages. In order for the code to do anything, it must correspond to an active, properly configured Google Analytics account. Learn more at the [Google Analytics Help Center](https://support.google.com/analytics/?hl=en#topic=3544906).

__Tip:__ that it can take 24-48 hours after adding the tracking code before any analytical data appears in your [Google Analytics account](https://developers.google.com/analytics/). To check that the GA tacking code is included, look at the source code of your web page(s). Learn more at the [Google Analytics Help Center](https://support.google.com/analytics/?hl=en#topic=3544906).


### Upgrading Analytics ###

Google Analytics tracking methods change over time. First there was `urchin.js`, then `ga.js`, and now `analytics.js`, soon to be replaced officially by `gtag.js`. If you are using an older version and want to upgrade, check out these Google docs:

* [Universal Analytics Upgrade Center](https://developers.google.com/analytics/devguides/collection/upgrade/)
* [Migrate from analytics.js to gtag.js](https://developers.google.com/analytics/devguides/collection/gtagjs/migration)


### Plugin Upgrades ###

Your purchase of GA Google Analytics Pro includes free lifetime upgrades, which include new features, bug fixes, and other improvements. When an upgrade is available, WordPress will notify you in the Admin Area. When you see that there is an update available, just click "Update" and WordPress will perform the upgrade automatically. Note that you can [download the latest version of GA Pro at Plugin Planet](https://plugin-planet.com/download-purchased-plugin/) anytime at your convenience.

__Note:__ uninstalling the plugin from the WP Plugins screen results in the removal of all plugin options and data from the WP database.

__Tip:__ you can [download the latest version of GA Pro](https://plugin-planet.com/download-purchased-plugin/) anytime at your convenience.

For more information, visit the [GA Pro Homepage](https://plugin-planet.com/ga-google-analytics-pro/).


### Restore Default Options ###

To restore default plugin options, either uninstall/reinstall the plugin, or visit "Reset Options" in the plugin settings &gt; Advanced tab.


### Uninstalling ###

GA Pro cleans up after itself. All plugin settings will be removed from your database when the plugin is uninstalled via the Plugins screen. Your collected GA data will remain in your Google account.


### License Information ###

Resources for managing your license:

* [Download purchased plugin](https://plugin-planet.com/download-purchased-plugin/)
* [Install purchased plugin](https://plugin-planet.com/install-plugin/)
* [Upgrade purchased plugin](https://plugin-planet.com/upgrade-plugin/)
* [Get plugin license key](https://plugin-planet.com/get-license-key/)
* [Activate plugin license](https://plugin-planet.com/activate-deactivate-plugin-license/)
* [Transfer plugin license](https://plugin-planet.com/transfer-plugin-license/)
* [Manage licensed domains](https://plugin-planet.com/manage-license/)
* [Download purchase receipt](https://plugin-planet.com/download-purchase-receipt/)
* [Troubleshooting license activation](https://plugin-planet.com/troubleshooting-license-activation/)


### Like the plugin? ###

If you like GA Pro, please take a moment to [give a 5-star rating](https://wordpress.org/support/plugin/ga-google-analytics/reviews/?rate=5#new-post). It helps to keep development and support going strong. Thank you!



== Upgrade Notice ==

This plugin has been tested and is 100% current with the latest version of WordPress.



== Frequently Asked Questions ==

Check out the [GA Pro FAQs](https://plugin-planet.com/google-analytics-pro-faqs/) at Plugin Planet.


### Questions? Feedback? Bugs? ###

There are two channels for getting help:

* [Ask a question in the GA Pro Forum](https://plugin-planet.com/forum/ga-google-analytics/) ([login required](https://plugin-planet.com/wp/wp-login.php))
* [Send an email via the contact form](https://plugin-planet.com/ga-google-analytics-pro/#contact)

The contact form is best for direct support, bug reports, and feedback.



== Screenshots ==

Screenshots and more available at [Plugin-Planet.com](https://plugin-planet.com/ga-google-analytics-pro/#screenshots).



== License ==

License: The GA Google Analytics Pro license comprises two parts:

* __Part 1:__ Its PHP code is licensed under the GPL (v3 or later), like WordPress. [More info](https://www.gnu.org/licenses/).
* __Part 2:__ Everything else (e.g., CSS, HTML, JavaScript, images, design) is licensed according to the purchased license. [More info](https://plugin-planet.com/ga-google-analytics-pro/).

Without prior written consent from Monzilla Media, you must NOT directly or indirectly: license, sub-license, sell, resell, or provide for free any aspect or component of Part 2.

Further license information is available in the plugin directory, `/license/`, and [online](https://plugin-planet.com/wp/files/ga-google-analytics-pro/license.txt).

__Upgrades:__ Your purchase of GA Google Analytics Pro includes free lifetime upgrades, which include new features, bug fixes, and other improvements. 

Copyright 2021 Monzilla Media. All rights reserved.



== Thank You ==

Thank You to Jennifer Starr for her insight and help with testing and usability.



== Check out my other plugins ==

Free WordPress plugins:

* [Banhammer](https://wordpress.org/plugins/banhammer/)
* [Host Header Injection Fix](https://wordpress.org/plugins/host-header-injection-fix/)
* [Blackhole for Bad Bots](https://wordpress.org/plugins/blackhole-bad-bots/)
* [BBQ Firewall](https://wordpress.org/plugins/block-bad-queries/)
* [Contact Coldform](https://wordpress.org/plugins/contact-coldform/)
* [Dashboard Widgets Suite](https://wordpress.org/plugins/dashboard-widgets-suite/)
* [GA Google Analytics](https://wordpress.org/plugins/ga-google-analytics/)
* [Head Meta Data](https://wordpress.org/plugins/head-meta-data/)
* [Show Support Ribbon](https://wordpress.org/plugins/show-support-ribbon/)
* [Simple Ajax Chat](https://wordpress.org/plugins/simple-ajax-chat/)
* [Simple Basic Contact Form](https://wordpress.org/plugins/simple-basic-contact-form/)
* [Simple Blog Stats](https://wordpress.org/plugins/simple-blog-stats/)
* [Simple Custom Content](https://wordpress.org/plugins/simple-custom-content/)
* [Simple Feed Stats](https://wordpress.org/plugins/simple-feed-stats/)
* [User Submitted Posts](https://wordpress.org/plugins/user-submitted-posts/)
* [Theme Switcha](https://wordpress.org/plugins/theme-switcha/)
* [Prismatic](https://wordpress.org/plugins/prismatic/)

Premium WordPress plugins:

* [Banhammer Pro](https://plugin-planet.com/banhammer-pro/)    - Monitor traffic and ban bad users and bots
* [BBQ Pro](https://plugin-planet.com/bbq-pro/)                - Fastest firewall plugin for WordPress
* [Blackhole Pro](https://plugin-planet.com/blackhole-pro/)    - Block bad bots in a virtual black hole
* [GA Pro](https://plugin-planet.com/ga-google-analytics-pro/) - Connect WordPress to Google Analytics
* [SES Pro](https://plugin-planet.com/ses-pro/)                - Ajax-powered email signup forms
* [USP Pro](https://plugin-planet.com/usp-pro/)                - Advanced front-end forms

More PRO plugins in the works :)



== Changelog ==

If you like GA Pro, please take a moment to [give a 5-star rating](https://wordpress.org/support/plugin/ga-google-analytics/reviews/?rate=5#new-post). It helps to keep development and support going strong. Thank you!


**2.1 (2021/07/25)**

* Adds three more sets of Custom Code options
* Generates new default translation template
* Improves readme/documentation
* Tests on WordPress 5.8

**2.0 (2021/02/16)**

* Improves readme.txt/documentation
* Tests on PHP 7.4 and 8.0
* Tests on WordPress 5.7

**1.9 (2020/11/29)**

* Supports Google Analytics 4
* Updates readme/docs with GA 4 infos
* Updates script to account for changes in jQuery UI
* Improves appearance of plugin settings screen
* Adds credit line to primary tracking output
* Updates Help tab with more information
* Updates default translation template
* Updates license updater script
* Tests on PHP 7.4 and 8.0
* Tests on WordPress 5.6

**1.8 (2020/08/20)**

* Adds function to display short URL in source code
* Adds filter hook `gapro_script_atts`
* Adds filter hook `gapro_script_atts_ext`
* Adds return error if user enters `GTM-` tracking code
* Adds French translation (Thanks to Hervé Bouzin)
* Updates contextual Help tab information
* Updates default translation template
* Refines plugin setting page styles
* Updates license updater script
* Refines readme/documentation
* Tests on WordPress 5.5

**1.7 (2020/03/30)**

* Adds option to display tracking after opening body tag
* Adds filter hook `ga_google_analytics_options_array`
* Adds filter hook `ga_google_analytics_enable_auto`
* Improves security of opt-out cookies
* Generates new default translation template
* Tests on WordPress 5.4

**1.6 (2019/11/20)**

* Adds option to not track until user opts in
* Tightens output of tracking code
* Improves sanitization of plugin options
* Updates styles for plugin settings page
* Generates new default translation template
* Tests on WordPress 5.3

**1.5 (2019/09/08)**

* Updates some links to https
* Updates information on plugin page
* Updates some resource URLs
* Changes order of custom code output
* Improves output of GA tracking markup
* Generates new default translation template
* Tests on WordPress 5.3 (alpha)

**1.4 (2019/05/02)**

* Bumps [minimum PHP version](https://codex.wordpress.org/Template:Server_requirements) to 5.6.20
* Updates default translation template
* Tests on WordPress 5.2

**1.3 (2019/04/03)**

* Fixes bug with plugin settings UI
* Fixes incorrect markup for lists in Help tab
* Updates Link Attribution for analytics.js
* Removes FA `.eot` custom font format
* Tests on WordPress 5.1 and 5.2 (alpha)

**1.2 (2019/03/21)**

* Adds new toggle shortcode `[gapro_optout_toggle]`
* Adds `action` attribute to plain-link shortcodes
* Adds new filter hook `ga_google_analytics_pro_toggle_title1`
* Adds new filter hook `ga_google_analytics_pro_toggle_title2`
* Fixes bug with JavaScript not loaded for shortcodes
* Improves default plugin options
* Improves escaping of shortcode output
* Improves display of plugin License screen
* Improves functionality for one-click plugin updates
* Adds check for admin user for settings shortcut link
* Refines plugin settings screen UI
* Generates new default translation template
* Tests on WordPress 5.1 and 5.2 (alpha)

**1.1 (2019/03/20)**

* Adds shortcode `[gapro_optin]`
* Adds shortcode `[gapro_optout]`
* Adds Opt-Out Box option for custom CSS
* Adds filter hook `ga_google_analytics_pro_optin_plain`
* Adds filter hook `ga_google_analytics_pro_optin_plain_title`
* Adds filter hook `ga_google_analytics_pro_optout_plain`
* Adds filter hook `ga_google_analytics_pro_optout_plain_title`
* Custom GA code now output before any calls to `ga()` or `gtag()`
* Renames `ga_google_analytics_pro_optout_title` to `ga_google_analytics_pro_optin_title`
* Fixes bug where "Disable Stylesheet" setting affecting JavaScript
* Fixes bug with non-clickable links
* Updates contextual help information
* Fine-tunes the plugin settings and Help infos
* Expands library of "more from author" section
* Replaces "gear" icon with official GA Pro icon
* Refines CSS and JS for frontend Opt-Out Box
* Generates new default translation template
* Tests on WordPress 5.1 + 5.2 (alpha)

**1.0 (2019/02/14)**

* Initial release
