Platinum sponsors
To integrate piwikintegration into your TYPO3 installation follow these steps:
Install the extension via TER, piwik is not included!
Also install and enable the EXT:piwik which is suggested, to get the trackingcode automatically.You do not need to configure EXT:piwik since it is already configured with the static template of EXT:piwikintegration (see below).Have a look in http://typo3.org/extensions/repository/view/piwik/current/ for setting up advanced options of EXT:piwik. You do not need to do this here.
Enable the extension EXT:piwikintegration.
Add the static template of EXT:piwikintegration (choose Web -> Template -> [page where you have your template] -> Info/Modify -> Edit whole template record -> Includes) This will enable a single idsite and add the needed ts-configuration for EXT:piwik, as described above.
Open the statistik module (Web -> Statistics ) and click on the page, or a subpage, where you added the static template:
The backendmodule now recognizes, that Piwik is not installed (by checking, if the config file exists).
The backendmodule will now download, extract and install the latest Piwik release into typo3conf/piwik. This could take a while.
The backendmodule will now reload and you will now able to use Piwik via the Direct Statistics Access dropdown box.
(If you like to use GeoIPDatabase use the admin functions of the module and download the database from maxmind.)[This function is currently not available.]
That's all you need to start tracking your visitors. See EXT:piwik manual for more config options and description of it's parameters.
To integrate piwikintegration into your TYPO3 installation follow these steps:
Install the extension via TER, piwik is not included!
Install and enable the EXT:piwik which is suggested, to get the Trackingcode automatically.You do not need to configure EXT:piwik it's configured with the static template of EXT:piwikintegration (see below).Have a look in http://typo3.org/extensions/repository/view/piwik/current/ for setting up advanced options of EXT:piwik. You do not need to do this here.You do not need to install EXT:piwik, if you integrate the trackingcode on your own. But you need to setup up the siteid like described in http://typo3.org/extensions/repository/view/piwik/current/ in the EXT:piwik manual. This is needed, because EXT:piwikintegration uses the same setup as EXT:piwik
Install and enable the plugin EXT:piwikintegration.
Copy Piwik in typo3conf/piwik/piwik so that the index.php is accessable via typo3conf/piwik/piwik/index.php
Setup Piwik with the same database parameters as you use for your TYPO3 installation. You need to set the prefix to “tx_piwikintegration_“ as this is required for EXT:piwikintegration.
Open the statistik module, click on the page, or a subpage, where you have added the static template. The backendmodule should now recognize that Piwik is correctly installed (by checking if the config file exists). This will show the overview page.
Don't forget to install the TYPO3* plugins in Piwik application (Web -> Statistics -> Direct Statistics Access -> Admin -> Plugins), especially the TYPO3Auth plugin is mandatory for authentification against the TYPO3 session. If this works you can disable the Login plugin.
If you like to use GeoIPDatabase use the admin functions of the module and download the database from maxmind.
That's all you need to start tracking your visitors. See EXT:piwik manual for more config options and description of it's parameters.
Basically there 3 ways to install the trackingcode to your site
Ext:piwik adds the trackingcode to your Page. All you need to do is to download and install EXT:piwik via the TYPO3 extension manager. Add the static TS of EXT:piwik and EXT:piwikintegration to your page template and configure the idsite. See http://typo3.org/extensions/repository/view/piwik/current/ for more details.
This way offers an easy configuration interface via EXT:piwik TS interface:
.piwik_idsite
.piwik_host
.piwik_action_name
.piwik_download_extensions
.piwik_hosts_alias
.piwik_tracker_pause
.piwik_install_tracker
Note: there is already a version 2.x in the SVN on forge.typo3.org which is still waiting to get published:
http://forge.typo3.org/repositories/show/extension-piwik
Use EXT:piwikintegration to obtain the JS Code. Add it to your TS pagetemplate. Configure config.tx_piwik.piwik_idsite, because Ext:piwikintegration needs that value for setting up the users.
EXT:piwikintegration is shipped with a basic trackingcode add script. You may enable it in the extension manager. And add the static TS of EXT:piwikintegration to your TS template. See the chapter “Settings in Extensionmanager” for more details. It's not recommend to use that option, as there is only one configuration option: config.tx_piwik.piwik_idsite.
Ext:piwikintegration installs like a normal plugin. It needs to be installed as local extension. Additionally Ext:piwikintegration creates a folder typo3conf/piwik where piwik will reside.
Read the correspondng articles on piwik.org. You will find the configuration and all the needed files below typo3conf/piwik/piwik.
Adding pluging to Piwik is as easy as extracting zip files to the plugins folder in the folder typo3conf/piwik/piwik.
I suggest to install EXT:t3extplorer and use the upload vie URL functionality of this extensions as here it is also possible to extract the files directly on the server.
Usefull plugins for Piwik:
AnonymizeIP for shortening Ip'sincluded
TYPO3Menuincluded
Heatmap (still under heavy development)http://dev.piwik.org/trac/ticket/73
The developer plattform allows you to search plugins with the following url.
http://dev.piwik.org/trac/query?status=new&status=assigned&status=reopened&milestone=Third+Party+Piwik+Plugins&order=priority
