=== CyStats === Contributors: Michael Weingaertner Donate link: http://www.cywhale.de/ Tags: statistics,operating system,referer,browser,robots,feedreader,counter Requires at least: 2.1.2 Tested up to: 2.3 Stable tag: 0.8.7 Statistics plugin including information hits,visits,operating system,browser,dimensions,earchengines and earchwords,pages,time and more,including template tags == Description == CyStats is a statistic plugin integrated in the WordPress admin area. Features are currently: 1. Multi language support (currently english, german supported), tracking of all blog visits, 404 error pages, single pages. 1. Optional tracking of admin area visits, optional tracking of javacript dependant information such as brower window dimensions, screen dimensions, color depth 1. Template tags for displaying most recent comments, post visits, most visited posts and more 1. Overview: hits/Visits with and without robots today, week, month, year (incuding calculated difference to last day,week,...) 1. Overview: every single tracked hit including time, ip, browser, operating system, screen resolution, page type (blog, 404,...), time, request method (GET/POST), requeted page, referer 1. Overview: database statistic (tables, sizes,...),most commented posts, most visited posts, most active commentators, recent commented posts, general blog statistics (categories, posts, averages,...) 1. Overview: browser (with/without version), operating system, screen dimensions, window dimenions, color depth 1. Overview: referer, internal, external, searchengine referer 1. Overview: searchengine robots, email/feedreader, general tools, unknown user agents 1. Overview: external and blog internal search words 1. Overview: entry pages, most vissited pages/posts, 404 resulting pages, WordPress page types (single, feed, home, month,...) 1. Overview: hits/visits day, week,month, year, weekday, hour 1. Overview: feed statistics, feed reading IPs general, feed reading IPs today, most requeted feeds 1. Options: Enable javascript dependant tracking, enable javascript dependant tracking, enable tracking of local referers, database cleaning interval and time delta,... == Installation == This section describes how to install the plugin and get it working. 1. Upload directory `cystats` to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Be sure **``** exits on the blog templates, most likely in `footer.php` 1. Edit database settings in `cystats/logger.php` according to your databae login data (only required for javascript dependant logging) 1. Edit cystats settings according to your needs == Frequently Asked Questions == = Why do I need to edit the database settings again? = CyStats could take WordPress database settings from wp-settings.php but this would result in an extra amount of mysql queries (~15) and a nearly doubled execution time on every page request. = Why does the text 'CyStats Statistics Wrapper Image' appear on my Blog? = This is the alternative text for the 1x1 transparent image used by the javascript-dependant component used to get colordepth, screen dimensions and browser window dimensions if enabled. If you see this text something went wrong while trying to get/write those information, most likely cystats was not able to open the database connection. In this case please check the database settings in 'logger.php'. = Are there translations for my native language ? = Currently there are english and german translations included in the cystats download package, a french translation is provided by [Kylix Studio](http://serge-rauber.fr/31-traduction-cystats "Kylix Studio CyStats french translation"). = Are there any template tags I can use in my site ? = Yes there are. All template tags are located in the file includes/template-functions.php. You can use this functions within your template files inserting it like this: ``. Currently supported template tags are: Returning numbers: 1. `cystats_getPostVisitsByID($id)` 1. `cystats_countPosts()` 1. `cystats_countComments()` 1. `cystats_countCategories()` 1. `cystats_countUsers()` 1. `cystats_countAuthors()` 1. `cystats_countPages()` 1. `cystats_countLinks()` 1. `cystats_countFeedreadersToday()` 1. `cystats_countUsersOnline()` 1. `cystats_firstPostDays()` 1. `cystats_countAvgPostsPerDay()` 1. `cystats_countAvgCommentsPerDay()` 1. `cystats_countVisits($mode)`, $mode cat be set to 'today', 'yesterday', 'week', 'month', 'year', 'all' Returning lists, $pre and $post may contain formatting strings like '< l i >', '< / l i >': 1. `cystats_getRecentPosts($limit, $pre, $pos)` 1. `cystats_getRecentCommented($limit, $pre, $pos)` 1. `cystats_getMostVisited($limit, $pre, $pos)` 1. `cystats_getMostCommented($limit, $pre, $pos)` 1. `cystats_getTopCommenters($limit, $pre, $pos)` 1. `cystats_getUsersOnline($limit=FALSE, $pre, $pos)` 1. `cystats_getClientTypeOnline($type, $limit=FALSE, $pre, $pos)` Returning lists but provide special formatting tags: 1. `cystats_getMostCommentedExt($limit, $pattern)`, $pattern may contain %post_permalink%, %post_title%, %post_comments% 1. `cystats_getRecentCommentedExt($limit, $pattern)`, $pattern may contain %comment_post_permalink%, %comment_post_title%, %comment_author%, %comment_author_url%, %comment_date%, %comment_time% = Do I have to pay for CyStats ? = No. CyStats can be used for free. I'm developing CyStats because I like working on it and I like the interaction between users and developer, I do not have to pay any fees with money I made with CyStats. If you like CyStats and use it on your site feel free to leave a donation using the paypal link on [the cystats download page](http://www.cywhale.de/cystats-wordpress-statistik-plugin/cystats-download-und-installation/ "CyStats"), I'd appreciate it, but you definately do NOT have to do this. == Screenshots == 1. CyStats index page, day/week/month/year hits and visits, with and without robots, list of the most recent page requests 2. CyStats blog statistics, top commented posts, recent commented posts, database statistics... 3. CyStats clients page, browser/ browser versions, screen, window, colordepth