vB.Sponsors 2.0.x Installation Guide
Product Requirements
Version 2.0.5 has been tested with vBulletin 3.6x. If you need a version for vBulletin 3.5.x, please see vB.Sponsors version 1.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 the settings-check.php file that is located in the do not upload/vB.Sponsors directory. Upload this to the vB.Sponsors directory on your web site. To run it, simply browse to http://www.EXAMPLE.com/vB.Sponsors/settings-check.php in your browser. 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 product-vB.Sponsors.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.
For forums & categories:
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]">
<if condition="!empty($forum[sponsor_adsense])">
$forum[sponsor_adsense]
<else />
$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>
</if>
</div>
</if>
<!-- / vBSponsors -->
forumhome_forumbit_level2_post
FIND:
<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]">
<if condition="!empty($forum[sponsor_adsense])">
$forum[sponsor_adsense]
<else />
$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>
</if>
</div>
</if>
<!-- / vBSponsors -->
To display the advertisement at the top of the forum/category:
FORUMDISPLAY
FIND:
<if condition="$pagenav"><td align="$stylevar[right]">$pagenav</td></if>
ADD, AFTER:
<!-- vBSponsors -->
<if condition="$foruminfo[sponsor_enabled] == 1 AND $vboptions[sponsor_global_enable_sponsorship] == 1">
<if condition="!empty($foruminfo[sponsor_adsense])">
$foruminfo[sponsor_adsense]
<else />
$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>
</if>
<!-- / vBSponsors -->
For subforums:
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]">
<if condition="!empty($forum[sponsor_adsense])">
$forum[sponsor_adsense]
<else />
$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>
</if>
</div>
</if>
<!-- / vBSponsors -->