UBB.threads Statistics · Wiki

What Is Covered

• Summary
• About the Modification
• Demonstration
• Settings
     • Configuration Settings
     • Database Connection Information
• Sections
• Changelog
• Frequently Asked Questions
     • How do I get my stats to link to the forum location?
     • What does purchasing a license entitle me to?


 

Summary

This page represents the full documentation for the UBB.Statistics script by VNC Web Services.


 

About the Modification

• Requirements: UBB.threads 7.x (not compatible with UBB.threads 6.x or below)
• Current Build: 20210901
• License Information: This script is not freeware, it requires a license; by purchasing a license you're granted usage on 1 (one) UBB.threads installation. Any additional installations require an additional license. Updates are available for 1 year after initial purchase; after this timeframe, to aid in development costs, you must renew your access to updates (see the purchase link below for further information). You cannot freely provide this script to others without written permission from the author.
• Pricing: $75 (Purchase Here)
• Support: Support is available on the UBBDev thread UBB.Statistics.

UBB.Statistics is a script that we created to display a set of statistics for your UBB.threads install.

Displayed thread statistics can be customized to show only forums that allow guest access, or all forums. Charted data is created with Google Charts, and is subject to their service being available in the future.

Setting $conf["span"] will affect the "recent" section of stats, setting the $conf["max"] will affect the "historical" section of stats; one could have a recent set of 30 days with a historical set of all time, this year, etc.




 

Demonstration

UBB.Statistics can be seen at:
• A Gardeners Forum
• A Gardeners Forum [Archive]
• UBBDevelopers
• UGN Security
• VNC Web Services


 

Settings

 

Configuration Settings

// Configuration - Make any changes to the script configuration here
     $conf["advanced"] = 1; // Show Advanced Forum Stats? (Default: 1)
     $conf["basic"] = 0; // Show Basic Forum Stats? (Default: 0)
     $conf["dateformat"] = "M jS, Y at h:i A T"; // How should dates be formatted? (Default: M jS, Y at h:i A T)
     $conf["folder"] = "forum"; // If you would like to test the values of your UBB.threads configuration, please populate this field with the location of your UBB.threads install folder (either the folder from this script (such as "forum") or full filesystem folder (such as "/home/user/public_html/forum") without a trailing slash.
     $conf["guest"] = 1; // Show topic information for only those guests can access? (Default: 1)
     $conf["length"] = 2; // How long has this forum been established? 0*/1-5 Years, 1/5-10 Years, 2/10-20 Years, 3/20-30 Years
     $conf["likes"] = 1; // Display statistics for UBB.threads Likes? (Default: 1; This feature added in UBB.threads v7.7.4)
     $conf["max"] = 0; // What is the max span we should check for? (Default: 0/Alltime)
     $conf["newest"] = 0; // What is the newest year we should build links for (dates will be ignored after this year; useful for archive forums)? (Default: 0/All)
     $conf["oldest"] = 2010; // What is the oldest year we should build links for? (Default: 2010)
     $conf["span"] = 30; // What is the default span we should check for? (Default: 30)
     $conf["total"] = 25; // What is the total amount of data we should check for? (Default: 25)
     $conf["utf8"] = 0; // Set the MySQL Character Set to UTF8MB4 (0* No/1 Yes


// Charts
     $conf["chart"]["color"]["main"] = "7570b3"; // What color should the bars in the bar chart be, represented as hex code or color code only (default "7570b3")?
     $conf["chart"]["color"]["alt"] = "opacity: 0.2"; // What color should the bars in the bar chart be, represented as hex code or color code only (default "opacity: 0.2")?
     $conf["chart"]["topics"] = 1; // Display a chart for topics?
     $conf["chart"]["likes"] = 1; // Display a chart for likes?
     $conf["chart"]["posts"] = 1; // Display a chart for posts?
     $conf["chart"]["previous"] = 1; // Display the previous year in charts?
     $conf["chart"]["pm"] = 1; // Display a chart for private messages?
     $conf["chart"]["pt"] = 1; // Display a chart for private topics?
     $conf["chart"]["registrations"] = 1; // Display a chart for user registrations?
     $conf["chart"]["status"] = 1; // Show Charted Stats? (Default: 1)


