Major Additions - iTrader v2.0.1

iTrader - A user feedback add-on for vBulletin 3.5.x
Copyright ?2004-2005 Jason Rabel, All Rights Reserved.
__________________________________
Latest iTrader Verson: 2.0.1
vB Versions Supported: 3.5.x & 3.6.x
Author: Jason Rabel
Contact: PM me here.
Site: EXTREME Overclocking
??????????????????????????????????
Description:
iTrader for vB 3.5.x & 3.6.x has evolved from Trader Ratings for vB 3.0.x which evolved from Buy/Sell/Trade User Rating System for vB 2.x. 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 somewhat based on the honor system since there is no automatic way to truly tell if they did engage in a transaction. iTrader 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 in each transaction: Buyer, Seller, or Trade
• Leave multiple comments about the deal
• Dates & IPs are all recorded to prevent abuse
• Specify a thread URL to the deal
• Advanced URL checking
• 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)
• iTrader Admins can edit/delete anyone's ratings (just incase)
• PM notification when new rating or comment is left
• Per-usergroup permissions
• Lots of admin controllable options

Installation / Upgrade Info:
Read the included readme file, it explains everything.

Standard Disclaimer:
BACKUP YOUR DATABASE & FILES BEFORE IMPLEMENTING THIS HACK!!!

Donations:
This add-on will always be free, however your donations are kindly accepted and will help towards further development. The link is on the right under "The Developer" info.

Future Additions:

• AdminCP & ModCP Menus for searching IPs, stats, mass-prune, etc
• Better navigation across pages
• Better error descriptions
• Adjust action icons some
• Page to link two ratings manually
• AdminCP Option to choose how ratings are ordered (asc or desc by time)
• AJAX editing

Release History:
2.0.1 - December 18, 2005
2.0.0 - December 14, 2005

Detailed template edits : (Link)

[AllenMead]

Thanks Patrick, sorted works a treat!

[AllenMead]

Ah, one other thing, how do I get it to show both the feedback number and the percentage, I can only get it to show one or the other.

Thanks.

[mariannet]

I have the following error and I know it's because of my PHP version, but I have had it once before and then I could use a different term [than html_entity_decode]
to solve it, can't remember what - can you help?

Call to undefined function: html_entity_decode() in /home/xxx/xxx-www/includes/functions_itrader.php on line 22

[mariannet]

Originally Posted by mariannet

I have the following error and I know it's because of my PHP version, but I have had it once before and then I could use a different term [than html_entity_decode]
to solve it, can't remember what - can you help?

Call to undefined function: html_entity_decode() in /home/xxx/xxx-www/includes/functions_itrader.php on line 22

Sorted and in case anyone else should need it:

Open /includes/functions_itrader.php

Go to line 17
On the line before: function itrader_checkurl($dealurl)
Add:

function html_entity_decode($string) 
{
$trans_tbl = get_html_translation_table(HTML_ENTITIES);
$trans_tbl = array_flip($trans_tbl);
return strtr($string, $trans_tbl);
}

[desimedia]

ok, I made the relevant changes to the memberlist files, but what about the other changes? how can someone give feedback/rating? where is that option? I am pretty new to this, so any step by step would be nice.

thanks

[jmw]

Where exactly can this plugin be translated to other language? Do I have to go through the code and translate it or do I just search phrases in vbulletin and translate them? Sorry, I have no clue as to how to do it. Thanks in advance.

[kontrabass]

How can I control who gets 'suspicious activity' and warning emails? I don't need them sent to all 40 of my moderators...

[CB88]

I was running the older version of this on my vbulletin 3.0.3

I just updated to 3.5.3 and it no longer works. The feedback score is still there but does not work upon clicking.

I tried all the installation instructions but am still very new to this...

I am confused about what to do with the templates...any help would be appreciated.

[bada_bing]

Originally Posted by CB88

I was running the older version of this on my vbulletin 3.0.3

I just updated to 3.5.3 and it no longer works. The feedback score is still there but does not work upon clicking.

I tried all the installation instructions but am still very new to this...

I am confused about what to do with the templates...any help would be appreciated.

Template Instructions:
Two fields are added to the "user" table to facilitate rating usage pretty much anywhere you please within the forum. The two fields are:

itrader_total - iTrader Score (stored as an integer)
itrader_pcnt - Percent Positive Feedback (also stored as an integer)
Most likely you will want to add the score info to the postbit and/or postbit_legacy template(s), MEMBERINFO, and memberlist_resultsbit template. Actual placement and style is entirely up to you, however here's a sample to get you started. Note that the MEMBERINFO & memberlist_resultsbit templates won't need the conditional around the text since you can't view a "guest" in those cases.

<if condition="$post['userid']"><div>iTrader: (<b><a href="itrader.php?$session[sessionurl]u=$post[userid]">$post[itrader_total]</a></b>)</div></if>

Additionally it would be wise to have some sort of link that is easily accessible to your members so they can view their own ratings. My suggestion would be to add some code in the navbar or usercp menu somewhere. If no userid is specified then the system defaults to the user's own iTrader page.

<a href="itrader.php?$session[sessionurl]">iTrader</a>

Use your imagination where you want these links to be visible, there's nothing set in stone where it should be display or how it should look. Some people wanted the percent score so I added in this version. You can get creative and use some stars or something based on their score or positive ranking.

If you only wanted the info to show up for specific usegroup, you can use the "is_member_of()" function conditional in your templates. Also if you only wanted it to show up for specific forum sections, you could use the "in_array()" function. Read more in the vBulletin documentation for nifty things with template conditionals.



Sorry to skimp on the documentation, next release will be much better, however most people should know what they are doing by now with templates and if you don't, spend the time to learn as you can greatly enhance your forum.

[CB88]

Figured it out...works great.