=== Plugin Name ===
Google Analytics Top Content Widget

Contributors: jtsternberg
Plugin Name:  Google Analytics Top Content Widget
Plugin URI: http://j.ustin.co/yWTtmy
Tags: google analytics, google, top posts, top content, display rank, page rank, page views, widget, sidebar, sidebar widget, Google Analytics Dashboard, shortcode
Author: Jtsternberg
Author URI: http://about.me/jtsternberg
Donate link: http://j.ustin.co/rYL89n
Requires at least: 3.0
Tested up to: 3.5
Stable tag: 1.4.2
Version: 1.4.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Widget and shortcode to display top content according to Google Analytics. ("Google Analytics Dashboard" plugin required)

== Description ==

Adds a widget that allows you to display top pages/posts in your sidebar based on google analytics data.

Requires a Google Analytics account, and the plugin, ["Google Analytics Dashboard"](http://wordpress.org/extend/plugins/google-analytics-dashboard/) (which will be auto-installed by this plugin, thanks to [@jthomasgriffin](http://twitter.com/jthomasgriffin)'s awesome [TGM Plugin Activation Class](http://j.ustin.co/yZPKXw)).

Also includes a shortcode to display the top content in your posts and pages.

= Shortcode with options supported: =

`[google_top_content pageviews=5 number=10 showhome=no time=2628000 timeval=2]`

= Shortcode attributes definitions: =

* Pageviews: Show pages with at least __ number of page views
* Number: Number of pages to show in the list
* Showhome: Will remove home page from list: (usually "yoursite.com" is the highest viewed page)
* Time: Selects how far back you would like analytics to pull from. needs to be in seconds. (1 hour - 3600, 1 day - 86400, 1 month - 2628000, 1 year - 31536000).
* Time Value: time=2628000 timeval=2 like in the example above would be 2 months.

Since 1.3:

* titleremove: Remove site title from listings. (Unless your site doesn't output the site titles, then you will need to add this in order for the filter settings below to work.)
* contentfilter: Limit listings to a particular post-type (post, page, etc)
* catlimit: Limit listings to specific categories. (comma separated category ID's)
* catfilter: Remove listings in specific categories. (comma separated category ID's)
* postfilter: Remove specific posts/pages, etc by ID. (comma separated post ID's)

All of the widget options are exactly that.. optional. If you don't include them it will pick some defaults.

= Plugin Features: =

* Plugin uses WordPress transients to cache the Google results so you're not running the update from Google every time. cache updates every 24 hours.
* Developer Friendly. Many filters built in to allow you to filter the results to dispay how you want.  One example of that would be to remove your Site's title from the results. (now unnecessary, as the widget/shortcode has the option built in)
** [Example using a filter to add view counts after the title](http://wordpress.org/support/topic/top-viewed-content-couple-of-tweeks-needed?replies=9#post-3816989) -
`add_filter( 'gtc_pages_filter', 'gtc_add_viewcount_title' );
function gtc_add_viewcount_title( $pages ) {

	if ( !$pages )
		return false;
	// loop through the pages
	foreach ( $pages as $key => $page ) {
		// and add the page count to the title value
		$pages[$key]['children']['value'] = $pages[$key]['children']['value'] . ' ['. $pages[$key]['children']['children']['ga:pageviews'] .' Views]';
	}
	return $pages;
}`


== Installation ==

1. Upload the `google-analytics-top-posts-widget` directory to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Plugin will prompt you to install the "Google Analytics Dashboard" plugin. Install and activate it.
4. Use the "Google Analytics Dashboard" plugin's settings page to login to your google analytics account.
5. On the widgets page, drag the "Google Analytics Top Posts" widget to the desired sidebar.
6. Update the widget settings and save.

== Frequently Asked Questions ==

= After Upgrading to 1.4, my widget stopped working =
I updated the widget options for the date picker, and as a result, it broke any widgets that were saved with the old options. 1.4.1 solves that, but either way, re-saving the widget will correct the issue.

If you were using the shortcode and it broke, you will need to switch to using the shortcode with the new format (described [here](http://wordpress.org/extend/plugins/google-analytics-top-posts-widget/))

= ?? =
If you run into a problem or have a question, contact me ([contact form](http://j.ustin.co/scbo43) or [@jtsternberg on twitter](http://j.ustin.co/wUfBD3)). I'll add them here.


== Screenshots ==

1. Widget options.
2. Widget display (in an ordered list).

== Changelog ==

= 1.4.2 =
* Fixed the number value select for the "Select how far back you would like analytics to pull from:" selector.

= 1.4.1 =
* I updated the widget options for the date picker, and as a result, it broke any widgets that were saved with the old options. 1.4.1 solves that, but either way, re-saving the widget will correct the issue.

If you were using the shortcode and it broke, you will need to switch to using the shortcode with the new format (described [here](http://wordpress.org/extend/plugins/google-analytics-top-posts-widget/))

= 1.4 =
* Added more flexibilty to the time select dropdown. Now with options to select hours and days.

= 1.3 =
* Added more widget options to modify the list output. Added field to enter repeating elements in the titles to remove from the listings. Also, now limit or filter by post-type, by category, or by post/page ID.

= 1.2 =
* Increased page-speed with use of transients caching. Also added a few more developer friendly filters.

= 1.1 =
* Add a pages filter for developers, remove site title from page title, change date picker to use relative dates.

= 1.0 =
* Launch.


== Upgrade Notice ==

= 1.4.2 =
* Fixed the number value select for the "Select how far back you would like analytics to pull from:" selector.

= 1.4.1 =
I updated the widget options for the date picker, and as a result, it broke any widgets that were saved with the old options. 1.4.1 solves that, but either way, re-saving the widget will correct the issue.

If you were using the shortcode and it broke, you will need to switch to using the shortcode with the new format (described [here](http://wordpress.org/extend/plugins/google-analytics-top-posts-widget/))

= 1.4 =
Added more flexibilty to the time select dropdown. Now with options to select hours and days.

= 1.3 =
Added more widget options to modify the list output. Added field to enter repeating elements in the titles to remove from the listings. Also, now limit or filter by post-type, by category, or by post/page ID.

= 1.2 =
Increased page-speed with use of transients caching. Also added a few more developer friendly filters.

= 1.1 =
Add a pages filter for developers, remove site title from page title, change date picker to use relative dates.

= 1.0 =
Launch