=Google Analytics Plugin=
                                                               February 8, 2011
                               hiroshi sakuramoto    hiroron AT hiroron DOT com
                                                                     ver: 1.1.4
                  translated by: takashi kobayashi as kobab geeklog.crimsonj.net

This is a plugin that manages GoogleAnalytics at Geeklog later than 1.5.0. You just put GA's trucking ID at GoogleAanlytics plugin manager and insert a tag {googleanalytics} which represents the Google Analytics JavaScript codes. Thus a proper code does insert into a Geeklog's proper thtml file. (NEW!) At this ver 1.1.1, the plugin provides an option to use Google's asynchronous trucking code. 

As same as prior verions, we provide an extension for colleting mobile access data which GoogleAnalytics does not support officially, becasue most of mobile phone browsers do not support JavaScript. 

For mobile access, Google JavaScript code does not be used. Instead, the plugin provides mobile access information to Google with its own. Meanwhile, for separate management of the mobile access analysis, an option to put another trucking ID for mobile is available.

On asynchronouse trucking & synchronouse trucking, please refer the explanation by Google here. http://www.google.com/support/analytics/bin/answer.py?hl=en&answer=161379

Hereunder are advantages of asynchronouse trucking code.
-Faster overall page load time.
-Improved collection for short visits to rich media or script-heavy pages.
-Collecting (and retaining) user clicks that occur before the tracking code loads. 

synchronouse trucking code is the one you used before by placing the code just before closing </body> tag.


=How to install=
=== recommended ===
Recommends to install this plugin with wkyGeeklogInstaller(wGI). wGI is a automatic installer of Geeklog itself, Geeklg themes and Geeklog plugins. For installation of themes and plugins, drag & drop a file called 'recipe' onto wGI. The recipe files should be downloaded separately.

download wkyGeeklogInstaller
http://hiroron.com/filemgmt/viewcat.php?cid=3
*please select the latest version and download.

download GoogleAnalytics plugin
http://hiroron.com/filemgmt/index.php?id=187


=== manual install ===
1. make a directory at your server $_CONF=['path']/plugins/googleanalytics.
2. decompress the downloaded file.
3. copy the decompressed directories and files except the ones under /admin directory and paste those to the $_CONF=['path']/plugins/googleanalytics.
4. make {yoursite}/admin/plugins/googleanalytics.
5. copy the decompressed directory and files under /admin to the {yoursite}/admin/plugins/googleanalytics.
6. login Geeklog as proper user or admin, go to plugin manager and select the installation of this plugin.
7. If no problem was found, the installation completed.
8. Go to "initial setting" of this manual.

== how to upgrade == *upgrade from ver1.0.0
1. Overwrite the previous version files by 1.1.4 files with a same method of an installation mentioned above.
2. Log in Geeklog as proper user or admin, go to plugin manager and select the update of this plugin.

Upgrade is completed by those steps. Trucking ID & settings should be restored from the previous version files. Try to set newly added items and test.

== uninstall ==
1. login Geeklog as proper user or admin, go to plugin manager and select this plugin uninstallation.
2. after uninstallation completed, delete files and directories you made at the installation.


== initial setting ==

=== setting trucking ID ===
after the plugin install completed, login as proper user or admin and go to configuration. Find 'GoogleAnalytics' and put trucking ID like UA-9999999-9 provided by Google.

=== putting tag ===
note: The following steps are necessary when using synchronous trucking for PC or mobile. If you just use asynchronous trucking alone, the following steps are not necessary. A proper code will be implemented automatically.

put {googleanalytics} tag on footer.thtml of a theme you adopted. A position recommended is one raw before </body> tag.

example:
{googleanalytics}
</body>

If you allow users to select other themes, you should insert the {googleanalytics} tag before </body> tag at every theme you allowed to use.


== setting items ==
-GoogleAnalytics Tracking ID: put trucking ID provided by GoogleAnalytics
-Mobile GoogleAnalytics Tracking ID: If you prefer a separete analysis for mobile accesses, get another ID at GoogleAnalytics and put it here.
-Use Asynchronous tracking: By selecting Yes, asynchronous code will be generated. No for synchronouse trucking code.
-Ignore Mobile Crawler: By selecting Yes, mobile crawler accesses being exluded. By No, mobile crawler accesses being included.

-mobile crawlers' UA strings: 
While this plugin enables to collect mobile access data, mobile crawlers' access such as the one by Google, Yahoo etc are included, whereas GoogleAnalytics excludes the one by PC crawlers. You may feel this is inconvenient when you want to have an exact mobile user analysis on your sites.

To solve this problem, I implemented an extended feature of filtering those mobile crawler access with their UA unique strings. In case of Google, their mobile crawlers' UA has unique 'Google-Mobile' strings. So do 'Y!J-SRD' for Yahoo Japan etc.

Here you can set unique strings to be judged as mobile crawlers by this plugin. We put some strings by default for users in Japan. Non-Japan users should set this in accordance with your necessity or favor. Since I am not familiar with circumstances besides Japan market, your feed back on this feature shall be highly appreciated to improve this plugin.



== You have to put autotag on footer.thtml? or not necessary? ==

=== in case your target is PC access alone ===
You just select 'YES' at 'Use Asynchronous tracking'. You do not need to put autotag on footer.thtml.
However, if you selected 'NO', please put autotag {googleanalytics} on footer.thtml.

=== in case your target is mobile access alone ===
You have to put {googleanalytics} tag on footer.thtml regardless of your selection of asynchronous trucking, which is 'YES' or 'NO'.

=== in case your target is PC + mobile ===
You have to put {googleanalytics} tag on footer.thtml regardless of your selection of asynchronous trucking, which is 'YES' or 'NO'.

=== summary of autotag insertion necessity===
asynchronous + PC only: NOT necessary.
asynchronous + mobile only OR asynchronous + PC & mobile: necessary
synchronous; regardless of targets: necessary

