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)

[nate247]

Right, think I have done everything right so far as Itrader has been installed successfully.

I followed the instructions carefully and first uploaded the files into their corresponding folders. Then I installed the XML files, then changed the settings / permissions etc.

Now the only bit I am struggling to get my head round (being completely new to forum sortware & upgrades) is where to insert the code?

I know how to edit the templates in the Vbulletin admin page and this often brings up code but to be honest I am a fish out of water in terms of where to put it and I was wondering if anyone was able to take 2 mins to step by step direct me where the code needs to be pasted.

Please go easy on me, if I can do this I will be over the moon lol

All the best, Nathan.

[XrayHead]

Ok do we still have this page avalable for the user's to look at and if not why?



Xray

[kellyandmike]

Originally Posted by XrayHead

Ok do we still have this page avalable for the user's to look at and if not why?

Xray

There is a hack out for that. Do a search for mainpage itrader.

[nate247]

Ok, I have found where I need to insert the code (postbit) but I was wondering exactly where I should input it? The code for my template is below (sorry its so long) but I was wondering if anyone could point to where it needs to be inserted???

Many Thanks, Nathan.

<!-- post #$post[postid] -->
<if condition="$show['spacer']">
$spacer_open
<div id="edit$post[postid]" style="padding:0px 0px $stylevar[cellpadding]px 0px">
<if condition="!$post['islastshown']"><!-- this is not the last post shown on the page --></if>
</if>

<table class="tborder" id="post$post[postid]" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
<td class="thead" $post[scrolltothis]>
<div class="normal" style="float:$stylevar[right]">
&nbsp;
<if condition="$show['postcount']">#<a href="showpost.php?$session[sessionurl]p=$post[postid]&amp;postcount=$post[postcount]" target="new" rel="nofollow" id="postcount$post[postid]" name="$post[postcount]"><strong>$post[postcount]</strong></a> &nbsp;</if>
<if condition="$show['reputationlink']"><a href="reputation.php?$session[sessionurl]p=$post[postid]" rel="nofollow"><img class="inlineimg" src="$stylevar[imgdir_button]/reputation.gif" alt="<phrase 1="$post[username]">$vbphrase[add_to_xs_reputation]</phrase>" border="0" /></a> &nbsp;</if>
<if condition="$show['reportlink']"><a href="report.php?$session[sessionurl]p=$post[postid]" rel="nofollow"><img class="inlineimg" src="$stylevar[imgdir_button]/report.gif" alt="$vbphrase[report_bad_post]" border="0" /></a> &nbsp;</if>
$post[iplogged]
<if condition="$show['inlinemod']">
<input type="checkbox" name="plist[$postid]" id="plist_$postid" style="vertical-align:middle; padding:0px; margin:0px 0px 0px 5px" value="$post[checkbox_value]" onclick="inlineMod.toggle(this)" />
</if>
</div>

<div class="normal">
<!-- status icon and date -->
<a name="post$post[postid]"><img class="inlineimg" src="$stylevar[imgdir_statusicon]/post_$post[statusicon].gif" alt="$post[statustitle]" border="0" /></a>
<if condition="!$show['announcement']">
$post[postdate]<if condition="!$show['detailedtime']">, $post[posttime]</if>
<else />
<phrase 1="$post[startdate]" 2="$post[enddate]">$vbphrase[x_until_y]</phrase>
</if>
$post[firstnewinsert]
<!-- / status icon and date -->
</div>
</td>
</tr>
<tr>
<td class="alt2" style="padding:0px">
<!-- user info -->
<table cellpadding="0" cellspacing="$stylevar[cellpadding]" border="0" width="100%">
<tr>
<if condition="$show['avatar']"><td class="alt2"><a href="member.php?$session[sessionurl]u=$post[userid]"><img src="$post[avatarurl]" $post[avwidth] $post[avheight] alt="<phrase 1="$post[username]">$vbphrase[xs_avatar]</phrase>" border="0" /></a></td></if>
<td nowrap="nowrap">

<div id="postmenu_$post[postid]">
<if condition="$show['profile']">
<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a>
$post[onlinestatus]
<script type="text/javascript"> vbmenu_register("postmenu_$post[postid]", true); </script>
<else />
$post[musername]
</if>
</div>

<if condition="$post['usertitle']"><div class="smallfont">$post[usertitle]</div></if>
<if condition="$post['rank']"><div class="smallfont">$post[rank]</div></if>

</td>
<td width="100%">&nbsp;</td>
<td valign="top" nowrap="nowrap">

