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

[sketch42]

Originally Posted by lifesourcerec

Dunno if this is already a feature or not, but how can you make:

Specific URL mandatory and somehow make it where that a link a\can only be used twice (one time for each involved).

2 things .... i havent installed this yet but i want to install it on 2 templates what do i need to edit.. how do i find out what the style id's are?


also can u make it so only a thread from a particular forum(s) is valid?
so say my B/S/T forum is located at /forumdisplay.php?f=49 ; /forumdisplay.php?f=50 ; /forumdisplay.php?f=51

only threads from those forums would be valid?

also i almost forgot... i dont have access to phpMyadmin can u make a query install file?

[NameWolf]

Installed ! Great work.

Regards,

NW

[drumsy]

Originally Posted by sketch42

2 things .... i havent installed this yet but i want to install it on 2 templates what do i need to edit.. how do i find out what the style id's are?


also can u make it so only a thread from a particular forum(s) is valid?
so say my B/S/T forum is located at /forumdisplay.php?f=49 ; /forumdisplay.php?f=50 ; /forumdisplay.php?f=51

only threads from those forums would be valid?

also i almost forgot... i dont have access to phpMyadmin can u make a query install file?

The install file does your database modifications for you.

[sketch42]

Originally Posted by drumsy

The install file does your database modifications for you.

thanks... do u also know bout my first question bout the styles?

[EyeCrave]

Thanks.

I've had people asking me to implement a trading forum for DVDs. Thanks to this it makes it easier for me to watch over them.

[Bungie]

Very nice! Installation was a breeze. Exactly what I was looking for. Fine, fine job.

[sketch42]

ok 2 things

i installed it and its great, but when i click on the trader rating on one of my templates i get a blank page one template works fine.. but not the other...

and second

The thread URL to the deal:
(optional)

can u make that mandatory
not an option??

Great hack ... clicks Install

[Spinball]

Originally Posted by sketch42

2 things .... i havent installed this yet but i want to install it on 2 templates what do i need to edit.. how do i find out what the style id's are?

I had to deal with something like this.
It's easy if you have a style used as a parent style of those you want to update.
I have a parent style which is not actually available for use by forum members but which acts as a parent for all 4 styles I have created for my members.
One of the child styles is usually the default one.
For the installation of this hack I made the parent style the default one and the installation process automatically updated the parent and all the child styles.
I then made usual style the default again.

The key to this is that if you update a parent style, all the children get updated automatically aswell.

[Spinball]

Originally Posted by sketch42

ok 2 things
i installed it and its great, but when i click on the trader rating on one of my templates i get a blank page one template works fine.. but not the other...

See my post above. I have the same problem when I installed the Arcade.
Basically the installation procedure gets the default template and edits it.
So it's edited your default template, left the other alone and of course that one won't work, now.
What you'll have to do now is edit the installtion script to just run the template editing process, make the non-working template the default and then run the installation.
In the future follow my advice above. (Hope this is right, Jason?).

[Spinball]

Jason I have a feature request which would be useful for us. If there were an option available within the trade rating screen to moderator/supermod/admin folks which allows all negative feedback to be listed then it would be easy to see whether some users have been 'spoiling' others' reputation without good cause.