Тема на орге
vBExperience 3.7 (aka xPerience)
--------------------------------
Created by Marius Czyz aka Phalynx.
This mod will work with vBulletin 3.6.8 and vBulletin 3.7 or higher.
Description
vBExperience is an advanced level and activity system. It will calculate an activity and experience score for every user based on their activites on the forum. Now your users will see how their level is increasing by participating on your forum.
This mod was developed by me because I was never satisfied with the post count. Communities are not only defined by post count, they need much more parameters: Are the postings the user creates helpfull? Are his threads frequently read? Does the user participate on the community by posting pictures, attachments, leaving visitor messages, tagging threads? All this can be answered with this mod.
This is the first public release. I used this on my boards since vBulletin 3.5, converted it now to vBulletin 3.7 Beta 4 and released it to the public. Since 3.7.8 this modification can also be installed on vBulletin 3.6.8
For vBulletin 3.6.8 there is only reduced functionality because some new features like social groups, thread tagging, visitor messages and albums have been introduced initial in vBulletin 3.7
Demo:
http://www.insidesupcom.de/forum.php?langid=1
Demo Profile:
http://www.insidesupcom.de/member.php?u=1&langid=1
Demo Rankings:
http://www.insidesupcom.de/xperience.php?langid=1
Demo Awards:
http://www.insidesupcom.de/xperience...wards&langid=1
There are mainly four things visible for the users: The users score, his level, his next level up in % and his activity in %.
Calculation of the score
Taken into calculation are these things:
Threads
- Created threads
- Thread views of own threads
- Thread replies of own threads
- Thread votes of own threads
- Thread tags (vBulletin 3.7)
- Replies to own threads
- Sticky threads
Posts
- Created posts
- Views on attachments
User
- Days since registration
- Referrals
- Received infractions
- Reputation
- Visitor messages on profiles (vBulletin 3.7)
- Members of own social groups (vBulletin 3.7)
- Albumpictures (vBulletin 3.7)
- Friends (vBulletin 3.7)
Misc
Additionally there is support for 3rd pary addons like "Post Thank You", "Links and Downloads Manager", "DownloadsII", "PhotoPost Gallery" and "Cyb Paypal Donate". You have to install these hacks for your own, vBExperience doesn't install nor touch these.
Calculation of the activity
The system calculates the activity by taking the average post count of the ten most active user and comparing it to own post count. This can be set to count only the last X days, f.e. 21 days (controlable via AdminCP) .
Awards
From 3.7.8 on there are three awards: Community, Posting, Activity, Helpful. Available in Gold, Silver and Bronze they show up special users. The awards are shown in Rankings and Profile. You can set them also to display in postbit near the username. There is a scheduled job running once a day (02:30h) to calculate them.
Rankings
Showing User, Level, Awards, Activity Points (experience, thread, post, user, misc) - sortable.
vBAdvanced
There are two vBAdvanced 3.0 XML modules: Most Active Users and Most Experienced Users. Import them via vBAdvanced AdminCP.
Settings
You can control how many points are given to every calculation. For example you can give many points for creating new threads but only a few for views of that thread. Setting a value to 0 will disable it.
Additionally, you can set ignore users (f.e. for bot users), forums (f.e. offtopic forums) and usergroup id's.
Levels
vBExperience works with defined levels and points. You need to import at least one of the three level products. Just test it what fit's your board:
vbexperience_level_1_small.xml - for small boards up to 3000 users
vbexperience_level_2_average.xml - for average boards with around 3000-6000 Members
vbexperience_level_3_big.xml - for boards which have more than 7000 members
vbexperience_level_4_huge.xml - if "big" is not big enough for you
vbexperience_level_5_very_large.xml - Huge is too small?
vbexperience_level_6_ultra.xml - Ultimate users and postings
vbexperience_level_7_crazy.xml - Either you or your users are crazy
You can define the needed levels for your own - I've included an MS Excel Sheet with the raw data and also three XML Samples for small, average and big sites. Also, you have the possibility to decrease given points for e.g. posts and threads.
The XML files are generated via vBExperience_Level.xls, copied to a text editor, removed tabs and copied to XML. Using it that way you can define your own levels and also promotions. Just do some experiments with the XLS sheet. Currently only levels from 0 to 100 are supported.
Attention: Importing a changed level XML needs to recount the xperience points via maintenance tools. Running the cron is not enough.
It would be great to see more XML files - feel free to share them, I'll include them in future releases.
Promotion system
To motivate users to do more on your forum I created the promotion system. By reaching defined xperience points the user will be moved to another usergroup - where you can set graphics, shadows, highlighting, etc... What is interesting in combination with this: you can give the user more possibilities f.e. larger avatars or bigger PM box.
Please take care with this, as it currently changes the primary user group - you can lose your administrators group. This feature is disabled by default.
Impact on performance
vBExperience has been tested on smaller and also on some bigger sites. I know from boards with around 20k users running this mod smoothly - but I have currently no clue what is beyond that.
- vBExperience uses the "user" table to store it's informations, so no additional query is needed in postbit.
- On the Memberprofile one additional query is used to gather the statistics.
- Every 10 minute a cron is running to recalculate stats for users that created a post since the last cron. Only stats of currently active users are recalculated
- Every night two crons are running to recalculate the posts per day that is needed for the activity factor and the awards. This counts for all users, regardless they are active or not.
Installation
This product has additional files, is fully phrased and uses template hooks. No file changes or manual template edits needed. Two cron's are automatically added.
1. Upload all files from "upload" to your server, take care of the directory structure. Images must be uploaded in BINARY, PHP files in TEXT mode.
By using not the default style you should have in mind that you also must copy the images to the correct directory of the style, thats mostly under "/designs/" or "/styles/".
2. Import the main product "product_vbexperience3710.xml"
3. Import a level product "vbexperience_level_1_?.xml" (see above "Levels").
4. Tweak settings if required and manually recount the score for every user via maintenance
Upgrade Instructions
1. Copy ALL files from /upload/ to the server. Take care of the images, copy them to your style misc folder if you use a customized style
2. ReImport product_vbexperience3710.xml, allow overwrite
3. Revert ALL vBExperience templates
4. Run Maintenance Tools/Recount
Additional languages
vBExperience is beeing published with english phrases. Additionally, you can find the following languages in the installation:
\languages\deutsch\vbulletin-language-deutsch.xml - German
\languages\turkish\vbulletin-language-turkish.xml - Turkish
Installation: AdminCP, Languages & Phrases, Download / Upload Languages - Name the XML, Overwrite existing Language (don't be afraid, only custom phrases are imported), Set Ignore Language Version to Yes and Import.
If you defined your own language and you would mind to share - feel free to contact me. I'll include it in the next release.
Known Issues
- If the promotion system is enabled and your primary administrator group you will lose this. Set your administrator group as secondary or don't use this feature
- Ignore UsergroupID's is not fully implemented
- AdminCP not fully phrased
Troubleshooting
If there are no bars visible at the postbit, you don't have a fully vBulletin 3.6.8/3.7 compatible postbit/postbit_legacy template. You will need $template_hook[postbit_userinfo_left] - make sure it's there. Take a look at the origin 3.6.8/3.7 template to see where it should be.
Screenshots
I've attached a few screenshots:
vBExperience_Awards.JPG - Hall of Fame
vBExperience_Awards_Username.JPG - Username with Awards
vBExperience_Rankings.JPG - Rankings with new Awards
vBExperience_Profile_vBulletin 36.JPG - It adds a reduced memberblock to the vBulletin 3.6.8 profile
vBExperience_Profile_vBulletin 37.JPG - It adds a detailed memberblock to the new vBulletin 3.7 profile
vBExperience_Postbit.JPG - An overview of users score is visible in the postbit, Level up (blue bar) can be hide
vBExperience_Postbit_FullPopup.JPG - Popup on Username
vBExperience_Postbit_WithText_LeftAwards.JPG - Username prefixed with Awards and Bardescriptions
vBExperience_AdminCP_Stats.jpg - vBExperience menu and new level stats
vBExperience_Settings.JPG - Settings are done via AdminCP
vBExperience_Settings_Points.JPG - Every point provider can be configured individually
Credits for medal icons
FAMFAMFAM,
http://www.famfamfam.com/lab/icons/silk/
Comments, suggestions, translations, bugs, etc... are very welcome! Support is only given to people who have clicked INSTALL.
History
3.7.10, 12th March 2008
- Added: Reworked Awards. Awards are now completely manageable by AdminCP. You can now disable, add new, delete and customize them.
- Removed Silver and Bronze awards as they undermined effect of the whole awardsystem
- Added: Option to select position in postbit
- Added: Link to Rankings in Popup
- Fixed: Compatibility with vBulletin 3.7 Beta 6
- Fixed: Compatibility with vBAdvanced CMPS Integration
- Fixed: Uncached templates in postbit
- Level products have now version number according to it's level
- Smaller fixes/changes
3.7.9, 7th March 2008
- Added overview of Awards: All Users with Awards on one place
- Added new xperience: Friends. A new setting has been introduced to control it
- Added Award: Helpful. This Award is using "Post Thanks", if available.
- Added three new level products: Very large, Ultra and Crazy
- Added two new postbit modes: As Popup, as Popup with full information
- Added Points and Level to Memberslist, configurable: None, Points, Level, Points and Level
- Username can now be attached or prefixed with awards. Valid only in postbit, profile, memberslist
- Level up in postbit can now be set as hidden to make the bars smaller
- "Ignore Usergroups" is now implemented
- Deleted users didn't appear now as ghost's in Ranking
- Recount is now also generating Awards
- Fixed a bug not calculating correct Post Thanks
- Smaller fixes/changes
For more see history.txt
vBExperience
