The Arcive of Official vBulletin Modifications Site.

Activity Modification · **Released**: 08-07-2005

For vB3.7, see The vB3.7 version

This is the plugin/vB3.5/vB3.6 version of this hack

This mod was developed on vB3.6.4, and tested for compatibility with vB3.5.4

Description
This hack adds an activity metric for users to your forum; this metric takes into account a variable number of weeks. Also provided is a Junior/Normal/Senior member system based on this metric, and a longevity metric (user registered time as a percent of the amount of time the first user has been registered).

Visiting each day and posting the configured amount of times per day for the configured number of weeks will yeild 100% activity. Posts are checked individually for each day, so days cannot be skipped then spammed up afterwards. The weight of visiting for the day relative to posting is configurable. Weeks are weighted so the most recent has a bigger impact on the activity percent than the most distant.

When a user logs in with activity above the configured threshold, they are promoted from Junior Member to Member. When they log in with the configured amount of time as Member, they are promoted to Senior Member. You can configure the mod to also add secondary usergroups when these promotions happen.

Complexity
This modification requires 1 XML import, modification to 3 templates, and the addition of some CSS, depending on what options you choose

Technical
This hack adds 1 query to showthread for each user who posts in that page (or only 1 for the logged in user by configuration). In addition, the first time a member's post or profile is accessed during a day (GMT), 3 queries are performed to find that user's activity. By configuration, 1 query may be added to each page load to find the logged in user's "activity today". By configuration, 1 query may be added to each member profile view to find that member's "activity today".

Upgradability
This modification will import your settings and data from the 3.0/hack version

Frequently Asked Questions

I installed this mod using the Download/Upload Plugin page and there was an error/it doesn't seem to work
To install this mod, you need to use the Add/Import Product link on the Manage Products page
I just installed and everyone's activity seems low
1. Part of the activity calculation is what days users visited on. This information isn't collected before the mod is installed, so no user can have 100% activity untill you've been running the mod for the full period of time you have it set to monitor
2. Please realize that there is no "roll over" for activity; if you have it set to look at 4 posts per day, your users must post 4 posts on each individual day to obtain 100%.
I founded this forum, but I don't have 100% longevity
Somehow a user's join date has been set before yours. When you install, the mod looks for the earliest join date to use to find longevity, but you can change the baseline date. To change the "Start of board" time, go to Maintenance>Activity Maintenance>Set Start of Board, enter your user number in the text field, then click Set Start of Board
I'm using the images template version, but the images don't show up
Be sure to upload one of the activity directories from activityimages.zip to the misc directory for each of your styles. To find a style's misc directory, goto the Style Manager, then from the dropdown next to the style, choose Stylevars. The setting Miscellaneous Images Folder contains the path to that style's misc directory, where you need to upload the activity directory
Can I use activity for promotions?
The project to build a full-blown promotion hack for use with this mod has been cancelled, after losing all of my work, however a much simpler system that adds secondary groups based on two thresholds has been added to the main hack.
Can you make X number get split up into digits?
I understand where you're coming from with this one, but I just can't figure out a way to work this that would be simple to use.
The tooltips don't wrap and get cut off with FireFox
The same thing happens to other vB tooltips (the thumbnail ones, for example). If you know a way to add line breaks to FF tooltips without scripting, please let me know.

Change log

Note: To upgrade, with the old version still installed, go to the Add/Import Product link on the Manage Products page, select the XML file for the new version, choose Yes for overwrite, then click Import.

2.80 release update

Added AdminCP option to disable display of activity ranks (ranktext)
Modified template changes to support the above change (for most people, your templates should work as is)
Modified template changes for image horizontal postbit to always locate activity information in the upper right of the postbit, so it doesn't move arround from post to post (if you're happy with how it is now, no need to update)

2.80 rc3 update

You can now control the number of entries on the Top Activity board from the adminCP
Top Activity templates are properly cached
Changes for XHTML 1.0 validation (requires template reedits if you want XHTML validation)

2.80 rc1 update

Added improved built-in Top Activity page
Added option for activity breakdown in activity bar tooltip
Added option to promote users when their activity is calculated instead of just when they visit to help admins that are having trouble with the promotion system
Fixed issue with maintenance section with other languages. It should display correctly now for all languages.
Added admin help in 3.6.x
Added 3.6.x version and link in product list
No template changes since 2.70 (there are new templates, however)

2.71 update

Corrected a bug where users on forums with "Weeks reflected" set to 1 could not reach 100% activity

2.70 update

Full info available to MEMBERINFO template
Full info available for the logged-in user (see template customization in install file)
Fixed % issue with different vB versions
"Midnight" for activity hack is configurable. Note that it may be desirable to set this to a time other than true midnight for your users.
Options to control calculation of activity today in MEMBERINFO and for logged-in user
Simple promotion system adds secondary usergroups when members are promoted in the ranktext system
Reworking of internals
Default templates should not try to display activity information when it is unavailable (a generic fix that covers vbA gallery)

2.51 update

Updated phrases for vb3.5.1
Updated options activity refresh for vb3.5.1
Fixed problem with activity-based ranks

2.50 Release update

Added fix for reversed posts field in images version templates when user is using a right-to-left language. (Manually update the postbit and postbit_legacy templates)

Beta 6 update

Added extra checks for excessive activity
User activity is now automatically refreshed when settings changes make it neccessary
Fixed guest bug

Beta 5 update

Removed the query added to PM views in beta 4
Removed the post digits setting; it causes trouble since the majority of users seem to be using the image version, and the load impact is slight anyway.

Beta 4 update

