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

[hasan2k]

Does the latest version (1.2.0) contain the ability to limit access by usergroup(s)?

I could not find this important information anywhere in the posts..may be I overlooked. Can someone please tell me?

[eoc_Jason]

By default if a user has generic posting permissions, then they can use the Trader Ratings system.

However if you want to limit it even further, you can simply add conditional statements in your templates (with the is_member_of() function). Also you can add the same code to the traderratings.php file to make it 100% complete, but usually just editing the templates is enough so that only certain user groups can view / rate people.

[alkatraz]

finaly got this working

originaly had vbtrader on my vb2 board
upgraded to vb3 and ran into some problems with duplicate fields/tables with this installer (not upgrader)
dropped the conflicting db stuff and got it to work on one style but even after running the installer on multiple styles it still didnt add them
installed the templates manualy from the installer and

it's not working great!

thx for a fantastic script, looking forward to the complete classified system

[horrordvds.com]

I don't want to have to read through all the pages, so maybe someone can answer for me. Can I manually set someone's feedback number? We have a manual system now and I'd like to implement this, but it would be nice for people to be able to keep their current numbers. Follow what I'm saying?

[eoc_Jason]

To answer your question, no you can't. The system recalculates out their score each time a ratings is added.

You *could* in theory generate a bunch of old ratings (using some sort of script would probably be the easiest), but you would run into the problem of not having them by a unique user.

[tteal]

Awesome mod, however, everytime someone tries to read a rating, they get this message:

The Trader Ratings system is currently down for maintainence, but will be back up as soon as possible.

How can that be fixed?

Tks,
Tim

[Cyn]

A couple of questions.

1. Edited to say: Found the answer to my own question.

2. Is it possible to set submitted ratings to be moderated for approval?

3. How can I fix the "You are responsible for your own words" screen that is extended beyond the screen requiring vertical scrolling to view it completely? See attachment.

Fabulous hack! Thanks!

[Cyn]

Something else. In a member's profile where it shows their location when logged in it shows:
Unknown Location /discussions/traderratings.php? @ 09:32 PM

Can we correct this to say Viewing Trader Ratings or something?

And another something else. Is it possible for members to opt out of receiving a PM for every rating someone leaves them?

[eoc_Jason]

tteal - Did you do an upgrade or new install?

Cyn - No, there is no mod approval in this system, and I doubt there will be in the future. Most people watch their ratings like a hawk and if something isn't right I always get a PM about it.

As for the text, it's all just in the template (I think that might actually be a phrase). However you can just adjust the table structure to stack one on top of the other instead of side-by-side.

As for the unknown location, you can modify your online.php file (I think it is that one) and add a custom location for that file (I believe there are 2 places). I don't like hacking separate files which is why I didn't include it (since it's not really a big deal). However if you really want just do a search as I'm sure you can follow some similar instructions for editing that file.

[Cyn]

Originally Posted by eoc_Jason

tteal - Did you do an upgrade or new install?

Cyn - No, there is no mod approval in this system, and I doubt there will be in the future. Most people watch their ratings like a hawk and if something isn't right I always get a PM about it.

As for the text, it's all just in the template (I think that might actually be a phrase). However you can just adjust the table structure to stack one on top of the other instead of side-by-side.

As for the unknown location, you can modify your online.php file (I think it is that one) and add a custom location for that file (I believe there are 2 places). I don't like hacking separate files which is why I didn't include it (since it's not really a big deal). However if you really want just do a search as I'm sure you can follow some similar instructions for editing that file.

Thanks for the prompt response. Our members think this feature rocks!