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

[eoc_Jason]

Okay, I think I can confidently say that by Monday I will have the 3.5.x version released.

I should be able to finish coding it tomorrow (Friday), then I can put it on my own forum to have them test it out and fix any last minute bugs / typos. I've already got a full weekend of holiday festivities that I can not get out of, so mid-moday should be go-day.

I had to break the code out into a few different files, it was starting to become too much to try and manage within a single file. A lot more code than the vB 3.0.0 version.

[jlaine]

Originally Posted by eoc_Jason

Okay, I think I can confidently say that by Monday I will have the 3.5.x version released.

I should be able to finish coding it tomorrow (Friday), then I can put it on my own forum to have them test it out and fix any last minute bugs / typos. I've already got a full weekend of holiday festivities that I can not get out of, so mid-moday should be go-day.

I had to break the code out into a few different files, it was starting to become too much to try and manage within a single file. A lot more code than the vB 3.0.0 version.

Excellent news... I saved all the SQL from the old 3.0.x version instead of deleting it when I upgraded, we'll be able to upgrade and use the existing old data correct?

[dsotmoon]

Originally Posted by eoc_Jason

Okay, I think I can confidently say that by Monday I will have the 3.5.x version released.

great news Jason, thank you for your hard work and time

[eoc_Jason]

Well I'm kind of stuck at the moment and I don't know what the heck is causing this problem.

When you enter a comment via the wysiwyg editor box, and there's an error, when the page is re-created it doesn't fill in the text like it should. If you use the enhanced editor or plain text box it works fine (fills in the text you submitted)... very frustrating. I swear I've peeled over all the code and I can not find out the cause. I know it has to be something simple I'm overlooking.

[ImportPassion]

well, if that is the only thing holding it up, I think I can speak for the rest of us that we wouldn't mind having that feature disabled in order to get a release, then you can work on it and do an update.

what do you think?

D

[eoc_Jason]

There is still a lot more work that *just* that, however it is just one serious issue that is mystifying me....

At first I used the code for the quick reply box and it worked fine, however that template doesn't allow for passing back the text to re-edit, so I had to switch to the full size editor box which does have it. But something is wrong because any info you submit via the wysiwyg box does not actually get submitted, so it's got to be some missing javascript or something I would presume.

EDIT - Oh sweet jesus finally fixed it! Not 100% sure what the issue was, made several template changes at once and now it works... hehe... woohoo! Back to working on error validation....

EDIT AGAIN - Spoke too soon... it's not working again... *grumble*

EDIT AGAIN - Fixed, I hope.... I think it was related to having to run the word length check on submit. Otherwise the text which is sitting in some javascript variable doesn't get passed back to be submitted...

[Ncturnal]

I know how frustrating that can be. Thanks for your hard work. Trader Ratings is a truly remarkable add-on, hack, or whatever you want to call it.

[lanc3lot]

So shall we wait for a 3.5.0 update by Monday mate ?

Thnx for the hard work

[techxpert]

We are waiting for 3.5 compatible version

[eoc_Jason]

Monday Morning Update

I decided to go ahead and implement dedicated iTrader "usergroup" permissions. Right now there are only 3: "can view", "can rate", and "can admin". It was getting to the point of just plain dumb trying to use generic usergroup permissions based on forum things, so I figured this would be the smarter route since a lot of people only have certain user groups they allow to rate with this system.

So here's what's left to do:

• finishing changing out all the permission code & make sure everything is correct
• finish up comment editing code and some display stuff on the comment page
• finish coding the "rating link" page and make sure all checks are correct.
• add in the last couple vB CP option checks (real quick)
• move some bits of text in templates to phrases
• double check all phrases / templates / everything else is listed under the "iTrader" product.
• compile all the files together, write some quick documentation, and get them posted online!

Editing comments would be a lot nicer with ajax, however that's definitly going to have to wait until the next release since I don't have a clue where to start for that and it's not *that* critical.

So, hopefully sometime this afternoon / evening I should be finished. (Finally!) It's all getting down to the "little things" and ironing out the little bugs.