<div class="smallfont">
<if condition="$post['joindate']"><div>$vbphrase[join_date]: $post[joindate]</div></if>
<if condition="$post['field2']"><div>$vbphrase[location_perm]: $post[field2]</div></if>
<if condition="$post['age']"><div>$vbphrase[age]: $post[age]</div></if>
<div>
$vbphrase[posts]: $post[posts]
</div>
<if condition="$show['reputation']"><if condition="$show['reppower']">$vbphrase[reppower]: $post[reppower] </if><div>$post[reputationdisplay]</div></if>
<div>$post[icqicon] $post[aimicon] $post[msnicon] $post[yahooicon] $post[skypeicon]</div>
</div>

</td>
</tr>
</table>
<!-- / user info -->
</td>
</tr>
<tr>
<td class="alt1" id="td_post_$post[postid]">
<!-- message, attachments, sig -->

<if condition="$show['messageicon'] OR $post['title']">
<!-- icon and title -->
<div class="smallfont">
<if condition="$show['messageicon']"><img class="inlineimg" src="$post[iconpath]" alt="$post[icontitle]" border="0" /></if>
<if condition="$post['title']"><strong>$post[title]</strong></if>
</div>
<hr size="1" style="color:$stylevar[tborder_bgcolor]" />
<!-- / icon and title -->
</if>

<!-- message -->
<div id="post_message_$post[postid]">$post[message]</div>
<!-- / message -->

<if condition="$show['attachments']">
<!-- attachments -->
<div style="padding:$stylevar[cellpadding]px">

<if condition="$show['thumbnailattachment']">
<fieldset class="fieldset">
<legend>$vbphrase[attached_thumbnails]</legend>
<div style="padding:$stylevar[formspacer]px">
$post[thumbnailattachments]
</div>
</fieldset>
</if>

<if condition="$show['imageattachment']">
<fieldset class="fieldset">
<legend>$vbphrase[attached_images]</legend>
<div style="padding:$stylevar[formspacer]px">
$post[imageattachments]
</div>
</fieldset>
</if>

<if condition="$show['imageattachmentlink']">
<fieldset class="fieldset">
<legend>$vbphrase[attached_images]</legend>
<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
$post[imageattachmentlinks]
</table>
</fieldset>
</if>

<if condition="$show['otherattachment']">
<fieldset class="fieldset">
<legend>$vbphrase[attached_files]</legend>
<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
$post[otherattachments]
</table>
</fieldset>
</if>

<if condition="$show['moderatedattachment']">
<fieldset class="fieldset">
<legend>$vbphrase[attachments_pending_approval]</legend>
<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
$post[moderatedattachments]
</table>
</fieldset>
</if>

</div>
<!-- / attachments -->
</if>

<if condition="$post['signature']">
<!-- sig -->
<div>
__________________<br />
$post[signature]
</div>
<!-- / sig -->
</if>

<if condition="$show['postedited']">
<!-- edit note -->
<div class="smallfont"> <hr size="1" style="color:$stylevar[tborder_bgcolor]" />
<em>
<phrase 1="$post[edit_username]" 2="$post[edit_date]" 3="$post[edit_time]">$vbphrase[last_edited_by_x_on_y_at_z]</phrase>.
<if condition="$post['edit_reason']">$vbphrase[reason]: $post[edit_reason]</if>
</em>
</div>
<!-- / edit note -->
</if>

<div align="$stylevar[right]">
<!-- controls -->
<if condition="$post['editlink']">
<a href="$post[editlink]" name="vB::QuickEdit::$post[postid]"><img src="$stylevar[imgdir_button]/edit.gif" alt="$vbphrase[edit_delete_message]" border="0" /></a>
</if>
<if condition="$post['forwardlink']">
<a href="$post[forwardlink]"><img src="$stylevar[imgdir_button]/forward.gif" alt="$vbphrase[forward_message]" border="0" /></a>
</if>
<if condition="$post['replylink']">
<a href="$post[replylink]" rel="nofollow"><img src="$stylevar[imgdir_button]/<if condition="$post['forwardlink']">reply_small<else />quote</if>.gif" alt="$vbphrase[reply_with_quote]" border="0" /></a>
</if>
<if condition="$show['quickreply'] AND !$show['threadedmode']">
<a href="$post[replylink]" rel="nofollow" id="qr_$post[postid]" onclick="return false"><img src="$stylevar[imgdir_button]/quickreply.gif" alt="$vbphrase[quick_reply_to_this_message]" border="0" /></a>
</if>
<if condition="$show['moderated']">
<img src="$stylevar[imgdir_misc]/moderated.gif" alt="$vbphrase[moderated_post]" border="0" />
</if>
<!-- / controls -->
</div>

