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 eoc_Jason

vB styles work from inheritence, your default TR templates should be the highest level, and allow the alternate styles to "inherit" them. If they aren't you will need to move them to the proper style, then you can customize alternate styles without affecting the templates globally.

wow i totally didnt understand that lol

[Tilmanitou]

Hi all!
I translated Trader Ratings (v1.10 and v1.2.0, into german) for my forum and wanted to share this little procedure with you all so you can do it now much quicker than I did. :glasses:

It's pretty easy:

0.
First of all, you have to install Trader Ratings. It's now in english of course.
To translate it:

1.
In the vB Admin Control Panel, search all Phrases which names begin with "tratings" and translate them in the second field. In doing so, the original text keeps beeing saved as well as your translation.

2.
In the template "tratings_feedback", search for the following text:

PHP Code:

<td class="alt2">Your overall experience was:</td>
        <td class="alt2">
         <select name="userrating"> 


and translate "Your overall experience was:".

3.
In the template "tratings_feedback", search for the following text:

PHP Code:

<td class="alt2">$vbphrase[tratings_thread_url]</td>
        <td class="alt2">
        <input class="bginput" type="text" name="userurl" size="45" maxlength="200" 

value="$trating[userurl]"><br />
        <span class="smallfont">ex:
 http://forum.site.com/showthread.php?threadid=1234</span>
        </td> 


and translate "ex: http://forum.site.com/showthread.php?threadid=1234".

4.
In the template "tratings_feedback", search for the following text:

PHP Code:

<input type="checkbox" name="ratingdelete" value="1">Delete This Rating</if>
        </span><br /><br /><input type="submit" 


and translate "Delete This Rating".

5.
In the file "traderratings.php", translate:
-"View Trader Ratings"
-"Edit Trader Ratings Feedback"
-"Submit Trader Ratings Feedback"

6.
In the templates "postbit", "postbit_legacy", and "MEMBERINFO",
add somewhere:

PHP Code:

<if condition="$post['userid']"><div>Trader Rating: (<a href="traderratings.php?$session[sessionurl]u=$post[userid]">$post[ratetradetotal]</a>)</div></if> 


and translate "Trader Rating:".

for example:

- in the template "MEMBERINFO", above

PHP Code:

<if condition="$vboptions['usereferrer']"> 


add:

PHP Code:

<if condition="$post['userid']">
<div class="fieldset">
<div style="padding:$stylevar[formspacer]px"><strong>Trader Rating:</strong> (<a href="traderratings.php?$session[sessionurl]u=$post[userid]">$post[ratetradetotal]</a>)
</div></div></if> 


and translate "Trader Rating:".

- in the template "postbit_legacy" (you have to choose this template as default first. this is the vB2-Style member info frame at the left of every post, not above it),
above

PHP Code:

<if condition="$post['joindate']"><div>$vbphrase[join_date]:" 


add:

PHP Code:

if condition="$post['userid']"><div>Trader Rating: (<a 
href="traderratings.php?$session[sessionurl]u=$post[userid]">$post[ratetradetotal]</a>)</di
v></if> 


and translate "Trader Rating:".


Thats all! Hope I didn't forgot or messed up something (please let me know in case) and that this will help spreading this great hack all over the world! Thanks again eoc_Jason!

Yours
Tilmanitou

[eoc_Jason]

Hmm... looks like there were a few more places I could of used phrases... I'll have to fix that in the next update... I tried to phrases wherever possible for easier translation...

[lifesourcerec]

How hard with it be to make a Top 10 traders/feedback page? Or just a table to add to the forum home?

[WreckRman2]

Originally Posted by lifesourcerec

How hard with it be to make a Top 10 traders/feedback page? Or just a table to add to the forum home?

I like that...

[WreckRman2]

Originally Posted by eoc_Jason

Everyone Else - So do you think it would be more worthwhile to just start working on a classifieds / auction hack (with the trader ratings system of course) rather than just try to bodge together this "buy/sell" button concept thing?

Please let me know what you guys think...

Not only do I think you should but I'd be willing to pay for it if done well. I'd love to see an integration of a For Sale, Trade and Wanted Ads with vB.

[jesslynn]

I hope someone can help me. I'm getting a perplexing error (well, to me anyway! LOL) when I try to view anyone's rating, no matter the style I try it in:

Fatal error: Call to undefined function: convert_ids_to_titles() in /****/****/****/****/includes/functions_online.php on line 33

I'm sure it's my overtired brain, but I can't figure out what to do about it. Any help would be GREATLY appreciated! Oh yeah, would help if I gave you the link to our forums: http://www.boutiquebids.com/forums

TIA!

[Watson]

Had another read through this thread, dunno if its just late, or I am well thick (mabye both)

But I am wondering, which file I edit so I make it the users have to enter a url for them to leave feedback. Also can I make it so that it only comes from a specific forum?

Also, Is there anyway to click under the username or something to actually leave feedback, the only way I been doing it is by clicking on the users trader rating number. Hoping to put like an icon or summit somewhere.

Cheers much

A very knackered

Watson

[Watson]

Originally Posted by eoc_Jason

Watson - look at the extra template examples with the is_member_of function to allow only specific user groups. You will need to change this on your trating_display template, and also add it to the proper actions in the traderratings.php file.

Ahh mate, I aint really sure what I would be looking for in those files, and I dont wanna change anything that may damage forums heh.

Any chance on an ickle bit more info

[jesslynn]

Can't anyone help a gal out? hehe jk

In thinking about this (whilst banging my head upon my desk all weekend), I'm wondering if my problem is because I have other hacks installed, or if I made a silly mistake somewhere and I'm just not seeing it.

To be a little more specific about when we get the error on our boards, members can't view profiles without getting the script error:

Fatal error: Call to undefined function: convert_ids_to_titles() in /****/****/****/****/includes/functions_online.php on line 33

Also, when attempting to view Currently Active Users, we get:

Fatal error: Call to undefined function: sanitize_perpage() in /****/****/****/****/forums/online.php on line 77

Any ideas on what I need to do so this awesome hack will work for us? It's EXACTLY what we've been looking for. Do I need to go in and tweak something or rerun the install?