// Database Connection Information (Set $conf["folder"] above to use your UBB.threads config)
     $conf["db"]["password"] = ""; // This should be the password to your database.
     $conf["db"]["prefix"] = ""; // This should be the table prefix of your UBB.threads installation.
     $conf["db"]["name"] = ""; // This should be your database which holds your UBB.threads installation.
     $conf["db"]["server"] = ""; // This should be the hostname that you use to connect to MySQL.
     $conf["db"]["username"] = ""; // This should be the username to your database.





 

Sections

Charted Data: Charted data for the selected year will display for Topics Created, Posts Created, Posts Liked, User Registrations, Private Topics, and Private Messages.
General Statistics: General Statistics is the current running total of your forum, including Total Members, Total Private topics, Total Private Messages, Total Categories, Total Topics, Total Posts, and Total Post Likes, and Total User Likes.
Top Forums: Displays as both "Topics" and "Posts".
Top Topics: Displays "Views" and "Replies" for both X and Y periods.
Top Topic Starters: Displays for both X and Y periods.
Top Liked Posts: Displays for both X and Y periods.
Top Liked Users: Displays for both X and Y periods.
Top Posters: Displays for both X and Y periods.
Top PM Users: Displays for both X and Y periods.
Logged In: Displays for both X and Y periods.
Styles: Items are only shown when selected, users using "forum default" will not display.
Languages: Items are only shown when selected, users using "forum default" will not display.
Top Moods: Displays the current top used mood images.


 

Changelog

 20210901 (September 1st, 2021)
Added: Likes Statistics Added and Charted (for Top Liked Users and Top Liked Posts)
Added: A date span can be adjusted to affect the "old"/"oldest" date calculation for "Basic Statistics"
Added: Alpha/Beta release vs Public Release is now displayed within the script; this will allow users to see what Alpha/Beta they may be using and still allow for script update checks.
Added: An "About Script" blurb has been added to the top of the page. This serves as an anchor for links to documentation URLs without having to open the script source.
Added: Several comments were added to our written functions to outline their use.
Added: Short Array Syntax adopted to allow cleaner code and flow consistently with our other scripts. (PHP 5.4 Required)
Added: Added a newest date indicator, any activity in the charts will max out at the supplied date, no charts will build beyond this year.
Added: Accept Admin EMail Totals Added
Added: Placeholders added for future "Top Rated" (Topics/Users) statistics
Added: IDs added to all sections to allow you to link directly to that statistic (ubb.statistics.php#chart-topics)
Change: The Latest Version check has been adjusted and will now function with the changed URL.
Change: Content can be retrieved from the database over the UTF8MB4 character set.
Change: number_format is now being applied to all of the Basic Statistics to allow for human readable numbers.
Change: General Statistics have been retooled and will allow for the standardized display of additional variables that can be added to the arrays.
Change: All UBB.threads related URLs (UBBCentral, UBBDev, UBBWiki, VNC Web Services) have been updated (we're no longer using WWW in our URLs)

 20190918 (September 18th, 2019)
• Code Cleanup
• First Post Date and Last Post Date have been added, as has the fetch_post_date function.
• You can now set the date format for any dates returned.
• IDs are now inserted for #top, #stats, #bottom

 20181010 (October 10th, 2018)
• Initial Build


 

Frequently Asked Questions

      

How can I view the previous in the charts?

Just set $chart["previous"] to 1 and the previous years stats will be listed below each months display.


      

How do I get my stats to link to the forum location?

When you point $conf["path"] to your UBB.threads folder UBB.Statistics will automatically generate links for all reports; these links will utilize your preferences set in your UBB.threads configuration (both SE Friendly URLs and the HTML extension).


      

What does purchasing a license entitle me to?

By purchasing a license to UBB.Statistics you're entitled to lifetime support of the script for the lifetime period of the script. You also receive access to a year of updates for free. Access to updates is purchased in blocks of 1 year for $75/yr to cover development costs. Please note that you are entitled to install this script on ONE domain per license; additional domains will require additional licenses.



Posted By Gremelin Posted on October 8th, 2018 · Updated on August 31st, 2021

Return to the Wiki Index
Return to the Category "Modifications"
Submit a Wiki for Review