tdVisitorCounterPlugin
0.1.6beta
for sf 1.4sf 1.3 and Doctrine
MIT
The tdVisitorCounterPlugin is a symfony plugin that provides funcionalities for easy visitor counting feature, including schema, libs, interface and a flash panel to display latest visiting stats.
This plugin is a part of TD CMF and is based on Doctrine ORM.
Developers
| Name |
Status |
Email |
Tomasz Ducin |
lead |
moc.liamg <<ta>> nicud.zsamot
|
License
Copyright (c) 2009 Tomasz Ducin
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Releases for sf 1.4
| Version |
License |
API |
Released |
|
0.1.7beta
|
MIT |
0.1.0beta
|
21/02/2010 |
|
0.1.6beta
|
MIT |
0.1.0beta
|
08/02/2010 |
|
0.1.5beta
|
MIT |
0.1.0beta
|
24/01/2010 |
|
0.1.4beta
|
MIT |
0.1.0beta
|
22/01/2010 |
|
0.1.3beta
|
MIT |
0.1.0beta
|
31/12/2009 |
|
0.1.2beta
|
MIT |
0.1.0beta
|
28/12/2009 |
|
0.1.1beta
|
MIT |
0.1.0beta
|
26/12/2009 |
|
0.1.0beta
|
MIT |
0.1.0beta
|
24/12/2009 |
Releases for sf 1.3
| Version |
License |
API |
Released |
|
0.1.7beta
|
MIT |
0.1.0beta
|
21/02/2010 |
|
0.1.6beta
|
MIT |
0.1.0beta
|
08/02/2010 |
|
0.1.5beta
|
MIT |
0.1.0beta
|
24/01/2010 |
|
0.1.4beta
|
MIT |
0.1.0beta
|
22/01/2010 |
|
0.1.3beta
|
MIT |
0.1.0beta
|
31/12/2009 |
|
0.1.2beta
|
MIT |
0.1.0beta
|
28/12/2009 |
|
0.1.1beta
|
MIT |
0.1.0beta
|
26/12/2009 |
|
0.1.0beta
|
MIT |
0.1.0beta
|
24/12/2009 |
| Name |
Channel |
Version |
| stOfcPlugin |
plugins.symfony-project.org |
0.9.1- |
| tdCorePlugin |
plugins.symfony-project.org |
0.1.7- |
Changelog for release 0.1.6 - 08/02/2010
- daily visitors chart max value bug fixed
Other releases
Release 0.1.7 - 21/02/2010
- fixed wrong i18n catalogue name bug
Release 0.1.6 - 08/02/2010
- daily visitors chart max value bug fixed
Release 0.1.5 - 24/01/2010
- included translations
- improved documentation
Release 0.1.4 - 22/01/2010
- fixed daily stats charts performance
Release 0.1.3 - 31/12/2009
- added translation mechanism (with default English and Polish translation provided)
- fixed day stats limit (DQL query)
- updated documentation
Release 0.1.2 - 28/12/2009
- bound to tdCorePlugin
- updated fixtures to use tdRandomDataGenerator class
- cookie name moved to configuration
Release 0.1.1 - 26/12/2009
- separated tdVisitorManager class for performing visits marking
- number of days/months in a chart bug fixed
- dependency set for stOfcPlugin
- changeable life time for visitor cookie
- added getCount of all visits
- expanded readme: sample stats images
- making up documentation
Release 0.1.0 - 24/12/2009
tdVisitorCounterPlugin
Provides funcionalities for easy visitor counting feature, including schema,
libs, interface and a flash panel to display latest visiting stats.
This plugin is a part of TD CMF and is based on Doctrine ORM.
Installation
Install the plugin via the subversion repository by executing the following
command from the project root directory:
$ svn co http://svn.symfony-project.com/plugins/tdVisitorCounterPlugin/trunk plugins/tdVisitorCounterPlugin
or by using the default symfony plugin install command:
$ ./symfony plugin:install -s beta tdVisitorCounterPlugin
as the actual release is in its beta stage. There are no assetsto ublish for
this plugin since it relies on stOfcPlugin (open flash charts).
Usage
Re-run building your model (td_counter table holds data about users visits).
If you wish, you may generate some fixture data for the visitors counter
(using data/fixtures/fixtures.yml file).
enable the tdVisitorCounter module in your backend application, so that you
may use the statitics about user visits using open flash chart.
make sure the config/routing.yml file is uncommented (otherwise you will
have to create your own routing entries forwarding to index action of
tdVisitorCounter module).
append the following code inside your main frontend application template
(e. g. layout.php):
tdVisitorManager::markVisitor();
which adds a single visitor entry to the database. This mechanisms relies on
browser cookies - if the visited cookie doesn't exist, such a cookie is
created (existing 3 minutes by default) and an entry to the td_counter table
is added.
Configuration
You can modify settings of the tdVisitorCounterPlugin in the
config/tdVisitorCounterPluginConfiguration.class.php file:
td_visitor_counter_cookie - name of the cookie used for visitors counting.
td_visitor_counter_months - number of last months shown on the chart.
td_visitor_counter_days - number of last days shown on the chart.
td_visitor_counter_cookie_interval - expire time of a visitor cookie.
Statistics demo
The plugin is provided with two predefined charts:


Translations
You may translate tdVisitorCounter module to your own language by creating
td.XX.xml file under modules/tdVisitorCounter/i18n
directory (where XX is the language code). So far, English language is the
default one and additionally Polish translationis provided.
Dependencies