WordPress.org

Arbitrary section

Shortcodes

You can use these shortcodes in the content of your posts to show a number or list or in your theme files while adding e.g. '<?php echo do_shortcode("[THE_SHORTCODE]"); ?>'.

[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_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_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 [CPD_MAP width="500" height="340" what="reads" min=1] - width and height: size, default 500x340 px - what: map content - reads|visitors|online, default reads - min: 1 (disable title, legend and zoombar), default 0

Functions

You can place these functions in your template. Use

<?php
global $count_per_day;
if(method_exists($count_per_day,"show")) echo $count_per_day->getReadsAll(true);
?>

to check if plugin is activated.

'show( $before, $after, $show, $count, $page )'

• $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)
• $page (optional) PostID

'count()'

• only count reads, without any output
• 'show' call it

'getFirstCount( $return )'

• shows date of first count
• $return: 0 echo, 1 return output

'getUserPerDay( $days, $return )'

• 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
• $return: 0 echo, 1 return output

'getReadsAll( $return )'

• shows number of total reads
• $return: 0 echo, 1 return output

'getReadsToday( $return )'

• shows number of reads today
• $return: 0 echo, 1 return output

'getReadsYesterday( $return )'

• shows number of reads yesterday
• $return: 0 echo, 1 return output

'getReadsLastWeek( $return )'

• shows number of reads last week (7 days)
• $return: 0 echo, 1 return output

'getReadsThisMonth( $return )'

• shows number of reads current month
• $return: 0 echo, 1 return output

'getReadsPerMonth( $return )'

• lists number of reads per month
• $return: 0 echo, 1 return output

'getUserAll( $return )'

• shows number of total visitors
• $return: 0 echo, 1 return output

'getUserOnline( $frontend, $country, $return )'

• shows number of visitors just online
• $frontend: 1 no link to map
• $country: 0 number, 1 country list
• $return: 0 echo, 1 return output

'getUserToday( $return )'

• shows number of visitors today
• $return: 0 echo, 1 return output

'getUserYesterday( $return )'

• shows number of visitors yesterday
• $return: 0 echo, 1 return output

'getUserLastWeek( $return )'

• shows number of visitors last week (7 days)
• $return: 0 echo, 1 return output

'getUserThisMonth( $return )'

• shows number of visitors current month
• $return: 0 echo, 1 return output

'getUserPerMonth( $frontend, $return )'

• lists number of visitors per month
• $frontend: 1 no links
• $return: 0 echo, 1 return output

'getUserPerPost( $limit, $frontend, $return )'

• lists $limit number of posts, -1: all, 0: get option from DB, x: number
• $frontend: 1 no links
• $return: 0 echo, 1 return output

'getMostVisitedPosts( $days, $limits, $frontend, $postsonly, $return )'

• 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: 1 no links
• $postsonly: 0 show, 1 don't show categories and taxonomies
• $return: 0 echo, 1 return output

'getVisitedPostsOnDay( $date, $limit, $show_form, $show_notes, $frontend, $return )'

• 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
• $frontend: 1 no links
• $return: 0 echo, 1 return output

'getClients( $return )'

• shows visits per client/browser in percent
• $return: 0 echo, 1 return output

'getReferers( $limit, $return, $days )'

• lists top $limit referrers of the last $days days, 0: get option from DB, x: number
• $return: 0 echo, 1 return output

'getMostVisitedPostIDs( $days, $limit, $cats, $return_array )'

• $days last x days, default = 365
• $limit return max. x posts, default = 10
• $cats IDs of categories to filter, array or number
• $return_array true returns an array with Post-ID, title and count, false returns comma separated list of Post-IDs

'function getMap( $what, $width, $height, $min )'

• gets a world map
• $what visitors|reads|online
• $width size in px
• $height size in px
• $min : 1 disable title, legend and zoombar

'getDayWithMostReads( $return )'

• shows day with most Reads
• $return: 0 echo, 1 return output

'getDayWithMostVisitors( $return )'

• shows day with most Visitors
• $return: 0 echo, 1 return output

GeoIP

• With GeoIP 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