Major Additions - vB Affiliate Linking System (Multi-Purpose & Flash-based)

vB Flash Affiliate Linking System (Multi-Purpose)

Important: No longer supported on vbulletin.org - advice and support only available from Digital Port UK
Another creative idea brought to you by Syrus XL Media.
Free and Pro versions available from ? http://www.digitalport.co.uk
LIVE DEMO: http://www.shedevils-ld.com
Released: 15th April 2007
Version: 1.0.0
Documentation: Download packaged with .txt and .pdf formats.
Color Variations: See end of this post for other available colors.

Description
Even though we have called this an ?Affiliate Linking System?, it could serve many other purposes, depending on configuration. Basically, it will rotate any image, along with a title and an active url. You can also rename the modification name (currently the text on the bottom left) by editing the content.txt file.

Some suggested uses of this modification:

• Display forum Administrators and Moderators photos.
• Use as a miniature gallery.
• Use to display your affiliates.
• Display latest store items for sale.

The modification uses no database queries and is totally XML driven, maybe in the future we will change this to a database driven modification.

Usage
Windows users can benefit from using the scroll-wheel to flick through the various links. By double-clicking on any image, the url will be opened in a new window. A single click on any image will bring it to the front.

Adding new links with thumbnails is just a case of creating the thumbnail and editing the XML file. There?s no need to know anything about Flash, everything is controlled externally. If you find that after adding a certain number of links they fail to load, or show - Make sure you are not viewing a cached version in your browser. You should clear your Temporary Internet Files to fix this problem.

vBulletin Installation
Please read this carefully, these instructions will place the modification display on your forum homepage (if you wish to put this on the vBadvanced CMPS please view below). These instructions assume you are using the vBulletin default style.

In all installations upload all the files within the UPLOAD folder to your forum root directory.

Directory structure:

adls_data.xml
adls_content.txt
vbadlsystem.swf
/adls_images
/clientscript/flashobject.js

Note: If you have installed previous modifications by us, you may find that the flashobject.js file is already in your vbulletin installation. This file is used for fixing compatibility issues when embedding flash files, with some browsers.

Template Edits:
AdminCP -> Styles & Templates -> Style Manager -> Default Style -> Edit Templates

In the headinclude template
FIND:

<script type="text/javascript" src="clientscript/vbulletin_global.js?v=$vboptions[simpleversion]"></script>

Above add this:

<script type="text/javascript" src="clientscript/flashobject.js"></script>

In Forum Home Templates > FORUMHOME template
FIND:

$navbar

BELOW ADD:

<div align="center" width="100%" id="link_display">
Warning!!! To view this please enable JavaScript and Flash! 
</div>
<script type="text/javascript">
   var fo = new FlashObject("vbadlsystem.swf", "link_display", "700", "230", "8,0,0,0", "#E9E9F2");
   fo.addParam("quality", "high");
   fo.write("link_display");
</script>
<!-- js flashobject -->

Change the "#E9E9F2" to suit the background color of your forum.

End of Template edits to Display modification on vBulletin homepage.

Configuring the adls_content.txt file
This file only contains the text which you want to display along the bottom of the display. When editing this file do not add spaces before the main variable.

EXAMPLE:
content=Whatever you want goes here

Configuring the adls_data.xml file
This file needs very little explanation, however here?s what 3 variables you can change per image url.

The file contents:

<?xml version="1.0" encoding="utf-8"?>

<photos path="adls_images/">   This path can be changed, just a default we have set for the images.

   <photo name="Digital Port UK" url="image1.jpg" link="http://www.digitalport.co.uk/"></photo>

</photos>

The ?photo name? is the text you would like under the image when displayed.
The ?url? is the path to your image (note the directory is not required).
The ?link? is for your image when double-clicked on.

Creating your thumbnails
Each thumbnails image is 200x150 pixels and a non-progressive jpeg format. The flash file will resize thumbnails when they are the incorrect size, but this may lead to distortion.



vBadvanced Installation
The installation is pretty much the same apart from one template edit. These instructions assume you have installed the CMPS inside your forum ROOT, not outside.

If you have installed the vBadvanced CMPS outside the forum ROOT you will need to prepend the urls of the edits required with the flashobject.js and the vbadlsystem.swf with the full url path.

You will need to upload all files as previously mentioned for the vBulletin installation and also do the headinclude template edit.

On top of this you will need to do the following edit:
In the vBadvanced CMPS Templates -> adv_portal
FIND:

<table align="center" class="page" cellspacing="0" cellpadding="0" width="100%">

BELOW ADD:

<div align="center" width="100%" id="link_display">
Warning!!! To view this please enable JavaScript and Flash! 
</div>
<script type="text/javascript">
   var fo = new FlashObject("vbadlsystem.swf", "link_display", "700", "230", "8,0,0,0", "#E9E9F2");
   fo.addParam("quality", "high");
   fo.write("link_display");
</script>
<!-- js flashobject -->
<br />

Change the "#E9E9F2" to suit the background color of your forum.

End of CMPS Template edits

Enjoy!

[syrus.xl]

Reserved...

[MissKalunji]

woohoo first installed

[Allan]

Very nice, great job

It's possible to create a flash the color to my forum ?

[almightyone]

on the demo you have to click several times on a image before it will actually goto the link maybe it is just me

[syrus.xl]

Originally Posted by Allan

Very nice, great job

It's possible to create a flash the color to my forum ?

Do you mean the background color? That can be changed by altering the HEX value, which I documented.

Originally Posted by MissKalunji

woohoo first installed

Thanks!

[syrus.xl]

Originally Posted by almightyone

on the demo you have to click several times on a image before it will actually goto the link maybe it is just me

It uses a double-click on an image, that is how it is designed. A single-click moves to the selected image. Or if you are using any version of Windows you can use the mouse-scroll wheel.

The flashobject.js file eliminates the need to do multiple-clicking within the Flash movie itself.

Unless, your browser isn't supported, but I've not seen one yet - I didn't try this mod in Opera though.

[Smoothie]

Originally Posted by almightyone

on the demo you have to click several times on a image before it will actually goto the link maybe it is just me

It's there, in the 1st post:

By double-clicking on any image, the url will be opened in a new window. A single click on any image will bring it to the front.

[Shazz]

Creatvie, Unique
5 Star

[Allan]

Originally Posted by syrus.xl

Do you mean the background color? That can be changed by altering the HEX value, which I documented.



Thanks!

Look my profil (style element)