Fixed the problem where activity panel displayed incorrect information in PMs
Moved start of board into settings, removed 1 query from showthread, view PM, view user note

Beta 3 update

Fixed a critical issue with activity caching. Everyone should update
Fixed an issue with a query not working when using table prefixes
Added template modification instructions
Added image template mod version screenshot

Beta 2 update

There was an issue with % signs in the phrases, this has been corrected.
Screen shots added.

Changes from the hack version

Thresholds for promotions are configurable
Ranktext system is configured from the options page instead of by a file
You can now prune the visit log from the adminCP (Under Maintenance>Activity Maintenance)

Support

Please click the install link if you install this hack
I will support this hack in this thread on about a weekly basis.

MissKalunji · #**312** 08-22-2006, 08:59 PM

Quote:

Originally Posted by WetWired

I will investigate the failed start of board problem, and the CP nav issue. Is the CP nav issue only with 3.6?

is that normal that this mod adds 10 queries?

edit : never mind the inferno warning was adding 20 queries go figure!

WetWired · #**313** 08-22-2006, 09:37 PM

It is normal for this mod to add a lot of queries at the start of the day, and for it to quickly taper off.

Quote:

Technical
This hack adds 1 query to showthread for each user who posts in that page (or only 1 for the logged in user by configuration). In addition, the first time a member's post or profile is accessed during a day (GMT), 3 queries are performed to find that user's activity. By configuration, 1 query may be added to each page load to find the logged in user's "activity today". By configuration, 1 query may be added to each member profile view to find that member's "activity today".

There are several options that start off which add queries when turned on. They should all explain the query impact in the description.

In the default configuration, it is possible for this mod to add no queries when viewing a thread. This happens when posts for all of the posters on the displayed page have been previously viewed during the day, and none of those posters are the active user. On the other hand, if you view a thread page (of 25 posts), where each post is by a different user and noone has been viewing the board today, you could get 25x3=75 queries the first time you view the thread (but if you refresh it would drop to zero, because the activity is stored for each user from the first page load).

Activity is per user, not per post, so the typical senario is that after the configured "midnight" for the mod, people are viewing threads and the people that post a lot get their activity calculated and stored, using a lot of queries. After that, pages probably get 6 or 9 queries added as people view posts by less-frequent posters. Eventally, virtually all of the active users will have their activity already calculated and stored, and the mod will be adding only the single query to calculate the logged-in user's activity today in threads they posted in. Note that this is one of the reasons for the configurable day cycle: if you place the mod's midnight at the time where you have the lowest usage, not only will the day cycles seem more natural to the users, but the load spike after midnight will be placed where it won't matter as much.

I have made every effort to minimize SQL server load caused by this mod. Not only is activity stored for future page loads, but it is also stored for future posts on the same page, for example. It would be possible for me to do only 3 big queries every page load, but those 3 queries would create a larger and ongoing load than the way that I do it.

IncredibleHawk · #**314** 08-23-2006, 01:58 AM

Awsome Awsome

Nachtfalke · #**315** 08-23-2006, 01:59 AM

I guess I figured out, how you can show the activitytstat.php addon as a correct location in Who is online. By adding two mini-plugins and a phrase, the WOL-List will show the right location. Maybe this could be added to the package, if it is good enough. I do not claim any credits, since this bases on a tutorial I found on vbhacks-germany.com (thank you Andreas

). Okay, here we go:

1. Add a new phrase, name it activity_toplist and give it the value of "Toplist" or "Statistic" or whatever you desire.

2. We now need the first plugin to introduce the addon to our vbulletin system. Select "add plugin", in the dialog select the product "Activity modification" and the hook "online_location_process". Add the following code to it:

PHP Code:


			
if ($filename == 'activitystat.php')

{

    $userinfo['activity'] = 'activitystat';

}

3. It's time to tell the WOL what to do, so we add the next plugin. Select "add plugin", in the dialog select the product "Activity modification" and the hook "online_location_unknown". Now add the code:

PHP Code:


			
if ($userinfo['activity'] == 'activitystat') 

{ 

    $handled = true; 

    $userinfo['action'] = construct_phrase($vbphrase['viewing_x'], $vbphrase['activity_toplist']); 

    $userinfo['where'] = '<a href="activitystat.php?'.$vbulletin->session->vars['sessionurl_q'].'">'.$vbphrase['activity_toplist'].'</a>';

 

}

4. All done. The next time somene visits the activitystats.php, it will be shown correctly in the who is online list.

By the way, this system is working of course for every other installed hack that is not shown correctly. Hope that helps someone out.

MissKalunji · #**316** 08-25-2006, 04:15 AM

thx wetwired

Muellmann · #**317** 08-27-2006, 05:50 PM

I very like this Hack and it works fine for me with 3.60 Gold.
Thank you for your Efforts to code such Things, I know that's
not easy Work.

MissKalunji · #**318** 08-27-2006, 08:51 PM

Quote:

Originally Posted by Muellmann

I very like this Hack and it works fine for me with 3.60 Gold.
Thank you for your Efforts to code such Things, I know that's
not easy Work.

i second that

jcodemasters · #**319** 08-31-2006, 05:35 PM

thank you for this script. i am wondering if one has tested this script on VB 3.6.0 thanks

rogersnm · #**320** 08-31-2006, 05:40 PM

yup, works fine for me

jcodemasters · #**321** 08-31-2006, 06:00 PM

thanks rogersnm i will test it now..

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.05182 seconds Memory Usage 2,336KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (2)bbcode_php (3)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (2)pagenav_pagelinkrel (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!