Major Additions - psiStats 2006 (The New vBStats for vBulletin 3.5.x - 3.8.x)

I no longer support my hacks. Please feel free to update them and release new versions elsewhere as long as I get the credit for the original modification.

/*===================================*\
|| psiStats 2009
||
|| Author : Anton Kanevsky
|| Works on : vBulletin 3.5.x - 3.8.x
|| Released : Feb 28, 2010
||
|| Time required to install: 1 minute
|| Difficulty: easy
\*===================================*/

DESCRIPTION

A sophisticated statistics module for your vBulletin board.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

STATISTICS

File Uploads: 1
Products to Install: 1


FEATURES

Statistics Tracking:

• General Board Statistics
• Style Usage Statistics
• Top Threads & Forums Statistics
• Display Colors + Resolutions (Requires JavaScript) Statistics
• Countries + Regions Statistics
• Browsers + Operating Systems Statistics
• Referring Sites Statistics
• Referrer Statistics
• Age & Gender Demographics

Features:

• No code or template modifications required.
• Modules can be enabled or disabled, as needed.
• Statistics are updated every fifteen minutes via cron.
• Mother site, e.g. the site where your forum is hosted, will never be listed as a referrer.
• Only one extra query per forum page.
• Statistics can be sorted either numerically or alphabetically.
• Automatic Integration with Referrer Statistics (if installed)[/i]
• Configurable number of last items for top threads / forums.
• Allows to specify whether to show data from from forums with post counts disabled.
• Configurable number of last items in referring site statistics.
• Configurable gender field and responses (optional).
• Configurable list of usergroups that can access statistics (optional).
• Referring site statistics censure (by word) and individual site blockage.
• Detects most popular browsers and operating systems.
• Requires cookies for screen color depth and resolution tracking.

VERSION HISTORY

1.6.2 - stable
[+] Added recognition for Windows 7-based user agents.

1.6.1 - stable
[+] The navbar link is now shown only to those who can access the statistics.

1.6.0 - stable
[+] Added two new modules:

• Referrer Statistics
• Age & Gender Demographics

[+] Added Google Chrome recognition (this includes a matching icon).
[+] Added Setting to control whether top threads & forums data is gathered from forums where posts are not counted towards user post counts.
[+] Updated ip to country databases to the most recent ones.
[F] Corrected a few phrasing bugs and phrased things that were not phrased in 1.5.2.

1.5.2 - stable
[+] Added a few more translations (thanks to those who submitted these).
[+] Fixed a few bugs that were mentioned for 1.5.1.

1.5.1 - stable
[+] Added option to globally enable / disable any stats modules.
[+] Fixed bug with some staff being counted twice.
[+] All numbers are now nicely formatted.

1.5.0 - stable
[+] No more template edits, just upload the files and the product and you're ready to go.
[+] vBulletin 3.5.x - 3.8.x compatible.

1.4.4 - stable
[+] Referrering Sites now have a JS and an XML feed capability.
[+] Added a better firefox icon into the icon database.
[F] Fixed a couple of minor bugs.

1.4.3 - stable
[+] The hack now respects vBulletin's "Show Active Users" setting.
[+] The hack is now valid XHTML (all templates must be reverted).

1.4.2 - stable
[+] Corrected a bug, which caused incorrect number of moderators to be displayed.
[+] gb.gif renamed to uk.gif.

1.4.1 - stable
[+] The front page has been revised, and it now loads four times as fast regardless of the size of your database.
[+] The ip database has been updated to the revision of October 18, 2006.
[+] The flag database has been updated to the revision of October 18, 2006.
[+] Referrer statistics hack, if installed, is now detected automatically. No configuration required.
[+] Added an option to specify a custom board creation date, if not reflected correctly by the joindate of a user with lowest userid.

