=== 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.6 Tested up to: 6.4 Stable tag: 2.6 Version: 2.6 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 ### * [Google Tag](https://developers.google.com/analytics/devguides/collection/gtagjs/) / gtag.js * [Universal Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) / analytics.js * [Legacy](https://developers.google.com/analytics/devguides/collection/gajs/) / ga.js __Note:__ Google renamed "Global Site Tag" to "Google Tag". ### Enable Google Analytics 4 ### Follow these steps 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 "Google Tag" for the plugin setting, "Tracking Method" Save changes and done. Wait 24-48 hours before viewing collected data in your GA account. More info @ Plugin Planet: * [GA Pro - Enable Google Analytics 4](https://plugin-planet.com/ga-pro-enable-google-analytics-4/) * [GA Pro - Enable Google Analytics 4 ad Universal Tracking](https://plugin-planet.com/ga-pro-enable-ga4-universal-tracking/) ### 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/7513085) * 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/support/#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. ### Developer ### GA Google Analytics Pro is developed and maintained by [Jeff Starr](https://twitter.com/perishable), 15-year [WordPress developer](https://plugin-planet.com/) and [book author](https://books.perishablepress.com/). == Installation == ### How to install the plugin ### 1. Upload the plugin and activate via the WP Plugins screen 2. Visit GA Pro > 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 the plugin settings 2. Toggle open the "Plugin Settings" panel 3. In the first setting, "GA Tracking ID", enter your Tracking ID 4. In the next setting, "Tracking Method", choose either [Google Tag](https://developers.google.com/analytics/devguides/collection/gtagjs/) or [Universal Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/)* 5. 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:__ Google Tag (aka, Global Site Tag) is required for Google Analytics 4. For steps on setting up GA4, check out [this tutorial](https://plugin-planet.com/ga-pro-enable-google-analytics-4/). 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 > 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/support/#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 2023 Monzilla Media. All rights reserved. == More from Jeff Starr == 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 * [SAC Pro](https://plugin-planet.com/simple-ajax-chat-pro/) - Unlimited chat rooms for WordPress * [USP Pro](https://plugin-planet.com/usp-pro/) - Advanced front-end forms Quality WordPress books: * [The Tao of WordPress](https://wp-tao.com/) * [Digging into WordPress](https://digwp.com/) * [.htaccess made easy](https://htaccessbook.com/) * [WordPress Themes In Depth](https://wp-tao.com/wordpress-themes-book/) * [Wizard's SQL Recipes for WordPress](https://books.perishablepress.com/downloads/wizards-collection-sql-recipes-wordpress/) More awesome stuff on the way :) == 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.6 (2023/11/04)** * Improves localization function * Improves JavaScript on settings page * Improves Opt-Out Box and font-icon styles * Adds color-picker palettes to Opt-Out settings * Adds centered overlay option to display Opt-Out Box * Adds "Require Opt-In" option to "Disable Custom Code" * Improves `ga_google_analytics_pro_license_status()` * Changes "After Opt-In" also applies to opt-out * Replaces `DOING_CRON` with `wp_doing_cron()` * Streamlines custom callback functions * Adds custom notice on settings page * Adds two new custom code settings * Updates contextual help tab info * Updates default translation template * Tests on WordPress 6.4 (beta) **2.5.1 (2023/07/16)** * Fixes "Uncaught TypeError: property_exists()" * Tests on WordPress 6.3 (beta) **2.5 (2023/03/21)** * Improves opt-out box UI/styles * Improves settings page UI/styles * Improves settings validation functions * Reorders some opt-out settings for clarity * Adds "After Opt-In" option to plugin settings * Adds options to disable custom code if user opts out * Changes setting "Disable Auto-Hide" to "Close Button" * Adds support for optin link shortcodes in success messages * Adds filter `ga_google_analytics_pro_disable_custom` * Improves logic when calling `get_current_screen()` * Adds license status message to plugin screens * Improves handling of license activation * Improves handling of license constants * Updates Font Awesome fonts and styles * Updates contextual Help tab information * Generates new translation template * Tests on WordPress 6.1 + 6.2 (beta) * Tests on PHP 8.1 and 8.2 **2.4.1 (2022/11/14)** * Fixes bug with non-Admins unable to log in * Tests on WordPress 6.1 **2.4 (2022/10/14)** * Updates `EDD_SL_Plugin_Updater` script * __Note:__ Google renamed "Global Site Tag" to "Google Tag" * __Note:__ Google deprecating Universal Analytics ([learn more](https://developers.google.com/analytics/devguides/collection/analyticsjs/)) * Deprecates Universal Analytics `analytics.js` ([plugin support](https://wordpress.org/support/topic/note-about-google-changes/)) * Updates various plugin links to latest Google documentation * Adds support for `GAPRO_LICENSE` via `wp-config.php` * Fixes bug with disable post IDs not working * Adds custom footer text to plugin settings * Improves plugin settings UI and details * Improves contextual help information * Improves plugin documentation * Updates "More from" panel * Updates translation template * Tests on WordPress 6.1 **2.3 (2022/05/19)** * Disables GA Pro comment in HTML output * Improves logic of register settings functions * Adds `%%username%%` to get current user_login name * Plugin settings now available without license * Improves plugin License screen * Improves UI for plugin settings page * Updates contact URLs in documentation * Improves plugin documentation * Generates new translation template * Tests on WordPress 6.0 **2.2 (2022/01/28)** * Updates license updater script * Improves loading of translations * Improves performance of plugin settings * Adds exclude-ID option for all custom code * Fixes bug with custom tracking 4, 5, and 6 * Adds filter hook `gapro_tracker_object_universal` * Adds filter hook `gapro_tracker_object_global` * Updates some links to external resources * Changes minimum required WP version to 4.6 * Generates new default translation template * Tests on WordPress 5.9 **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