vB.Sponsors 1.0 Installation Guide
Product Requirements
Version 1.x has been tested with vBulletin 3.5x. If you need a version for vBulletin 3.6.x, please see vB.Sponsors version 2.x.
Product Installation
- Extract the contents of vB.Sponsors.zip to your computer
- Open upload/vB.Sponsors/link.php in notepad, wordpad or similar editor.
- On line 30, enter the path to your forum. This is the physical path not the URL. If your forum is located in /usr/com/userid/forums/, the path would be /usr/com/userid/forums/.
You can find the physical path to your forum directory by uploading and running the settings-check.php file that is in the 'do not upload/vB.Sponsors' directory. Upload this to the vB.Sponsors directory on your web server. Please delete this file when you are done. - Upload the files in the upload directory to the corresponding directory on the web server under the forum directory.
- Open the Admin CP of your board. On the left hand side scroll down to Plugins & Products.
- Click on Manage Products.
- Click on Add/Import Product.
- Click on Browse... and choose the vB.Sponsors-product.xml file.
- Click Import.
Template Installation
You will need to modify the templates of your style(s). Sample template code is included with the download. This is for the default vBulletin style only. I highly recommend that you create a test style to apply template changes before you commit them to your regular styles.
forumhome_forumbit_level1_nopost
FIND:
<if condition="$show['subforums']"><div class="smallfont"><strong>$vbphrase[subforums]</strong>: $forum[subforums]</div></if>
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$forum[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
<div style="float:$stylevar[right]">
$vboptions[sponsor_global_default_text] <a href="vB.Sponsors/link.php?f=$forum[forumid]" title="$forum[sponsor_name]" target="_blank">
<if condition="$forum[sponsor_banner_enabled] == 1 AND $vboptions[sponsor_global_enable_banners] == 1">
<img src="$forum[sponsor_banner]" alt="$forum[sponsor_name]" border="0" />
<else />
$forum[sponsor_name]
</if></a>
</div>
</if>
<!-- / vBSponsors -->
forumhome_forumbit_level2_post
FIND:
<div>
<a href="forumdisplay.php?$session[sessionurl]f=$forum[forumid]"><strong>$forum[title]</strong></a>
<if condition="$show['browsers']"><span class="smallfont">(<phrase 1="$forum[browsers]">$vbphrase[x_viewing]</phrase>)</span></if>
</div>
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$forum[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
<div style="float:$stylevar[right]">
$vboptions[sponsor_global_default_text] <a href="vB.Sponsors/link.php?f=$forum[forumid]" title="$forum[sponsor_name]" target="_blank">
<if condition="$forum[sponsor_banner_enabled] == 1 AND $vboptions[sponsor_global_enable_banners] == 1">
<img src="$forum[sponsor_banner]" alt="$forum[sponsor_name]" border="0" />
<else />
$forum[sponsor_name]
</if>
</a>
</div>
</if>
<!-- / vBSponsors -->
FORUMDISPLAY - Displays the large banner at the top of the thread
FIND:
<!-- controls above thread list -->
<table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom:3px">
<tr valign="bottom">
<td class="smallfont"><if condition="$show['newthreadlink']"><a href="newthread.php?$session[sessionurl]do=newthread&f=$foruminfo[forumid]" rel="nofollow"><img src="$stylevar[imgdir_button]/newthread.gif" alt="$vbphrase[post_new_thread]" border="0" /></a><else /> </if></td>
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$foruminfo[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
<td>
$vboptions[sponsor_global_default_text] <a href="vB.Sponsors/link.php?f=$foruminfo[forumid]" title="$foruminfo[sponsor_name]" target="_blank">
<if condition="$foruminfo[sponsor_banner_enabled] == 1 AND $vboptions[sponsor_global_enable_banners] == 1">
<if condition="!empty($foruminfo[sponsor_banner_big])">
<if condition="$vboptions[sponsor_global_enable_big_banners] == 1">
<img src="$foruminfo[sponsor_banner_big]" alt="$foruminfo[sponsor_name]" border="0" />
<else />
<img src="$foruminfo[sponsor_banner]" alt="$foruminfo[sponsor_name]" border="0" />
</if>
<else />
$foruminfo[sponsor_name]
</if>
</if></a></td>
</if>
<!-- / vBSponsors -->
forumhome_forumbit_level1_post
FIND:
<if condition="$show['subforums']"><div class="smallfont" style="margin-top:$stylevar[cellpadding]px"><strong>$vbphrase[subforums]</strong>: $forum[subforums]</div></if>
</td>
</tr>
</table>
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$forum[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
<div style="float:$stylevar[right]">
$vboptions[sponsor_global_default_text] <a href="vB.Sponsors/link.php?f=$forum[forumid]" title="$forum[sponsor_name]" target="_blank">
<if condition="$forum[sponsor_banner_enabled] == 1 AND $vboptions[sponsor_global_enable_banners] == 1">
<img src="$forum[sponsor_banner]" alt="$forum[sponsor_name]" border="0" />
<else />
$forum[sponsor_name]
</if>
</a>
</div>
</if>
<!-- / vBSponsors -->
SHOWTHREAD - Displays the large banner at the top of the thread
FIND:
<body onload="$onload">
$header
$navbar
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$foruminfo[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
$vboptions[sponsor_global_default_text] <a href="vB.Sponsors/link.php?f=$foruminfo[forumid]" title="$foruminfo[sponsor_name]" target="_blank">
<if condition="$foruminfo[sponsor_banner_enabled] == 1 AND $vboptions[sponsor_global_enable_banners] == 1">
<if condition="!empty($foruminfo[sponsor_banner_big])">
<if condition="$vboptions[sponsor_global_enable_big_banners] == 1">
<img src="$foruminfo[sponsor_banner_big]" alt="$foruminfo[sponsor_name]" border="0" />
<else />
<img src="$foruminfo[sponsor_banner]" alt="$foruminfo[sponsor_name]" border="0" />
</if>
<else />
$foruminfo[sponsor_name]
</if>
</if></a>
</if>
<!-- / vBSponsors -->