1.4.0 - stable
[+] The system is now cross-compatible with both vBulletin 3.5 and 3.6.
[+] The ip database has been updated to the revision of August 30, 2006.
[+] A variety of code optimizations and template corrections have been done.
[+] To keep statistics legible, the engine now only tracks the major and the minor browser versions. X.Y.Z.E is now stripped to become X.Y.

1.3.2 - stable
[+] Since more browsers support cookies than ajax, screendepth/screenresolution tracking is now done via cookies.
[+] One less query per page - e.g. now it's only one query per page.
[+] Statistics are now updated every 15 minutes rather than every hour.
[F] Fixed faulty count in cron and in region stats screen.
[F] Fixed bug which prevented the cron from being created in some cases.
[F] Fixed minor bugs which caused errors of the E_NOTICE level.

1.3.1 - stable
[F] Fixed AJAX coding error, which used synchronous ajax instead of asynchronous, evidently causing higher load.
[F] Fixed WOL error that was caused by AJAX stats update and that made it look like everyone is browsing the stats.
[F] Fixed a query in update cron.

1.3.0 - stable
[+] Yay, no more file edits!
[+] No more multiple queries. The hack now takes up a maximum of two (2) queries per page in contemporary browsers, and one (1) query in non-javascript browsers.
[+] New vBulletin Option: Statistics can be configured either numerically or alphabetically.
[+] Since Opera is updated way too often, the engine, from now on, will only identify the primary version marker (7,8,9 as opposed to 7.01, 7.02, 7.21, 8.01 etc).
[+] Templates and phrases are now in their own separate group.
[F] Eliminated a bug which prevented bot identification from working properly.

1.2.8 - beta
[+] Removed 5 queries during the stats recording.
[+] Countries mapped to valid cia abbreviations and the countrybit template has been updated.
[+] Added missing Fiji flag (Thanks to firstrebel!)
[F] Eliminated a bug which prevented the thread and post limit from having any effect.
[F] Eliminated a bug which prevented the browser identification from working properly in some cases.

1.2.7
[F] Corrected online users count.
[F] Corrected staff count.
[F] Eliminated the style stats bug, which originated from users who had invalid styles saved in their profiles.
[F] Eliminated the posts per day bug.
[F] Renamed "gb.gif" to "uk.gif"
[F] Renamed "Oceania" region to "Australia and Oceania".
[F] Only threads and forums to which the user has permissions are displayed in top threads and forums.

1.2.6
[F] Minor template fix.

