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

[akanevsky]

Originally Posted by 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.

So they are supermoderators, right? But are they (the s-mods) also listed as moderators of each forum (just for the sake of showing up in the forumbit)?

[ncangler]

Actually no I don't have any supermoderators, just two moderators and I have them assigned to all the forums. I've attached a jpg that shows my usergroup setup. I installed the stats program on another site and it is doing the same thing.

Originally Posted by Psionic Vision

So they are supermoderators, right? But are they (the s-mods) also listed as moderators of each forum (just for the sake of showing up in the forumbit)?

[ncangler]

Everything seems to be working great except the listing of staff (s-mods and moderators) and the "Active/Non-Active/Activity level" counters. On both sites that I have installed the psistats today it is showing no activity and all as inactive. This is obviously not correct as several members have been on and posted today. I've attached jpg's of the stat screens for both sites.

[ncangler]

Okay I found where I had each of the moderators setup as super moderators by having one button activated in the usergroup setting. They are now just moderators and are not showing up as s-mods anymore. I also turned off the "Viewable on Show Groups" for the large usergroup "Registered Users". That apparently has enabled the activity statistics to start working now. Only thing left is to figure out why the custom usergroup Captains Club members are showing up as Moderators.

[jw00dy]

I have the same deal. I have a group that is allowed access to a private forum, and they are being added to the moderators groups listing as well.

I actually have 0 moderators.

The rest of the data looks good to me.

[EvilHawk]

Originally Posted by jw00dy

I have the same deal. I have a group that is allowed access to a private forum, and they are being added to the moderators groups listing as well.

Same thing happens to my forum too ...

[EvilHawk]

Anothe minor bug, if someone has set the vBulletin option "Active Members Time Cut-Off" to zero to disable it, the stats shows all members as inactive and activity level as 0% ...

[EvilHawk]

Originally Posted by EvilHawk

Anothe minor bug, if someone has set the vBulletin option "Active Members Time Cut-Off" to zero to disable it, the stats shows all members as inactive and activity level as 0% ...

Xmmmm in fact it doesn't take in account the setting, it shows all members as inactive and activity level 0% ...

[akanevsky]

Originally Posted by jw00dy

I have the same deal. I have a group that is allowed access to a private forum, and they are being added to the moderators groups listing as well.

I actually have 0 moderators.

The rest of the data looks good to me.

Ok, I understand. There is no need to keep reporting the bug. I'll work on fixing it.

Originally Posted by EvilHawk

Xmmmm in fact it doesn't take in account the setting, it shows all members as inactive and activity level 0% ...

That's because 0 does not disable the cutoff. In fact, it cuts off all users after 0 seconds. The script uses vbulletin userstats to retrieve that information so it cannot be incorrect.

[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.

From your screenshot, I don't know where the mods came from.
If you can send me your admincp details via pm, it would be very helpful.