Installation
Just do as you normally do when installing add-ons in ExpressionEngine 2:
- Extract the .zip file
- Move the
/system/expressionengine/third_party/republic_analyticsinto your ExpressionEngine installation’s/system/expressionengine/third_party/folder. - Move the
/themes/third_party/republic_analyticsfolder into your ExpressionEngine installation’s/themes/third_party/folder. - Activate the module and the extension in the Control Panel.
- Go to Add-ons > Modules > Republic Analytics > Configuration
- Enter a Google Analytics account, save, then choose the profile you like to show.
Update
Just replace the old files with the new ones:
- Extract the .zip file
- Move the
/system/expressionengine/third_party/republic_analyticsinto your ExpressionEngine installation’s/system/expressionengine/third_party/folder. - Move the
/themes/third_party/republic_analyticsfolder into your ExpressionEngine installation’s/themes/third_party/folder. - Go to Add-ons > Modules > Republic Analytics
Documentation
Before you start using the add-on you need to Configure the add-on, authenticate with a Google Analytics account, and then select the profile you like to use.
Fig 1. Republic Analytics with bar charts
You can customize which data to display, which member groups that should be able to configuration the module, and choose between a bar or line graph. You can also customize colors and a lot of other things.
Fig 1. Line graph instead of bar graph
By installing the extension you can also choose to have Republic Analytics load as the default view when logging in to the Control Panel. The data from Google Analytics is loaded with Ajax, so it won’t delay the Control Panel load time if you’re in a hurry to do something else…
Known issues
Google authSub reports that the site has not been registered
One one or two occations we have seen the following message from Google when authenticating via authSub:
The page you have requested cannot be displayed. Another site was requesting access to your Google Account, but sent a malformed request. Please contact the site that you were trying to use when you received this message to inform them of the error. A detailed error message follows:
The site “http://domain.com” has not been registered.
It seems like this problem occur in a few situations and we found this blog post by RJMetrics that explained everything more or less the way we experienced it too.
The solution, go to https://www.google.com/accounts/ManageDomains and add your domain. Enter the URL to your control panel in the “Target URL path prefix:” box, i.e. “http://www.domain.com/system/” - that fixed the issue for us.
Download
Download “Republic Analytics” for ExpressionEngine 2.2+
Changelog
-
1.7β
2012-02-16
- Feature: Changed authorization to authSub instead of ClientLogin
- Feature: Added profile switcher when viewing the statistics (for selected member groups)
- Feature: Added color picker for graph colors
- Feature: Added hostname filters to include or exclude specific hostnames from statistics
- Change: Shorter date format in graph
- Change: Merged update frequencies and added more options
-
1.5β
2011-11-02
- Feature: MSM support
- Fixed: PHP 5.2.x bug
- Fixed: Graph didn't show in IE8 due to a canvas bug
- Fixed: Deselecting all member groups under "Redirect on login" resulted in a PHP error
-
1.4β
2011-10-30
- Feature: Google Analytics authentication now uses tokens instead of saving the credentials in the database
- Fixed: Removed unintentional limit for number of fetched Google Analytics' profiles
- Fixed: Lists profiles in alphabetic order
- Fixed: Line Graphs now uses colors set in configuration
- Fixed: Division by zero error for week and month view if no data is available
- Fixed: Corrected dates for Week and Month statistics
-
1.3β
2011-10-28
- First Public Beta release
License and disclaimer
Republic Factory gives this add-on away for free under a Creative Commons Attribution-NoDerivs 3.0 Unported License. You can use it for free, both in personal and commercial projects, but by downloading this add-on you also take full responsibility for anything that happens while using it. The add-ons are made with love and passion, and are used by us on daily basis, but we cannot guarantee that it works equally well for you.
Support is limited depending on current work load, but if you got any questions or comments feel free to email or follow us on Twitter @republicfactory and we'll try to help you out as soon as time permits.