1.2.5
[+] Rewritten Browser and OS detection (previosly somebody else's module was used).
[F] For staff stats, only primary usergroups are now counted.

1.2.1
[+] New "Usergroups Allowed To View Stats" admincp option.
[+] Navigation split in two rows, for greater view
[+] Crawlers now have a browser picture associated with them.
[F] Eliminated Tracking of Empty Referrers.
[F] Updated country database with a number of missing countries, including UK.
[F] Minor fix to style statistics screen, applying to styles that are not used.

1.2.0
First Official Release.

1.1.0
Development release; Excess queries, phrases, and code has been removed.

1.0.0
Development release; All phrases that were hard-coded were moved into the phrase system.

The installation manual is contained within the attached file.

IF YOU LIKE MY HACK, PLEASE CLICK INSTALL

[Spikeman]

Have been using this for a time now and all is good, just updated and now I have 23 staff in stats should only be 4, checked users and usergroups and all is good there. Seems that i have 17 extra mods Any ideas?

[akanevsky]

Originally Posted by Spikeman

Have been using this for a time now and all is good, just updated and now I have 23 staff in stats should only be 4, checked users and usergroups and all is good there. Seems that i have 17 extra mods Any ideas?

Please write out the following:
Read Numbers of Admins, S-Mods and Mods
Shown Numbers of Admins, S-Mods and Mods
Thanks.

[Spikeman]

Originally Posted by Psionic Vision

Please write out the following:
Read Numbers of Admins, S-Mods and Mods
Shown Numbers of Admins, S-Mods and Mods
Thanks.

Real Numbers of Admins, S-Mods and Mods = 2 admins, 2 s-mods, 1 mod
Shown Numbers of Admins, S-Mods and Mods = 2 admins, 3 s-mods, 18 mods

[ncangler]

Just discovered this mod and it is awesome. I installed with no problems but I am not getting the correct read on the Staff information.

I have: (1) Admin, (2) Moderators, (2,208) Registered Users, (46) Custom usergroup 'Captains Club' members, 6 custom 'Triumph Dealer' members.

But these show up as:
Members: 2,212
Staff: 46 (1 Admin, 2 s-mods, 43 mods)

Any ideas where those 43 mods came from? The (2) Moderators and the Admin (me) are also 'Captains Club' Members which would make the total number, but I don't know why a special usergroup that is not a Staff usergroup position would show up as Staff. Can custom usergroup designations be added to the code? It would be great if the custom user group name and total members were listed after the staff. Thanks for any help.

[ncangler]

Also, the Site Statistics link in "Quick Links" is linking to my site root (www.mysite.com/psistats.php) not my forum root (www.mysite.com/forums/psistats.php), which is where I installed psistats.php. What would I need to change in the template edit to give it the correct path?

<tr><td class="vbmenu_option"><a href="psistats.php$session[sessionurl_q]">$vbphrase[psistats_link]</a></td></tr>

[akanevsky]

Originally Posted by ncangler

Also, the Site Statistics link in "Quick Links" is linking to my site root (www.mysite.com/psistats.php) not my forum root (www.mysite.com/forums/psistats.php), which is where I installed psistats.php. What would I need to change in the template edit to give it the correct path?

<tr><td class="vbmenu_option"><a href="psistats.php$session[sessionurl_q]">$vbphrase[psistats_link]</a></td></tr>

Add psistats to the replacements of whatever portal software you are using.

Originally Posted by ncangler

Just discovered this mod and it is awesome. I installed with no problems but I am not getting the correct read on the Staff information.

I have: (1) Admin, (2) Moderators, (2,208) Registered Users, (46) Custom usergroup 'Captains Club' members, 6 custom 'Triumph Dealer' members.

But these show up as:
Members: 2,212
Staff: 46 (1 Admin, 2 s-mods, 43 mods)

Any ideas where those 43 mods came from? The (2) Moderators and the Admin (me) are also 'Captains Club' Members which would make the total number, but I don't know why a special usergroup that is not a Staff usergroup position would show up as Staff. Can custom usergroup designations be added to the code? It would be great if the custom user group name and total members were listed after the staff. Thanks for any help.

Does your Captains Club group have moderator abilities?

[ncangler]

No they do not.

Originally Posted by Psionic Vision

Does your Captains Club group have moderator abilities?

[ncangler]

Just that easy! Sorry I didn't think of or find it in the thread sooner. I appreciate the addition of this wonderful mod to our sites!

Originally Posted by Psionic Vision

Add psistats to the replacements of whatever portal software you are using.

[akanevsky]

Originally Posted by ncangler

Just discovered this mod and it is awesome. I installed with no problems but I am not getting the correct read on the Staff information.

I have: (1) Admin, (2) Moderators, (2,208) Registered Users, (46) Custom usergroup 'Captains Club' members, 6 custom 'Triumph Dealer' members.

But these show up as:
Members: 2,212
Staff: 46 (1 Admin, 2 s-mods, 43 mods)

Any ideas where those 43 mods came from? The (2) Moderators and the Admin (me) are also 'Captains Club' Members which would make the total number, but I don't know why a special usergroup that is not a Staff usergroup position would show up as Staff. Can custom usergroup designations be added to the code? It would be great if the custom user group name and total members were listed after the staff. Thanks for any help.

Do you have any forum-specific moderators?

[ncangler]

The two moderators are assigned to all the forums. I don't have any moderators on this site that are assigned to just one forum.

Originally Posted by Psionic Vision

Do you have any forum-specific moderators?