=== Googlyzer ===
Contributors: wmsedgar
Donate link: http://oaktondata.com/googlyzer/
Tags: google, analytics, google analytics, google dashboard, dashboard, website traffic, website tracking, sparkline, microchart
Requires at least: 2.9
Tested up to: 3.3.1
Stable tag: 2.2

Embed the power of Google Analytics in your WordPress Admin console and view key metrics for each of your domains from one place.

== Description ==
Googlyzer adds an administrative dashboard to WordPress with microcharts for tracking website traffic data from Google Analytics, allowing WordPress administrators to easily view Google Analytics data for their website(s) without leaving their WordPress Admin console.
<strong>Key Features:</strong>
<ul>
	<li>Automatically loads Google Analytics async tracking code in header or footer, with customizable options</li>
	<li>Fully customizable Home Dashboard widget showing your selected key metrics and most popular page stats</li>
	<li>Fully customizable Main Dashboard with linecharts, piecharts, and tables for display of your desired metric/dimension data</li>
	<li>Change default dimensions and metrics for any chart or table</li>
	<li>Choose whether or not to display chart metadata (max, min, last, avg)</li>
	<li>Choose whether to display individual charts, and tables, or hide</li>
	<li>Choose whether to show historic data comparison for linecharts</li>
	<li>Choose whether to display daily and selected date range trends for individual metrics</li>
	<li>Choose whether to include available data from current date when selecting dynamic ranges (ex. last 30 days)</li>
	<li>Customizable configuration options for all chart colors</li>
</ul>
<strong>Now Available: Googlyzer Pro</strong> enabling integration of data from Google Analytics in your public WordPress site. A few of the features of Googlyzer Pro are listed below. For more information on Googlyzer Pro, visit the <a href="http://oaktondata.com/googlyzer">Googlyzer</a> Product Page.
<ul>
	<li>Powerful and fully customizable Most Popular Content sidebar multi-widget for displaying popular content excerpts and links using data from both Google Analytics and your WordPress site</li>
	<li>Fully customizable Sparkline Chart sidebar multi-widget for display of metrics using data from Google Analytics</li>
	<li>Sparkline shortcode capability to enable embedded display of Google Analytics data within pages or posts</li>
	<li>No additional plugins required for tracking WordPress site statistics</li>
</ul>

= Plugin's Official Site =

