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

[doug97gxe]

depends on which post bit are you using.. you using postbit or postbit_legacy for the old style.

I threw mine below posts and above reputation

<div>
$vbphrase[posts]: $post[posts]
</div>
<if condition="$post['userid']"><div>Buyer/Seller Rating: (<a href="traderratings.php?$session[sessionurl]u=$post[userid]">$post[ratetradetotal]</a>)</div></if>
<if condition="$post['rank']"><div class="smallfont">$post[rank]</div></if>

</div>
<div>$post[reputationdisplay]</div>

[Noonster]

Originally Posted by wrang

Where shuold i put this code in the postbit template??

<if condition="$thread[forumid] == 16">
(trader ratings row)
</if>

Does anyone know the answer to this ??

Thanks

[bigcurt]

Please jason, test it on my board if you get anything..my site couldnt live without this hack

[akoj]

This is the most used hack on my site. I wouldn't consider the upgrade until a 3.5 hack is available.
I know this has been discussed many times but when/if you release a new version would it be possible to allow multiple feedback from one user to count? My members want the ability to show how many trades a person has made on our site.

[Blootix]

Originally Posted by akoj

This is the most used hack on my site. I wouldn't consider the upgrade until a 3.5 hack is available.
I know this has been discussed many times but when/if you release a new version would it be possible to allow multiple feedback from one user to count? My members want the ability to show how many trades a person has made on our site.

Hi, I was wondering if/when is this hack going to be upgraded to 3.5? It's pretty much crucial that we have it for our forums

Also, is there a way to do a one-button "Delete All Ratings For This User" thing? I've tried to edit traderratings.php but I'm no good at php. Anybody help please ?

[eoc_Jason]

1. When the final release of 3.5.x is available, then an updated version of this hack will be released. Not until then... I'm sorry to do that, but if anyone remembers how many changes vB 3.0 went through before it finally became a stable release, you would understand.

2. There is no "delete all ratings" button, I never considered that a valid action. However you could manually go into the database and delete all based on his userid, and manually update the TR info in the user table too.

3. If you want multiple feedbacks to count towards the score, simply modify the function at the bottom of the traderratings.php file. It's not that complicated to modify.

[cherieann]

nm, great mod installed

trying to change the word "optional" on my trading to "mandatory"

i've already edited the .php so it'll be mandatory, but cannot find the words "optional" anywhere in tratings_thread_url

Then modify the phrase tratings_thread_url and removed the "(optional)" text.

i'm assuming it's using $vbphrase.. but i'm not very good at php to know where to edit that specific vbphrase

anychance you can point me in the right direction?

thanks

[eoc_Jason]

Phrases are edited via the AdminCP... Under the "Languages / Phrases" section (or something similar to that... it's the 3rd choice on the list I believe).

[kobescoresagain]

is there a way to change it so it displays a number, then something like 5 stars. I don't think it would be that hard, could be done with a while statement, I believe. Anyone know how to do this.

[eoc_Jason]

Why would you want a star rating instead of numbers? I don't see how the two would correlate, unless you made the # of stars relevant to the % of positive feedback.