Trader Ratings v1.2.0

Trader Ratings - A user feedback hack
Copyright ?2004 Jason Rabel, All Rights Reserved.
__________________________________
Latest TR Verson: 1.2.0
vB Versions: 3.0.0 - 3.0.9
Author: Jason Rabel
Contact: PM me here, I'll respond.
Site: EXTREME Overclocking
??????????????????????????????????

Updates:
??????????????????????????????????
1.2.0 - September 4, 2004
- Added Trader Ratings Stats Page (finally!)
- Added PM notification when someone receives feedback
- Changed how positive feedback percentage score is calculated (bugfix)
- Ability to "close" the Trader Ratings pages (for maintainence or whatever) - TRATING_CLOSED
- Ability to set the URL field when submitting feedback to required or optional - TRATING_REQ_URL

1.1.0 - June 7, 2004
- Added time-based user edit/delete abilities, set via TRATING_UEDIT constant in traderratings.php file
- Userdate field is now an int field to be consistent with vBulletin
- Userrating field changed to tinyint to save space
- Fixed timeframes for showing historical ratings
- Made some various code consolidation
- Added missing ".TABLE_PREFIX." statement
- Templates.txt file shows code for postbit & MEMBERINFO, with conditional examples
- All 3 templates changed heavily
- Added some more phrases & fixed missing phrases

1.0.1 - June 2, 2004
- Fixed a "divide by zero" display error
- Postbit template fixed so guests do not have a trader rating

1.0.0 - June 1, 2004
- Initial Public Release

Description:
??????????????????????????????????
Trader Ratings has evolved from my vB2 Buy/Sell/Trade User Rating System. This is a rating system for when members buy / sell / trade items from each other (presumably on a FS section of your forum). It is based on the honor system since there is no way to truly tell if they did engage in a transaction. (But I'm working on a way to fix that.) Trader Ratings came about because it was a pain to try and maintain a single thread listing good / bad traders and so far has worked out quite well.

Features:
??????????????????????????????????
? Rate another member: Positive / Negative / Neutral
? Specify Buyer, Seller, or Trade
? Leave comments about the deal
? Records date when rating created
? Specify a URL to the deal
? Display ratings over time
? Filter based on Buyer/Seller/Trade/or feedback they left for others
? Users can edit/delete ratings left for others (time based limitation)
? Admins & Mods can edit/delete anyone's ratings (just incase)
? Stats page showing best & worst rated members, and recent ratings
? PM notification when a person is rated

Basic Info:
??????????????????????????????????
I haven't written a FAQ or any real documentation yet, but the way the system works is very simple. The only part that might confuse someone is that the Feedback Score is based only on UNIQUE members. Also, there are simple checks in place to make sure they actually do select proper info and enter a comment. A user is not able to rate themself (obviously). Permissions for viewing / rating are similar to standard forum viewing / posting permissions. Also it checks to make sure users exist and all that good stuff.

Installation Info:
??????????????????????????????????
This hack is very simply to implement requiring only:
? 1 new file
? 5 new templates / 2-3 template changes (navbar, posbit/postbit_legacy, MEMBERINFO, memberlist_resultsbit)
? 52 new phrases
? 1 new DB table / 1 table DB change & index

An install/upgrade PHP file is included to do all the template/phrase/DB stuff, so basically you run that, upload the file, and edit your postbit template. BAM!

Screen Shots / Demos:
??????????????????????????????????
See Screenshots below, or you can view them on my forums: My Trader Rating Page

Standard Disclaimer:
??????????????????????????????????
BACKUP YOUR DATABASE & FILES BEFORE IMPLEMENTING THIS HACK!!!

Forums Using This Hack:
??????????????????????????????????
EXTREME Overclocking Forums
i-Club -- Forums
Accord Tuner
NSX Prime
Honda-Acura.net
Guns Network
PimpRig

(PM me your forum if you want me to add you to the list)

Donations:
??????????????????????????????????
This hack will always be free, however your donations are kindly accepted and will help towards further development. If you donate, please leave me some info (either your forum site or username at vB.org) so that I can thank you.


Plans For Future Releases:
??????????????????????????????????
? rebuttal / followup comments
? item description (possibly instead of thread url)
? button on thread that buyer/seller clicks to tie the transaction to two people

[0ptima]

Originally Posted by lsmba

Anyone having functional problems with Trader Ratings?

lsmba

Seems to work fine on my vb 307

[xtreme-mobile]

hi guys

one very small problem, when i click to got o the traders ratings on my default skin it works perfect but my second skin it just shows a white blank page, any ideas?

many thanks

dean

[Polo]

Originally Posted by xtreme-mobile

hi guys

one very small problem, when i click to got o the traders ratings on my default skin it works perfect but my second skin it just shows a white blank page, any ideas?

many thanks

dean

you need to add the template changes to your other style...

[hasan2k]

I have a few questions:

Once installed, can I change the settings in the traderratings.php file. I want to change the time limit allowed for editing the ratings.

If it is possible, how can I set the editing time to 90 days. Is it still in seconds? (90 days X 24 hours X 60 mins X 60 sec)

Do I need to reinstall to change the setting. I have already installed.

Also, I have read through most of the pages and still not sure about the following issue. From what I understand ONE unique user can give 10 feedbacks but they will only count for 1 point in rating. Now my question is which point will be taken. A person can rate "positive" in one feedback transaction and "negative" in another.. You know what I mean? what if in 10 feedbacks 6 is positive and 4 is negative. Will the script count any of those? or is it going to only count the first one? I am very confused.

[xtreme-mobile]

Originally Posted by Polo

you need to add the template changes to your other style...

ive done the template edits on both :ermm:

[djwins]

Is there a way that I can have the Trader Rating notification private message contain a link back to the sender's Trader Rating page?

Thanks again for the awesome hack!

[Telkman]

The actual message is stored in the phrase: tratings_pm_message.

You could have that passed a parameter and return it as part of the phrase, but I think it's probably easier to add it manually.

The last code in traderratings.php is the function for sending the pm. You can easily see what details are being used as far as the username/userid etc are concerned, so it's easy to add the url into $message before it's sent.

If you want the url in the middle of the message, or don't want to hard code the message so it's easy to change in future or translate, you can use a particular unique word in the phrase in place of the userid and then replace it with a string function before inserting the pm.

[djwins]

Hmm...sounds a bit over my head, but thanks!

[hasan2k]

In the template.txt file provided with the installation zip file it says the following:

NOTE: If you only want specific user groups to use the ratings, you will also need to modify the traderratings.php code to prevent users from getting to the feedback page through manual URLs (unlikely, but possible). This feature will be fully implemented in the next version (if you don't want to modify the php file).

Can anyone here tell us the what code in the php file to modify. I have done the template modification to not allow certain user groups but i want to make it full proof so that none can use the ratings system via manually going to the trader ratings pages (all pages in TR).

I would appreciate if someone here gives me the actual code to reflect the change.

[kobescoresagain]

Would it be possible to make a small module for vbadvanced that shows like the top 5 rated members or something?