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

[phonexpo]

Hi,

I'm tring to intsall this hack, but I get this error. Can anyone advice me on what I'm doing wrong.

Thanks

Fatal error: Call to a member function on a non-object in /home/www/xxxxxxxxxx/admincp/install_traderratings.php on line 468

[0ptima]

Originally Posted by eoc_Jason

Yesterday I spent the entire afternoon just coding part of the AdminCP stuff. I figured it would be nice to move the variables out of the PHP file and into their "proper" location. It took me a LOT longer because I was having to figure it out for myself and insert all the data manually into the DB. After I finished everything, I discovered that if you turn on Debug Mode then additional options appear to add new setting things... DOH! Better documentation for developers would go a LONG way.

Anyhow, still have to finish the AdminCP / ModCP tools. Problem with that is the AdminCP you can use an XML file, but for the ModCP you have to use hooks (that makes no sense but it's how they did it). I don't think I will get a chance to work on it today though. Wish I could give you guys an ETA when it will be released, but I'm working as fast as I can, my forum members want this back too, but I don't want to release a half-assed version.

Thanks for the update!

[tokenyank]

No problem Jason, thanks for doing this up for us...

As I'm very keen to upgrade and am only really waiting for this one to be done, could you just confirm whether or not this is going to come with an upgrade path from the 3.0.x series to the 3.5?

If yes, I can upgrade now and just disable the trader ratings until I can run the upgrade.

If no, I'll wait longer!

Thanks again

[phonexpo]

Originally Posted by phonexpo

Hi,

I'm tring to intsall this hack, but I get this error. Can anyone advice me on what I'm doing wrong.

Thanks

Anyone help me ? :disappointed:

Fatal error: Call to a member function on a non-object in /home/www/xxxxxxxxxx/admincp/install_traderratings.php on line 468

[eoc_Jason]

tokenyank - yes, there will initially be a separate install file for people wanting to upgrade from vB 3.0.x (assuming you are running TR 1.2.0), however I'm including instructions for things to "double check" just to make sure it removed all the old things that are not used / needed anymore. After than only one file should be needed for future upgrades.

phonexpo - Are you are trying to install on a 3.0.x or 3.5.0? Did you already have a failed install and you tried to re-run the script?

[phonexpo]

Originally Posted by eoc_Jason

phonexpo - Are you are trying to install on a 3.0.x or 3.5.0? Did you already have a failed install and you tried to re-run the script?

I'm putting it on 3.5.0 & I got that error the first time I tried to install it. What can I do now ?

[eoc_Jason]

This version will not work for 3.5.0, it's only for 3.0.6

Originally Posted by phonexpo

I'm putting it on 3.5.0 & I got that error the first time I tried to install it. What can I do now ?

[phonexpo]

Originally Posted by eoc_Jason

This version will not work for 3.5.0, it's only for 3.0.6

Doh !

[MR-2ZZ]

Great update Jason

[eoc_Jason]

Attention - Attention - Attention - Attention

I need a couple (meaning 2 or 3) beta testers for the new vB 3.5.0 version.

Prerequisites:

• Must currently be running vB 3.5.0
• Must have previously used TR 1.2.0 & have not touched the data since the update.
• Must have an ACTIVE forum with people using the ratings. (If nobody uses it then it can't be tested very effectively).
• Must have email and / or IM for quick contact to resolve bugs.
• MUST MUST MUST be knowledgable with vB templates, phrases, and database skills. (i.e. You would know how to backup / restore a table, or at least use phpmyadmin proficiently.)
• Must be willing to submit ideas / suggestions / changes (not like code changes per-say, just how you think something should work in general).
• Must be willing to accept the fact that they are beta testing and bugs / issues will arrise.

Please contact me via PM if you are interested, be sure to include your forum URL, email address, and IM screename (and which service it is).

Also, please be aware that tomorrow is Sunday, and I usually do not get online much, so my earliest replies will probably be Monday morning for everything.

The sooner this can all be tested (both functionality & installation), the sooner it can become an official public release.


UPDATE - Thanks for everyone that contacted me. I think I have enough people to test it now (and even a couple translations).