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]

Originally Posted by masterweb

Nice mod, installed and working. Now i need someone to make me those tumbs on non progressive jpeg format to upload on it (not for free of course )

Just looked at your website You can delete the vb Affiliate Linking System text from the content.txt file - which will give you more room. I would offer to do the images for you, but I've got a lot of custom work on at present.

[masterweb]

Originally Posted by syrus.xl

Just looked at your website You can delete the vb Affiliate Linking System text from the content.txt file - which will give you more room. I would offer to do the images for you, but I've got a lot of custom work on at present.

Np about the images, just a question: I would put the Box of the linking system at the end of the board (on the footer) what i must to do?, changes on templates?; pls help me.-

Thanks in advance

[masterweb]

Done, i found the box code and i moved to the end of the forum...

[SuperTaz]

Very nice. Installed.

[syrus.xl]

UPDATE:
A bug with this modification has been brought to my attention, regarding when used with the vBulletin DHTML dropdown menu system which causes the menu to drop behind the flash file. I'll release a fix for this, and also add a new feature so you add target tags within the XML file, this will allow you to specify if you want the links to open within the same window, new window, etc.

Regards.

[thunder_sti]

I have done everything by the book. When I go to the forums to view.

This is what i get:

Warning!!! To view this please enable JavaScript and Flash!

Where/What i do for this ?

[syrus.xl]

There's a trap code line that will cause that to show for debugging purposes, and doesn't mean this is a client-side error.

Normally, it refers to the flashobject.js isn't uploaded, or the javascript routine call is missing from the vBulletin template headinclude. If this isn't the case then prepend all file calls with absolute urls, sometimes it can be a server configuration issue.

[thunder_sti]

I have corrected the issue.

Now All I have is a blank white box, with the credits on bottom left. No pictures.

PM sent.

[thunder_sti]

bump

[sebil]

if i add this hack,,,
is there any chance of slowing down my site...

please help me,,,
i loved it a lottt