=== Count per Day ===
Contributors: Tom Braider
Tags: counter, count, posts, visits, reads, dashboard, widget, shortcode
Requires at least: 2.7
Tested up to: 3.0.3
Stable tag: 2.15
License: Postcardware
Donate link: http://www.tomsdimension.de/postcards
Visit Counter, shows reads per page, visitors today, yesterday, last week, last months and other statistics.
== Description ==
* count reads and visitors
* shows reads per page
* shows visitors today, yesterday, last week, last months and other statistics on dashboard
* shows country of your visitors
* you can show these statistics on frontend (e.g. on sidebar) too
* if you use Wordpress < 2.7 please use Count-per-Day v1.4
* Plugin: http://www.tomsdimension.de/wp-plugins/count-per-day
* Donate: http://www.tomsdimension.de/postcards
"Count per Day" counts 1 visit per IP per day. So any reload of the page don't increment the counter.
= Languages, Translators =
- German - 100% - me ;) -
- Italian - 100% - Gianni Diurno - http://gidibao.net
- Polish - 100% - LeXuS - http://intrakardial.de
- Russian - 100% - Ilya Pshenichny - http://iluhis.com
- Dansk - 95% - Georg S. Adamsen - http://www.blogos.dk
- Dansk 2* - 95% - Jonas Thomsen - http://jonasthomsen.com
- Dutch NL - 95% - Rene - http://wpwebshop.com
- Espanol - 95% - Juan Carlos del Río -
- France - 95% - Bjork - http://www.habbzone.fr
- Swedish - 95% - Magnus Suther - http://www.magnussuther.se
- Portuguese BR - 95% - Beto Ribeiro - http://www.sevenarts.com.br
- Uzbek - 60% - Alisher -
- Belarus - 40% - Marcis Gasuns -
*) Rename cpd-da_DK-2.mo to cpd-da_DK.mo in "locale" directory to use the second dansk translation.
== Installation ==
1. unzip plugin directory into the '/wp-content/plugins/' directory
1. activate the plugin through the 'Plugins' menu in WordPress
1. after every update you have to deactivate and reactivate the plugin to update some settings!
1. if you want to use the GeoIP function you have to download the GeoIP-database on options page
The activation will create or update 3 tables wp_cpd_counter, wp_cpd_counter_useronline and wp_cpd_notes.
**Configuration**
See the Options Page and check the default values. It's easy. :)
Install optional GeoIP database to show countries of your visitors.
If "Auto counter" is on reads will count without any changes on template.
== Frequently Asked Questions ==
= Need Help? Find Bug? =
read and write comments on http://www.tomsdimension.de/wp-plugins/count-per-day
== Screenshots ==
1. Statistics on Count-per-Day Dashboard
2. Options
3. Widget sample
== Arbitrary section ==
**Shortcodes**
You can use these shortcodes in the content while writing you posts to show a number.
[CPD_READS_THIS]
[CPD_READS_TOTAL]
[CPD_READS_TODAY]
[CPD_READS_YESTERDAY]
[CPD_READS_LAST_WEEK]
[CPD_READS_THIS_MONTH]
[CPD_READS_PER_MONTH]
[CPD_READS_CHART]
[CPD_VISITORS_TOTAL]
[CPD_VISITORS_ONLINE]
[CPD_VISITORS_TODAY]
[CPD_VISITORS_YESTERDAY]
[CPD_VISITORS_LAST_WEEK]
[CPD_VISITORS_THIS_MONTH]
[CPD_VISITORS_PER_MONTH]
[CPD_VISITORS_PER_DAY]
[CPD_VISITORS_PER_POST]
[CPD_VISITORS_CHART]
[CPD_FIRST_COUNT]
[CPD_MOST_VISITED_POSTS]
[CPD_POSTS_ON_DAY]
[CPD_CLIENTS]
[CPD_COUNTRIES]
[CPD_REFERERS]
[CPD_POSTS_ON_DAY date="2010-10-06" limit="3"]
date (optional), format: year-month-day, default = today
limit (optional) = max records to show, default = all
**Functions**
You can place these functions in your template.
Place functions within post-loop (e.g. in single.php)
Use '<?php if(method_exists($count_per_day, "show")) $count_per_day->show(); ?>' to check if plugin is activated.
'show( $before, $after, $show, $count )'
* $before = text before number e.g. '<p>' (default "")
* $after = text after number e.g. 'reads</p>' (default " reads")
* $show = true/false, "echo" complete string or "return" number only (default true)
* $count = true/false, false will not count the reads (default true)
'count()'
* only count reads, without any output
* cpdShow call it
'getFirstCount( $frontend )'
* shows date of first count
* $frontend: 0 echo, 1 return output
'getUserPerDay( $days, $frontend )'
* shows average number of visitors per day of the last _$days_ days
* default on dashboard (see it with mouse over number) = "Latest Counts - Days" in options
* $frontend: 0 echo, 1 return output
'getReadsAll( $frontend )'
* shows number of total reads
* $frontend: 0 echo, 1 return output
'getReadsToday( $frontend )'
* shows number of reads today
* $frontend: 0 echo, 1 return output
'getReadsYesterday( $frontend )'
* shows number of reads yesterday
* $frontend: 0 echo, 1 return output
'getReadsLastWeek( $frontend )'
* shows number of reads last week (7 days)
* $frontend: 0 echo, 1 return output
'getReadsThisMonth( $frontend )'
* shows number of reads current month
* $frontend: 0 echo, 1 return output
'getReadsPerMonth( $frontend )'
* lists number of reads per month
* $frontend: 0 echo, 1 return output
'getUserAll( $frontend )'
* shows number of total visitors
* $frontend: 0 echo, 1 return output
'getUserOnline( $frontend )'
* shows number of visitors just online
* $frontend: 0 echo, 1 return output
'getUserToday( $frontend )'
* shows number of visitors today
* $frontend: 0 echo, 1 return output
'getUserYesterday( $frontend )'
* shows number of visitors yesterday
* $frontend: 0 echo, 1 return output
'getUserLastWeek( $frontend )'
* shows number of visitors last week (7 days)
* $frontend: 0 echo, 1 return output
'getUserThisMonth( $frontend )'
* shows number of visitors current month
* $frontend: 0 echo, 1 return output
'getUserPerMonth( $frontend )'
* lists number of visitors per month
* $frontend: 0 echo, 1 return output
'getUserPerPost( $limit = 0, $frontend )'
* lists _$limit_ number of posts, -1: all, 0: get option from DB, x: number
* $frontend: 0 echo, 1 return output
'getMostVisitedPosts( $days, $limits, $frontend )'
* shows a list with the most visited posts in the last days
* $days = days to calc (last days), 0: get option from DB
* $limit = count of posts (last posts), 0: get option from DB
* $frontend: 0 echo, 1 return output
'getVisitedPostsOnDay( $date = 0, $limit = 0, $show_form, $show_notes )'
* shows visited pages at given day
* $date day in MySQL date format yyyy-mm-dd, 0 today
* $limit count of posts
* $show_form show form for date selection, default on, in frontend set it to 0
* $show_notes show button to add notes in form, default on, in frontend set it to 0
'getClients( $frontend )'
* shows visits per client/browser in percent
* clients are hardcoded in function but easy to change ;)
* $frontend: 0 echo, 1 return output
'getReferers( $limit = 0, $frontend )'
* lists top _$limit_ referers, 0: get option from DB, x: number
* $frontend: 0 echo, 1 return output
**GeoIP**
* With the GeoIP addon you can associate your visitors to an country using the ip address.
* In the database a new column 'country' will be insert on plugin activation.
* On options page you can update you current visits. This take a while! The Script checks 100 IP addresses at once an reload itself until less then 100 addresses left. Click the update button to check the rest.
* If the rest remains greater than 0 the IP address is not in GeoIP database (accuracy 99.5%).
* You can update the GeoIP database from time to time to get new IP data. This necessitates write rights to geoip directory (e.g. chmod 777).
* If the automatically update don't work download GeoIP.dat.gz and extract it to the "geoip" directory.
* More information about GeoIP on http://www.maxmind.com/app/geoip_country
== Changelog ==
= 2.15 =
+ New: functions and shortcodes [CPD_READS_THIS_MONTH] [CPD_VISITORS_THIS_MONTH]
+ New: reads last week, reads this month and visitors this month in widget
+ Bugfix: Ajax counter for cached pages is now multi widget compatible
+ Bugifx: "Visitors per month" showed to many visitors
+ Language updates: Polish, Russia
= 2.14 =
+ New: multi widget compatible, place the widget several times with individual settings
+ New: WordPress Multisite compatible, networkwide activation creates tables in all blogs
+ New: list reads per month
+ New: functions and shortcodes [CPD_POSTS_ON_DAY] [CPD_READS_PER_MONTH] [CPD_READS_LAST_WEEK]
+ New: show/hide local referers
+ New: optional deactivation of saving clients and referers to save space in the database
+ New: debug mode per URL parameter (?debug=1)
+ Bugfix: GeoIP database update, problem with local IP adresses
+ Bugfix: Userlevel/Capabilities
+ Bugfix: yesterday reads and visitors (timezone)
+ Bugfix: links on mass bots page
+ little cosmetics
+ Language update: Italian
= 2.13.1 =
+ New Language: Espanol, thanks to Juan Carlos del Río
+ Bugfix: problems with MySQL 4.x
+ Bugfix: changed error handling
= 2.13 =
+ New: Top referers
+ Bugfix: Thickbox only in backend needed, RTL on he_IL was broken
+ Bugfix: startpage was not counted everywhere
+ Language update: Portuguese (Brazil)
= 2.12 =
+ New: Flags images as sprite included
+ New: improved "Browsers" management, set your own favorites
+ New: improved "Mass Bots" management, more infos
+ New: "Visitors per country" list
+ New: "Visitors per day" list/chart
+ New: works now in cached pages too (optional, BETA)
+ New: easier switch to debug mode on settings
+ Language update: Dansk, Dutch, France, German, Italian, Russian, Swedish
+ Bugfix: CleanDB delete by IP function changed
+ Bugfix: because windows symlink problem plugin dir is hardcoded as 'count-per-day' now
+ Code updated (deprecated functions)
= 2.11 =
+ Bugfix: GeoIP, update old data used wrong IP format
+ Bugfix: CleanDB deletes to many entries (index, categories, tags)
+ Bugfix: date/timezone problem
+ New: anonymous IP addresses (last bit, optional)
+ New: simple scroll function in charts
+ New language: Polish, thanks to LeXuS
= 2.10.1 =
+ New language: Dutch, thanks to Rene http://wpwebshop.com
= 2.10 =
+ New language: French, thanks to Bjork http://www.habbzone.fr
+ New: Worldmap to visualize visitors per country
+ New: Shortcodes to add lists and charts to posts and pages, check counter.css too
+ Bugfix: mysql_fetch_assoc() error, non existing options
+ Post edit links in lists for editors only (user_level >= 7)
= 2.9 =
+ New: little note system to mark special days
+ New: functions to get reads/page views total, today and yesterday
+ Language update: Italian, thanks to Gianni Diurno
+ Language update: Portuguese (Brazil), thanks to Lucato
+ Language update: Swedish, thanks to Magnus Suther
+ Language update: Dansk, thanks to Jonas Thomsen
+ Language update: German
= 2.8 =
+ New: set user level until CpD will count loged users
+ New: link to plugin page on Count per Day dashboard
+ New: click on a bar in the charts reload the page with given date for 'Visitors per day' metabox
+ New language: Swedish, thanks to Magnus
+ New language: Dansk, thanks to GeorgeWP
= 2.7 =
+ Bugfix: date/timezone problem
+ New: change start date and start count on option page
+ New: "edit post" links on lists
+ New: new list shows visitors per post on user defined date
+ New: link to plugin page
= 2.6 =
+ languages files now compatible with Wordpress 2.9
+ New: improved CSS support for RTL blogs (e.g. arabic)
= 2.5 =
+ BACKUP YOUR COUNTER DATABASE BEFORE UPDATE!
+ Change: some big changes on database and functions to speed up mysql queries. This will take a while on activation!
+ New: "Mass Bot Detector" shows and deletes clients that view more than x pages per day
+ New: see count and time of queries if CPD_DEBUG is true (on top of counter.php)
+ Bugfix: cleanDB by IP now works
+ Language update: Portuguese (Brazil), thanks to Beto Ribeiro
= 2.4.2 =
+ Bugfix: mysql systax error
+ Bugfix: no country data was stored (GeoIP), use "Update old counter data" on options page
= 2.4 =
+ Bugfix: works with PHP 4.x again (error line 169)
+ Change: some functions now faster
+ New: GeoIP included. You have to load GeoIP.dat file on option page before you can use it.
+ Language updates: Italian (Gianni Diurno) and German
= 2.3.1 =
+ Bugfix: counter do not work without GeoIP Addon (nonexisting row 'country' in table)
= 2.3 =
+ New: chart "visitors per day"
+ New: counts index pages: homepage, categories, tags (if autocount is on)
+ New: visits per client/browser in percent
+ New: added some parameters to functions to overwrite default values
+ New language: Usbek, thanks to Alisher
= 2.2 =
+ Change: USER_AGENT must have > 20 chars, otherwise we call it "bot"
+ New: optional GeoIP addon to show page views per country - see Section "GeoIP addon"
= 2.1 =
+ New: custom names on widget
+ New: function "first count" on widget
+ little changes on german translation
= 2.0 =
+ New: sidebar widget
+ New: reset button to set all counter to 0
+ New: custom number of "reads per post" on dashboard page
+ New: little chart of "reads per day" on dashboard page
+ New: reads in post and page lists (optional)
+ New: most visited posts in last days on dashboard page
+ New: recognize bots by IP address
+ New: movable metaboxes on dashboard page
+ New: clean function now deletes counter of deleted pages too
+ Bugfix: updates online counter on every load
+ Bugfix: now empty user agents/clients will not be count
+ change options to array
+ create class, update/clean up/rename functions
= 1.5.1 =
+ New language: Belorussian, thanks to Marcis Gasuns
= 1.5 =
+ New: Dashboard Widget
+ WP 2.7 optimized, for WP<2.7 please use CPD 1.4
= 1.4 =
+ New: uninstall function of WP 2.7 implemented
+ litle changes on layout to be suitable for WP 2.7
= 1.3 =
+ New: you can delete old data if you add a new bot string
+ Bugfix: Bot check was case-sensitive
+ New language: Portuguese, thanks to Filipe
= 1.2.3 =
+ Bugfix: autocount endless looping
= 1.2.2 =
+ New language: Italian, thanks to Gianni Diurno
= 1.2.1 =
+ Bugfix: Error 404 "Page not found" with "auto count"
= 1.2 =
+ Bugfix: tables in DB were not be created every time (seen on mysql < 5)
+ New: "auto count" can count visits without changes on template
= 1.1 =
+ Languages: english, german
+ HTTP_USER_AGENT will be saved, identification of new search bots
+ Stylesheet in file counter.css
= 1.0 =
+ first release