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


============================
EXT: Media player statistics
============================

:Author:
      Spyker

:Created:
      2006-05-21T15:02:16

:Changed by:
      Michiel Roos

:Changed:
      2008-03-17T14:20:00

:Email:
      extensions@netcreators.com

:Info 2:


:Info 3:


:Info 4:


.. _EXT-Media-player-statistics:

EXT: Media player statistics
============================

Extension Key:  **mediaplayerstatistics**

Copyright 2007, Michiel Roos, <extensions@netcreators.com>

This extension was sponsored by the dutch labour union: CNV

http://www.cnv.nl

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: Media player statistics 1**

**Introduction 1**

What does it do? 1

Requirements 1

**Installation 1**

**Configuration 1**

**Viewing the statistics 1**

**Known issues 2**

**TODO 2**

**Changelog 2**


.. _Introduction:

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


.. _What-does-it-do:

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

This extension makes it possible to log 'plays' of files presented
with the advanced FLV Player & Video Gallery (bddb\_flvvideogallery).
It uses the 'callback' parameter to register a php file. This php file
logs all the views to the database.

A backend module is provided that lists the files in order of 'most
played'. This module may be extended later on.

Patches are welcome!

Please take note that (instead of using this extension) you can also
send media file start- and stop data automatically to Google
Analytics. If you want that, set the callback to urchin (if you use
the old urchinTracker code) or analytics (if you use the new
pageTracker code).


.. _Requirements:

Requirements
^^^^^^^^^^^^

bddb\_flvvideogallery


.. _Installation:

Installation
------------

Installation is pretty straight forward, just install the extension
using the extension manager.


.. _Configuration:

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

Add the parameter to use the callback function to your TypoScript
Setup for bddb flvvideogallery as follows (all in one line):

::

   plugin.tx_bddbflvvideogallery_pi1.SwfObjectJS = s1.addVariable('callback', '/typo3conf/ext/nc_videostatistics/res/mediaPlayerStatisticsMySQL.php');


.. _Viewing-the-statistics:

Viewing the statistics
----------------------

The statistics can be viewed using the backend module:

|img-1|  *Illustration 1: The statistics module in all its glory.*


.. _Known-issues:

Known issues
------------

- Contact me!

- There is no way that I know of to log the 'page' the medium is viewed
  on. Currently the pid is allways logged as 0.

- The backend module should become 'domain aware' to support multiple
  sites in one TYPO3 installation


.. _TODO:

TODO
----

- Fix the known issues

- Enable sorting in statistics module

- Enable grouping by file type in the statistics module (file type is
  already logged) so separate stats can be seen for video, audio etc.

- Make nice bar graphs in the statistics module


.. _Changelog:

Changelog
---------

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


.. _1-0-0:

1.0.0
^^^^^

.. container:: table-row

   Version
         1.0.0
   
   Changes
         Initial release


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

|img-2| EXT: Media player statistics - 2


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

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 316
.. :id: graphics1
.. :name: graphics1
.. :width: 523

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