.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


================
EXT:webanalytics
================

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed by:
      Gabi Loch

:Changed:
      2008-05-28T12:51:17

:Author:
      Gabi Loch

:Email:
      ht@hottracker.de

:Info 3:


:Info 4:


.. _EXT-webanalytics:

EXT:webanalytics
================

Extension Key:  **webanalytics**

Copyright 2008, Gabi Loch, <ht@hottracker.de>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

\- a GNU/GPL CMS/Framework available from www.typo3.com

.. _Table-of-Contents:

Table of Contents
-----------------

**EXT:webanalytics 1**

**Introduction 1**

What does it do? 1

Screenshots 1

**Users manual 1**

**Adminstration 2**

**Configuration 2**

Registration process 2

Installation 2

**Known problems 2**

**To-Do list 2**

**Changelog 2**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

The extension automatically adds a XHTML Strict compatible HotTracker
countingcode in front of the </body> tag to each site. You don't have
to touch your HTML templates at all.After installation you are able to
view your stats and analytics on `http://www.hottracker.de
<http://www.hottracker.de/>`_ (german interface) or
`http://www.hottracker.eu <http://www/>`_ (english interface)


.. _Screenshots:

Screenshots
^^^^^^^^^^^

This is a cropped screenshot on how the added code looks like.

|img-1|

Users manual

Nothing. Please see “Configuration”.


.. _Adminstration:

Adminstration
-------------

Nothing. Please see “Configuration”.


.. _Configuration:

Configuration
-------------

Before you install this extension, you need to register for a
HotTracker account at `http://www.hottracker.de
<http://www.hottracker.de/>`_ (german interface) or
`http://www.hottracker.eu <http://www.hottracker.eu/>`_ (english
interface).


.. _Registration-process:

Registration process
^^^^^^^^^^^^^^^^^^^^

|img-2| First step:You will see a registrationform. Please fill in all
required information.After completion, you will receive an email with
a link. Follow this link to activate your account.

Second step:When you now login, you will be presented a countingcode
you should use. You do not need to do this! This does the extension
for you.The only thing we need from this code is your custNum. Please
search for wm\_custnum = YouNumber; and remember the number there.

Third step:Login into HotTracker analysis form
`http://www.hottracker.de <http://www.hottracker.de/>`_ (german
interface) or `http://www.hottracker.eu <http://www.hottracker.eu/>`_
(english interface).

Step four:Watch your statistics and start optimizing your website!


.. _Installation:

Installation
^^^^^^^^^^^^

First install the extension in the extensionmanager.

Within the HotTracker application you registered before, you need to
get your custNum (see “Registration process” on how to get it).

Open your TS template setup where you defined your PAGE object. There
add the lines

::

   page.config.tx_webanalytics{
           custNum = YourCustNum
           prefix = ChoosePrefix
   }

where page is the name of your PAGE object and YourCustNum the number
you got from HotTracker before. Without the parameter custNum, the
pixel won't show up. The parameter prefix is optional.

That's it. If you now open your website and view the sourcecode, you
will see the counting code at the bottom in front of the </body> tag.


.. _Reference:

Reference
^^^^^^^^^

.. ### BEGIN~OF~TABLE ###


.. _custNum:

custNum
"""""""

.. container:: table-row

   Property
         custNum
   
   Data type
         integer
   
   Description
         Your customernumber of HotTracker - Required!
   
   Default
         empty



.. _prefix:

prefix
""""""

.. container:: table-row

   Property
         prefix
   
   Data type
         string
   
   Description
         When the parameter wm\_group\_name is built, this will prefix
         it.Example: You have a multi language site and want to know in which
         language the user viewed it.With prefix = DE, the final output in the
         counting code will look like this:
         
         wm\_group\_name = “DE/Images/Animals”;
         
         Or with prefix = EN:wm\_group\_name = “EN/Images/Animals”;
   
   Default
         empty


.. ###### END~OF~TABLE ######

[plugin.tx\_webanalytics]


.. _Known-problems:

Known problems
--------------

None at the moment.You discovered a bug? Please report at
ht@hottracker.de.


.. _To-Do-list:

To-Do list
----------

Use of other/more counting code variables.


.. _Changelog:

Changelog
---------

05/28/2008 – Version 0.1.2

Added parameters:- wm\_page\_name- wm\_group\_name with an optional
prefix (e.g. to prefix with language code)

03/14/2008 – Version 0.1.0Initial release.

|img-3| EXT:webanalytics - 3


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 192
.. :id: Grafik2
.. :name: Grafik2
.. :width: 651

.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 184
.. :id: Grafik1
.. :name: Grafik1
.. :width: 669

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102