<!-- message, attachments, sig -->

</td>
</tr>
</table>

<!-- post $post[postid] popup menu -->
<div class="vbmenu_popup" id="postmenu_$post[postid]_menu" style="display:none">
<table cellpadding="4" cellspacing="1" border="0">
<tr>
<td class="thead">$post[username]</td>
</tr>
<if condition="$show['profile']">
<tr><td class="vbmenu_option"><a href="member.php?$session[sessionurl]u=$post[userid]">$vbphrase[view_public_profile]</a></td></tr>
</if>
<if condition="$show['pmlink']">
<tr><td class="vbmenu_option"><a href="private.php?$session[sessionurl]do=newpm&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[send_private_message_to_x]</phrase></a></td></tr>
</if>
<if condition="$show['emaillink']">
<tr><td class="vbmenu_option"><a href="sendmessage.php?$session[sessionurl]do=mailmember&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[send_email_to_x]</phrase></a></td></tr>
</if>
<if condition="$show['homepage']">
<tr><td class="vbmenu_option"><a href="$post[homepage]"><phrase 1="$post[username]">$vbphrase[visit_xs_homepage]</phrase></a></td></tr>
</if>
<if condition="$show['search']">
<tr><td class="vbmenu_option"><a href="search.php?$session[sessionurl]do=finduser&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[find_all_posts_by_x]</phrase></a></td></tr>
</if>
<if condition="$post['userid'] AND $show['member']">
<tr><td class="vbmenu_option"><a href="profile.php?$session[sessionurl]do=addlist&amp;userlist=buddy&amp;u=$post[userid]"><phrase 1="$post[username]">$vbphrase[add_x_to_buddy_list]</phrase></a></td></tr>
</if>
</table>
</div>
<!-- / post $post[postid] popup menu -->

<if condition="$show['spacer']">
</div>
$spacer_close
</if>
<!-- / post #$post[postid] -->

[kellyandmike]

Originally Posted by nate247

Ok, I have found where I need to insert the code (postbit) but I was wondering exactly where I should input it? The code for my template is below (sorry its so long) but I was wondering if anyone could point to where it needs to be inserted???

Many Thanks, Nathan.

Nathan,
There is a box on the bottom of the template code called "Search in Template". In the readme file, it says, find "x" code. Put that code in the search box and hit find. The program will highlight it when it finds it. Do whatever the readme file says as far as put after, replace etc.

HTH!

[nate247]

Sorry to sound stupid but I really cant figure this out. (I really appreciate the help so far though) and I am really trying

I am very new to the whole forum software and am struggling like hell to get the code side of things done.

Do I insert the code into the itrader_user & itrader_userbits, or do I put the code into the postbit / postbit_legacy (not that I know what either of those means).

I realise that the instructions are probably written for people that know what they are doing, where as I am not really up to speed with things yet.

The instructions (as far as I can see) do not ask for you to search for any code, it simply says put (and then displays the code) into either the postbit or postbit_legacy, then in the members area.

Thats where I am basically at. I have uploaded the files, installed the xml file, set the preferences etc (as per the instructions) then I get to the ammend template part and am coming unstuck here.

Sorry to be a real pest. Its just I have been promising the forum members a trading / seller section for a while now and just can't find the simple user guide that my current limited knowledge craves.

Thanks again for all the help so far..... Nathan.

[kellyandmike]

Originally Posted by nate247

Sorry to sound stupid but I really cant figure this out. (I really appreciate the help so far though) and I am really trying

I am very new to the whole forum software and am struggling like hell to get the code side of things done.

Do I insert the code into the itrader_user & itrader_userbits, or do I put the code into the postbit / postbit_legacy (not that I know what either of those means).

The instructions (as far as I can see) do not ask for you to search for any code, it simply says put (and then displays the code) into either the postbit or postbit_legacy, then in the members area.

Nathan.

You are not a pest. LOL. I have been working on mine for almost 2 weeks and will probably be much better at this whole hack thing for doing it.

Can you copy and past the couple readme file steps so I can see for myself and then maybe I can interpret it?

I also wish there was a more detailed explanation of the steps.
Kelly

[nate247]

Glad to hear im not a pest....... (Yet) lol.

Here is the cut and paste as requested, hope it helps. Again sorry for the length of message.

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.

[kellyandmike]

Oh I remember that one. The "sorry to skimp" lol...

Can you give me the link to your page so I can look at it? Is iTrader itself up and running?

[nate247]

www.dontfearit.com.

I have iTrader installed but you wont see it anywhere as I am yet to put the code in obviously lol