{"id":5765,"date":"2009-06-03T12:14:10","date_gmt":"2009-06-03T12:14:10","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wibstats-statistics-for-wordpress-mu\/"},"modified":"2010-12-03T00:47:56","modified_gmt":"2010-12-03T00:47:56","slug":"wibstats-statistics-for-wordpress-mu","status":"closed","type":"plugin","link":"https:\/\/it.wordpress.org\/plugins\/wibstats-statistics-for-wordpress-mu\/","author":281441,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.5.5","stable_tag":"trunk","tested":"2.9.2","requires":"2.7","requires_php":"","requires_plugins":"","header_name":"WibStats","header_author":"Chris Taylor","header_description":"","assets_banners_color":"","last_updated":"2010-12-03 00:47:56","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.stillbreathing.co.uk\/donate\/","header_plugin_uri":"http:\/\/www.stillbreathing.co.uk\/wordpress\/wibstats-statistics-for-wordpress-mu\/","header_author_uri":"http:\/\/www.stillbreathing.co.uk","rating":0,"author_block_rating":0,"active_installs":20,"downloads":12049,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"0.5":"<p>WibStats version 0.5 enables WibStats for standard (i.e. standalone) Wordpress installations. It also introduces several new reports, fixes some bugs, changes the database schema and allows the use of shortcodes. This is a highly recommended upgrade.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2","0.4.2","0.4.3","0.4.4","0.5","0.5.1"],"block_files":[],"assets_screenshots":{"screenshot-9.png":{"filename":"screenshot-9.png","revision":"1566867","resolution":"9","location":"plugin"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"1566867","resolution":"5","location":"plugin"},"screenshot-7.png":{"filename":"screenshot-7.png","revision":"1566867","resolution":"7","location":"plugin"},"screenshot-11.png":{"filename":"screenshot-11.png","revision":"1566867","resolution":"11","location":"plugin"},"screenshot-10.png":{"filename":"screenshot-10.png","revision":"1566867","resolution":"10","location":"plugin"},"screenshot-6.png":{"filename":"screenshot-6.png","revision":"1566867","resolution":"6","location":"plugin"},"screenshot-12.png":{"filename":"screenshot-12.png","revision":"1566867","resolution":"12","location":"plugin"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1566867","resolution":"4","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1566867","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1566867","resolution":"3","location":"plugin"},"screenshot-8.png":{"filename":"screenshot-8.png","revision":"1566867","resolution":"8","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1566867","resolution":"1","location":"plugin"}},"screenshots":{"1":"The main Wibstats reports page","2":"Recent visitor locations, with visitor map popup","3":"Searches report","4":"Search term report","5":"Referrers report","6":"Referring site report","7":"Direct visitors report","8":"Pages viewed report","9":"Visitor locations report","10":"Visit times report","11":"Visitor environment report","12":"Session report"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[204,4109,521,871,2969],"plugin_category":[36,44,49],"plugin_contributors":[78953],"plugin_business_model":[],"class_list":["post-5765","plugin","type-plugin","status-closed","hentry","plugin_tags-buddypress","plugin_tags-graphs","plugin_tags-statistics","plugin_tags-visitors","plugin_tags-wordpress-mu","plugin_category-analytics","plugin_category-discussion-and-community","plugin_category-maps-and-location","plugin_contributors-mrwiblog","plugin_committers-mrwiblog"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wibstats-statistics-for-wordpress-mu.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-1.png?rev=1566867","caption":"The main Wibstats reports page"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-2.png?rev=1566867","caption":"Recent visitor locations, with visitor map popup"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-3.png?rev=1566867","caption":"Searches report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-4.png?rev=1566867","caption":"Search term report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-5.png?rev=1566867","caption":"Referrers report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-6.png?rev=1566867","caption":"Referring site report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-7.png?rev=1566867","caption":"Direct visitors report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-8.png?rev=1566867","caption":"Pages viewed report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-9.png?rev=1566867","caption":"Visitor locations report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-10.png?rev=1566867","caption":"Visit times report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-11.png?rev=1566867","caption":"Visitor environment report"},{"src":"https:\/\/ps.w.org\/wibstats-statistics-for-wordpress-mu\/trunk\/screenshot-12.png?rev=1566867","caption":"Session report"}],"raw_content":"<!--section=description-->\n<p>Wibstats is a Wordpress plugin that gives a Wordpress site, or each blog in a Wordpress MU or BuddyPress installation, their own visitor statistics. The data stored includes the page viewed, date and time of visit, visitors browser, operating system and screen resolution, and the geographic location of the visitor (country and city) where it is possible to determine that information.<\/p>\n\n<p>The plugin uses freely available APIs from several providers to determine the geographic location of the visitor. One of the APIs is chosen randomly for each visit to spread the load across each of the API providers.<\/p>\n\n<p>A range of graphs and tables are available to users to see the visitors to their blog. Wordpress MU site administrators also have the option to easily view the statistics for any particular blog, as well as for the main site.<\/p>\n\n<p>The plugin relies on the <code>wp_footer<\/code> action, normally used in the footer.php file of the theme. Without this action no visitor statistics will be stored. Please check each template available to your end users to ensure they all use the <code>wp_footer action<\/code>.<\/p>\n\n<h3>Shortcodes<\/h3>\n\n<p>WibStats allows you to include statistics from your site in your blog posts and pages. This is done with shortcodes, simple bits of text that set some parameters for the information to display. For example:<\/p>\n\n<pre><code>[wibstats report=\"popularsearches\"] \n<\/code><\/pre>\n\n<p>Will give you (for example);<\/p>\n\n<pre><code>Search          Visitors\nsearch 1        40%\nsearch 2        30%\nsearch 3        20%\nsearch 4        10% \n<\/code><\/pre>\n\n<p>Please note these examples here are not formatted correctly (due to Wordpress readme file restrictions). The proper code looks like this:<\/p>\n\n<pre><code>&lt;div class=\"wibstats_report [name of the report]\"&gt;\n&lt;table&gt;\n    &lt;thead&gt;\n        &lt;tr&gt;\n            &lt;th&gt;Column 1&lt;\/th&gt;\n            &lt;th&gt;Column 2&lt;\/th&gt;\n        &lt;\/tr&gt;\n    &lt;\/thead&gt;\n    &lt;tbody&gt;\n        &lt;tr&gt;\n            &lt;td&gt;Row 1, column 1&lt;\/td&gt;\n            &lt;td&gt;Row 1, column 2&lt;\/td&gt;\n        &lt;\/tr&gt;\n        &lt;tr&gt;\n            &lt;td&gt;Row 2, column 1&lt;\/td&gt;\n            &lt;td&gt;Row 2, column 2&lt;\/td&gt;\n        &lt;\/tr&gt;\n    &lt;\/tbody&gt;\n&lt;\/table&gt;\n&lt;\/div&gt;\n<\/code><\/pre>\n\n<p>Want another example? OK:<\/p>\n\n<pre><code>[wibstats report=\"recentcountries\"]\n<\/code><\/pre>\n\n<p>Gives:<\/p>\n\n<pre><code>Country             Time\nUnited Kingdom      9:22 pm\nUnited States       9:21 pm\nPortugal            9:18 pm\n<\/code><\/pre>\n\n<p>When showing country names WibStats will also show a small icon of the flag of that country.<\/p>\n\n<p>There are quite a few different reports you can show (these go in the <code>report=\"report-name-here\"<\/code> bit).<\/p>\n\n<ul>\n<li><code>popularcountries<\/code>\nThe most popular countries to visit your blog<\/li>\n<li><code>popularcities<\/code> \nThe most popular cities to visit your blog<\/li>\n<li><code>recentcountries<\/code> \nThe most recent countries to visit your blog<\/li>\n<li><code>recentcities<\/code> \nThe most recent cities to visit your blog<\/li>\n<li><code>popularbrowsers<\/code> \nThe most popular browsers to visit your blog<\/li>\n<li><code>popularplatforms<\/code> \nThe most popular platforms (operating systems) to visit your blog<\/li>\n<li><code>popularscreensizes<\/code> \nThe most popular screen sizes to visit your blog<\/li>\n<li><code>popularsearches<\/code> \nThe most popular search words which found your blog<\/li>\n<li><code>recentsearches<\/code> \nThe most recent search words which found your blog<\/li>\n<li><code>populardays<\/code> \nThe most popular days of the week that people visited your blog<\/li>\n<li><code>popularhours<\/code> \nThe most popular hours of the day that people visited your blog<\/li>\n<li><code>popularmonths<\/code> \nThe most popular months of the year that people visited your blog<\/li>\n<li><code>popularreferrers<\/code> \nThe most popular referring websites that sent visitors to your blog<\/li>\n<li><code>recentreferrers<\/code> \nThe most recent referring websites that sent visitors to your blog<\/li>\n<li><code>session<\/code> \nA breakdown of the data associated with the current visitor to your blog (their country, city, browser etc)<\/li>\n<\/ul>\n\n<p>A couple of other options allow you to configure these reports as they display on your posts\/pages.<\/p>\n\n<pre><code>size\n<\/code><\/pre>\n\n<p>Sets the number of items you want to show (minimum 1, maximum 100)<\/p>\n\n<pre><code>cache\n<\/code><\/pre>\n\n<p>Sets how long you want the report to be cached for. Caching means that the report isn't recalculated every time someone visits the page, meaning the page is a little bit faster to load.<\/p>\n\n<p>The <code>size<\/code> option is set in minutes, with \"0\" meaning not-cached-at-all (the report is recalculated every time someone visits the page it appears on) and \"-1\" for cached forever (the report is generated once then remains the same forever).<\/p>\n\n<p>So, a couple more examples:<\/p>\n\n<pre><code>[wibstats report=\"popularcities\" size=\"25\"]\n<\/code><\/pre>\n\n<p>This shows the top 25 most popular cities to visit your blog.<\/p>\n\n<pre><code>[wibstats report=\"recentsearches\" size=\"5\" cache=\"0\"]\n<\/code><\/pre>\n\n<p>This shows the top 5 latest search words which brought visitors to your blog, and is not cached at all.<\/p>\n\n<pre><code>[wibstats report=\"popularreferrers\" size=\"50\" cache=\"-1\"]\n<\/code><\/pre>\n\n<p>This shows the top 50 most popular referring websites (sites that have a link to your blog) and is cached forever. This means the report will show what the top referring sites are now and will never be updated.<\/p>\n\n<h3>To-do<\/h3>\n\n<ul>\n<li>Stats-by-email, where Wibstats will email you daily, weekly or monthly with the latest statistics.<\/li>\n<li>More ways to slice and dice the existing data. More graphs, perhaps using a serious graphic system (Flot, perhaps).<\/li>\n<li>A \"live\" view showing who is visiting your blog Right Now<\/li>\n<li>Storing the exit time for each page, so reports on how long people spent on your site can be built<\/li>\n<li>More reports on average pages per visitor<\/li>\n<\/ul>\n\n<p>Any further ideas will be gratefully received.<\/p>\n\n<!--section=installation-->\n<p>For standard Wordpress:<\/p>\n\n<p>The plugin should be placed in your \/wp-content\/plugins\/ directory, so it looks like this:<\/p>\n\n<pre><code>\/wp-content\/plugins\/\n\/wp-content\/plugins\/wibstats\/\n\/wp-content\/plugins\/wibstats\/wibstats.php\n\/wp-content\/plugins\/wibstats\/wibstats-includes\/\n<\/code><\/pre>\n\n<p>For Wordpress MU or BuddyPress:<\/p>\n\n<p>The plugin should be placed in your \/wp-content\/mu-plugins\/ directory (<em>not<\/em> \/wp-content\/plugins\/) so it looks like this:<\/p>\n\n<pre><code>\/wp-content\/mu-plugins\/\n\/wp-content\/mu-plugins\/wibstats.php\n\/wp-content\/mu-plugins\/wibstats-includes\/\n<\/code><\/pre>\n\n<p>Wibstats for Wordpress MU requires no activation. The database table for each blog should be created automatically.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Why did you write this plugin?<\/dt>\n<dd><p>I looked around for a suitable statistics plugin for one of my websites (wibsite.com) but was disappointed in the options available. In fact I tried one of the most popular ones but it was very badly written and I had to remove it as it was killing my server. So, I decided to write one myself.<\/p><\/dd>\n<dt>The stats aren't working? What's gone wrong?<\/dt>\n<dd><p>There are two reasons visitor stats might not be working:<\/p>\n\n<p>1) The wp_footer() action is not being fired in your template. Please ensure that the wp_footer() action is in your footer.php file.<\/p>\n\n<p>2) The statistics tables could not be created. If your Wordpress database user does not have CREATE TABLE provileges you will need to run these two SQL scripts (replacing [prefix] with your Wordpress database prefix, for example \"wp_\"). For Wordpress MU the [prefix] needs to be replaced with the base database prefix AND the blog id (for example \"wp_123\"):<\/p>\n\n<pre><code>CREATE TABLE [prefix]wibstats_sessions ( \nid mediumint( 9 ) NOT NULL AUTO_INCREMENT,\ntimestamp bigint( 11 ),\nipaddress VARCHAR( 24 ),\nsessionid VARCHAR( 50 ),\ncolordepth VARCHAR( 3 ),\nscreensize VARCHAR( 12 ),\nbrowser VARCHAR( 50 ),\nversion VARCHAR( 12 ),\nplatform VARCHAR( 50 ),\npage VARCHAR( 255 ),\ntitle varchar( 255 ),\nreferrer VARCHAR( 255 ),\nreferrer_domain VARCHAR( 255 ),\nterms VARCHAR( 255 ),\ncity VARCHAR( 50 ),\ncountry VARCHAR( 50 ),\ncountrycode VARCHAR( 3 ),\nlatitude FLOAT( 10,6 ),\nlongitude FLOAT( 10,6 ),\nPRIMARY KEY  ( id ),\nKEY timestamp ( timestamp ),\nKEY ipaddress ( ipaddress ),\nKEY sessionid ( sessionid ),\nKEY colordepth ( colordepth ),\nKEY screensize ( screensize ),\nKEY browser ( browser ),\nKEY version ( version ),\nKEY platform ( platform ),\nKEY page ( page ),\nKEY title ( title ),\nKEY referrer ( referrer ),\nKEY referrer_domain ( referrer_domain ),\nKEY terms ( terms ),\nKEY city ( city ),\nKEY country ( country ),\nKEY countrycode ( countrycode ),\nKEY latitude ( latitude ),\nKEY longitude ( longitude )\n);\n\nCREATE TABLE [prefix]wibstats_pages ( \nid mediumint( 9 ) NOT NULL AUTO_INCREMENT,\ntimestamp bigint( 11 ),\npage VARCHAR( 255 ),\ntitle varchar( 255 ),\nsessionid VARCHAR( 50 ),\nreferrer VARCHAR( 255 ),\nreferrer_domain VARCHAR( 255 ),\nterms VARCHAR( 255 ),\nPRIMARY KEY  ( id ),\nKEY timestamp ( timestamp ),\nKEY page ( page ),\nKEY title ( title ),\nKEY sessionid ( sessionid ),\nKEY referrer ( referrer ),\nKEY referrer_domain ( referrer_domain ),\nKEY terms ( terms )\n);\n<\/code><\/pre>\n\n<p>For more information and support leave a comment here: http:\/\/www.stillbreathing.co.uk\/projects\/mu-wibstats\/<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p>0.5.6 (2010\/12\/03) Fixed bug in Plugin Register caused by latest version of WordPress<\/p>\n\n<p>0.5.5 (2010\/15\/14) Updated plugin URI<\/p>\n\n<p>0.5.4 (2010\/04\/20) Implemented new Plugin Register version.<\/p>\n\n<p>0.5.3 Fixed bug with Google Maps API key. Fixed duplicate admin menu option bug. Added Plugin Register code.<\/p>\n\n<p>0.5.2 Fixed bugs with visitor tracking image and Google map<\/p>\n\n<p>0.5.1 Added a support link and donate button<\/p>\n\n<p>0.5 Completely rewrote the plugin, which now works with standard Wordpress. Added new reports, fixed errors with old reports, changed menu system. Added shortcodes so statistics can be included in blog posts or pages.<\/p>\n\n<p>0.4.4 Fixed bug which stopped tables being created automatically<\/p>\n\n<p>0.4.3 Fixed bug which led to divide by zero errors<\/p>\n\n<p>0.4.2 Fixed bug which hid the recent visitors map<\/p>\n\n<p>0.4.1 Added link to options screen, fixed bug with 24 hour report timezone offset<\/p>\n\n<p>0.4 Added referrer report, cleaned up country reports, added option to choose time offset to show visitor times relative to the viewer, added breakdown of search, referred and direct visitors<\/p>\n\n<p>0.3 Added Google maps, visitor and page view percentage change numbers, view by referrer\/search term\/page\/visitor environment, session report and many more improvements<\/p>\n\n<p>0.2 Added date range views (24 hour, 14 day, 12 week)<\/p>","raw_excerpt":"Wibstats is a Wordpress plugin that gives each blog in a Wordpress, Wordpress MU or BuddyPress installation their own visitor statistics.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/5765","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=5765"}],"author":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mrwiblog"}],"wp:attachment":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=5765"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=5765"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=5765"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=5765"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=5765"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=5765"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}