Googlyzer Website ([http://oaktondata.com/googlyzer](http://oaktondata.com/googlyzer))

= Plugin Support Forum =

Googlyzer Web Forum ([http://oaktondata.com/forum/wordpress-plugins/googlyzer/googlyzer-basic/](http://oaktondata.com/forum/wordpress-plugins/googlyzer/googlyzer-basic/))

== Installation ==

Download the Googlyzer archive, then extract the Googlyzer directory to your WordPress plugins directory (generally ../wordpress/wp-content/plugins/).  Then go to the <em>Plugins</em> page of your WordPress admin console and activate the Googlyzer plugin. Once activated, go to the Googlyzer <em>General Settings</em> tab, via the WordPress <em>Settings</em> menu.  Enter your Google account credentials in the Google Service Authentication section and click the login button.  Once authentication with Google is successfully completed, several changes should be visible. First, the <em>Status</em> field within the Google Service Authentication section will change to "Authenticated." Second, an authentication token will appear in the read-only field in the <em>General Settings</em> section. And, third, the <em>Domain</em> dropdown will populate with available Domain selections associated with your Google account.  Select your desired Domain, modify other settings as desired, and click on <em>Save Settings</em>. That completes the basic setup. If desired, visit the other tabs (Composite Chart, Line Charts, Pie Charts, and Tables) on the Googlyzer Options page in order to further customize your Googlyzer dashboard settings.

After saving settings, you can then view the dashboard by clicking the <em>Googlyzer Dashboard</em> link in the <em>Dashboard</em> section of the WordPress Admin Console, or go to the WordPress Home Dashboard to view the Googlyzer Home Dashboard widget.

Should you wish to revoke access for Googlyzer to your Google Analytics website data, simply click on Logout in the Google Service Authentication section on the <em>General Settings</em> tab. <strong>Please NOTE</strong>, once Google Analytics access is revoked, Googlyzer can no longer populate the dashboard or widgets, as the data is not cached locally.

== Frequently Asked Questions ==

= How does Googlyzer access my Google Analytics account? =

Googlyzer is granted access to the website data through the ClientLogin interface within the Google Analytics API, which provides a secure authentication token for use in data feed requests. Googlyzer does not store any login credentials. Access to Google Analytics can easily be revoked, by simply clicking Logout on the Googlyzer General Settings tab.

= Can Googlyzer charts be used as widgets on other pages within my site? =

Googlyzer Basic creates a widget on the WordPress Home Dashboard. Googlyzer Pro provides 2 customizable sidebar multi-widgets for display of metric data via Sparklines and a Most Popular Content listing. Googlyzer Pro also provides sparkline shortcode capability that enables display of sparkline data embedded within a page or post.

= Will the Googlyzer Dashboard be visible on my site? =

No. The main Googlyzer Dashboard and Home Dashboard widget provided by Googlyzer Basic are only accessible via the WordPress administrative console. If you want to integrate display Google Analytics metric data within your public website, take a look at Googlyzer Pro.

= Does Googlyzer anonymize my website data? =

Not in this version of Googlyzer.

= Why does the Googlyzer dashboard take a while to load? =

The time required to load the Googlyzer dashboard is dependent upon web server resources, connection speeds, etc. Load times have been reduced significantly through optimization of the data request and load process.  The current version of Googlyzer does not cache any data, this may change in a later version in order to speed up loading of the dashboard as well as to make the data available for other uses.

= After installing Googlyzer, I get the following error when accessing the Googlyzer Dashboard - "Fatal error: Call to undefined method DateTime::sub()", what is this? =

This is due to an out-of-date version of PHP running on your web server. Googlyzer uses some PHP libraries (DateTime is the main one) that are standard in PHP v5.3 or above. Check the version of PHP running on your web server with your web hosting provider and upgrade if necessary.

== Screenshots ==

1. Main Googlyzer dashboard with sample data (Googlyzer Basic + Pro).
2. Googlyzer widget for the WordPress Home Dashboard with sample data (Googlyzer Basic + Pro).
3. GA tracking code configuration options (Googlyzer Basic + Pro).
4. Sparkline Chart sidebar multi-widget with sample data (Googlyzer Pro).
5. Sparkline Chart sidebar multi-widget options (Googlyzer Pro).
6. Most Popular Content sidebar multi-widget with sample data (Googlyzer Pro).
7. Most Popular Content sidebar multi-widget options (Googlyzer Pro).
8. Google Service Authentication section on General Settings tab.
9. Custom date selection on General Settings tab.
10. Color selection on Composite Chart tab.
11. Line Chart settings.
12. Pie Chart settings.
13. Table settings.
14. About and instructions.

== Changelog ==

= 2.2 =
* Added ability to define custom dimension and/or metric filters for dashboard tables.
* Removed use of PHP 5.3 DateTime function to resolve issues for systems running PHP versions < 5.3.
* Fixed bug with custom date ranges affecting some queries.
* Fixed bug with loading of jQuery for external facing pages.
* Fixed bug with piechart options changing max results value.
* Improved error handling in Dashboard.
* Cleaned up old CSS tags.
* Cleaned up formatting on options pages.

= 2.1 =
* Added optional function to include Google Analytics tracking script, rather than rely on other plugins/themes or manual entry into theme files.
* Added option to exclude/include tracking of WordPress Administrator activity in Google Analytics data.
* Added display fields on new GA Tracking Code options tab for validation of Google Analytics account information for selected domain; also display in dashboard header section.
* Added tracking field for first occurrence of Google Analytics data, that also displays on Googlyzer Dashboard header section.
* Fixed bug that resulted in some page/post listings on the Googlyzer WP Home Dashboard widget not being link enabled.
* Updated readme text with data on latest releases.
* Minor tweaks to CSS for options pages.

= 2.0 =
* Completely re-architected from the ground up to optimize performance and eliminate browser compatibility issues.
* Implemented configurable WordPress Home Dashboard widget to show 5 GA metrics with trend lines and metadata, as well as most-popular page stats and link to main Googlyzer Dashboard.
* Tightened integration with WordPress CSS and settings API to improve visual aesthetics of Googlyzer dashboard, widgets, and options pages.
* Redesigned Google authentication and data feed request process to streamline user authentication.
* Improved browser support (NOW SUPPORTS ALL MAJOR BROWSERS), successfully tested with Mozilla Firefox 9, Google Chrome 16.0.912.75, Safari 5.1.2, MS Internet Explorer 9, and Opera 11.5.

= 1.2.1 =
* Fixed bug that resulted in Googlyzer general settings outputting on WP General Settings page (bottom).
* Updated screenshots to include date picker, color picker, and metric selection examples.
* Updated readme.txt file to show v1.2.1 browser compatibility (instead of v1.1).

= 1.2 =
* Added ability to select custom dimension and metric selections for all charts on settings tabs in order to customize dashboard.
* Added many new Google Analytics dimension and metric selections for charts.
* Redesigned javascript dashboard loader to improve performance of dashboard load process.
* Added settings tab for composite chart (main totals chart) with standard chart options.
* Added header area to Dashboard with website name, Google Analytics Table ID, selected date range, browser, browser version, and browser compatibility fields.
* Added browser, browser version, and browser compatibility fields to general settings page.
* Added field to display Google Analytics Table ID associated with selected website on General Settings tab.
* Added option to toggle inclusion of partial data from current date in dashboard when selecting pre-set date ranges (5 days, 10 days, 30 days, etc.).
* Added option to include daily and date range trend values for line charts (requires history display to be enabled).
* Added dynamic color picker for history sparklines on line charts.
* Added ability to toggle display of composite chart, pie charts, and tables in dashboard.
* Fixed issue with Restore Defaults button on General Settings page.
* Fixed issue with non-standard WordPress plugin directory paths.
* Fixed issue with GA authentication error handling.

= 1.1 =
* Fixed path issue for MultiSite.
* Added configuration options for modifying # of keyword searches and top pages to display on dashboard.
* Added dynamic color picker for line charts and pie charts on dashboard.
* Added ability to toggle display of comparative history sparklines for line charts.
* Added ability to toggle display of line charts.
* Added ability to toggle display of metadata on linecharts.
* Enabled dynamic resizing of line charts to accomodate metadata for higher-volume websites.
* Enabled dynamic resizing of tables to accomodate more results.
* Modified CSS to resolve conflicts with WordPress CSS.
* Cleaned up dashboard UI to take up less screen real estate.

= 1.0 =
* Initial release

== Upgrade Notice ==

= 2.2 =
* Removed dependencies on PHP v5.3 functions, added custom filter capability for dashboard tables, implemented minor bug fixes for jQuery on external pages and custom date ranges. 

= 2.1 =
* Added capability to include Google Analytics async tracking code with customizable options. Fixed bug with Googlyzer widget for WP Home Dashboard causing issue with most popular page links.

= 2.0 =
* Completely re-architected from the ground up to optimize performance and eliminate ALL browser compatibility issues. Redesigned options pages and user interface and added powerful new WP Home Dashboard widget.

= 1.2.1 =
* Fixed minor bug with general settings, updated browser compatibility listing, and screenshots.

= 1.2 =
* Added ability to select custom GA dimensions and metrics, improved dashboard load performance, display data trends, customization options for main composite chart, and many other new features.  Also added some minor bug fixes.

= 1.1 =
* Added many new configuration options, ability to compare history on linecharts, enhancements to dashboard UI, and issue resolutions for MultiSite and CSS conflicts.

= 1.0 =
* Initial release

== Web Browser Compatibility ==

= Googlyzer v2.2 has been successfully tested on the following configurations: =
<ul>
	<li>Ubuntu Linux 10.04 Chrome 14.0.835.126</li>
	<li>Ubuntu Linux 10.04 Firefox 6.0.1</li>
	<li>Ubuntu Linux 10.04 Opera 11.51</li>
	<li>Windows 7 Chrome 14.0.835.186 m</li>
	<li>Windows 7 Firefox 6.0.2</li>
	<li>Windows 7 Internet Explorer 9</li>
	<li>Apple OS X 10.4.11 Safari 4.1.3 (browser must be configured to allow 3rd party cookies)</li>
	<li>Apple OS X 10.6.8 Safari 5.1.2 (browser must be configured to allow 3rd party cookies)</li>
	<li>Apple OS X 10.6.8 Chrome 14.0.835.126</li>
	<li>Apple OS X 10.6.8 Firefox 6.0.2</li>
	<li>Android 2.3.4 Android Browser (Motorola Droid Bionic)</li> 
</ul>
= Googlyzer v2.2 has not yet been tested on: =
<ul>
	<li>Windows XP Internet Explorer 8</li>
	<li>Windows Vista Internet Explorer 8/9</li>
</ul>
= Googlyzer v2.2 is known to have browser compatibility issues with: =
<ul>
	<li>None! Let us know if you find any!</li>
</ul>

== Details on Google Analytics Integration ==

= Dimensions =
Googlyzer includes the following dimensions from Google Analytics:
<ul>
    <li>City (ga:city)</li>
    <li>Continent (ga:continent)</li>
    <li>Country (ga:country)</li>
    <li>Day (ga:date)</li>
    <li>Hostname (ga:hostname)</li>
    <li>Landing Page (ga:landingPagePath)</li>
    <li>Keyword (ga:keyword)</li>
    <li>Page Path (ga:pagePath)</li>
    <li>Page Title (ga:pageTitle)</li>
    <li>Region (ga:region)</li>
    <li>Subcontinent (ga:subcontinent)</li>
</ul>

= Metrics =
Googlyzer includes the following metrics from Google Analytics:
<ul>
    <li>Average Page Load Time (ga:avgPageLoadTime)</li>
    <li>Average Search Depth (ga:avgSearchDepth)</li>
    <li>Average Time on Site (ga:avgTimeOnSite)</li>
    <li>Bounces (ga:bounces)</li>
    <li>Entrances (ga:entrances)</li>
    <li>Entrance Bounce Rate (ga:entranceBounceRate)</li>
    <li>New Visits (ga:newvisits)</li>
    <li>Organic Searches (ga:organicSearches)</li>
    <li>Pageviews (ga:pageviews)</li>
    <li>Pageviews per Visit (ga:pageviewsPerVisit)</li>
    <li>Percent New Visits (ga:percentNewVisits)</li>
    <li>Search Depth (ga:searchDepth)</li>
    <li>Search Result Views (ga:searchResultViews)</li>
    <li>Search Visits (ga:searchVisits)</li>
    <li>Visits (ga:visits)</li>
    <li>Visitors (ga:visitors)</li>
    <li>Visit Bounce Rate (ga:visitBounceRate)</li>
</ul>

= Example Chart Combinations =
Here is a list of some of the chart combinations possible with the available dimension and metric combinations in Googlyzer:
(all over a specified period that can be a given by specific dates, or over a dynamic range, for example over the last 30 days)
<ul>
    <li>Visits by Browser (pie chart %)</li>
    <li>Referrals by Source (pie chart %)</li>
    <li>New vs. Returning Visitors (pie chart %)</li>
    <li>Total Pageviews (sparkline chart)</li>
    <li>Total Visitors (sparkline chart)</li>
    <li>Total New Visits (sparkline chart)</li>
    <li>Visitors / Day (sparkline chart)</li>
    <li>Visitors / Country (sparkline chart)</li>
    <li>Pageviews / Day (sparkline chart)</li>
    <li>Pageviews / Country (sparkline chart)</li>
    <li>New Visits / Day (sparkline chart)</li>
    <li>Bounce Rate % (sparkline chart)</li>
    <li>Most Popular Pages by Pageviews (table)</li>
    <li>Top Keyword Searches by Search Count (table)</li>
    <li>And many more...</li>
</ul>
