EXT: GetClicky¶

Table of Contents¶

EXT: GetClicky 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 1

FAQ 1

Adminstration 2

FAQ 2

Configuration 2

FAQ 2

Reference 2

Tutorial 3

Known problems 3

To-Do list 3

Changelog 3

Important guidelines 4

Issues with Open Office documentation for TYPO3 4

Inserting images 4

Paragraph styles 4

Linking 5

Meta data and updates 5

Introduction¶

Users manual¶

Create a Clicky account at http://getclicky.com/5987 (which is my affiliate link – please support further development by using that link), or at http://getclicky.com .

Install the plugin via the extension manager.

Include both static files (“include static (from extensions)”) in your template ( very important! ).

Go to the constant editor and edit the setting for the Clicky ID and DBServer, and you're done! You can find this information in your site preferences page on the Clicky website (that's the last tab on the stats pages).

You can immediately view your statistics on the GetClicky website.

Administration¶

Nothing special right now – just view your stats via the GetClicky website.

Configuration¶

page.headerdata.1000 =<  lib.tx_getclicky

plugin.tx_getclicky.profeatures.trackusers {
        userfield = name
        userfield2 = uid
        userfield2.crop =
}

Technical discussion¶

This extension creates the JavaScript (and HTML) code necessary for integrating GetClicky.

The static templates are separated into the general setup, where the tracking code is generated, and a second (example) template that inserts the tracking code at the end of the page object.

Currently the getclicky code is all created by TypoScript. This may change in the future, so please don't rely on customizing lib.tx_getclicky, but only use the constants. If you'd like something added, please drop me a line!

I tried to get as much as possible done with caching, only the user names have to be generated by a COA_INT. So if you don't use the pro features, the output can be cached completely.

I'm currently also tracking the e-mail, real name and company in separate custom variables, as stated in the Clicky customization guide, but this doesn't seem to work as stated, or it just isn't displayed right now.

Clicky is introducing new features every week, so if you are not satisfied right now, you probably will in some weeks ;-) So check back sometime!

I intend to do another similar extension for reinvigorate, which is currently in beta (which means you get everything for free there). It works similarly, but the web interface is currently quite awful. Strong point at the moment is the standalone application called snoop, which lets you see what's happening in real time, but not in the browser as the Clicky Spy, and it also make some noise ;-) See for yourself: http://www.reinvigorate.net

Known problems¶

None so far.

To-Do list¶

• The Clicky API v2 is now ready and can be used to integrate Clicky into the Typo3 backend
• Frontend plugin to support opting out for individual frontend users
• Maybe change the TS path from lib.tx_getclicky to plugin.tx_getclicky (not sure about that, though).
• Do you want other features? Please drop me a line!

Changelog¶

0.1.1: Update to the current Clicky tracking code: NoScript version is updated

0.1.1: Track FE user id also

0.1.0: Fix for IE JavaScript problems, manual added

0.0.2: Caching problems resolved

0.0.1: First upload

EXT: GetClicky - 3