Major Additions - vB Ad Management 4

vB Ad Management 4

Check the FAQ before requesting support!

What does it do?

Features include global settings, advertisements allowing template conditionals, ad sharing and ad revenue sharing, timed advertisements, preset popular ad locations and functions such as sponsors, additional custom ad locations, random and static advertisements and its all very easy to use. You can use it for ordinary ads like adsense, banner rotations, or any content at all as well as using it to manage ads outside your forum too.

You can read in more detail about these and other features in the manual, which also contains some helpful notes and instructions, as well as the installation and upgrade instructions



If you are using autoinsertion and were using vB Ad Management before version 4.00, you will need to remove your old template edits or advertisements will appear multiple times. Just reverse the old instructions below.

* Find <!-- post $post[postid] popup menu --> and paste $postbit_advertisement above it in your postbit & postbit_legacy templates.
* Paste $forumbit_advertisement at the bottom of your forumhome_forumbit_level1_post and forumhome_forumbit_level2_post templates.
* Paste $threadbit_advertisement at the bottom of your threadbit template.
* Paste $footer_advertisement at the top of your footer template.
* Find $spacer_close in your footer template and below it paste $rightcolumn_advertisement.
* Find &nbsp; in your header template and replace it with $header_advertisement.
* Find $spacer_open in your header template and below it paste $leftcolumn_advertisement.

[RedTyger]

How to add your own custom adcode blocks in 3 minutes

Download the zip file and open the named php files using a plain text editor (something like MSWord which uses formatting will break the code). Follow the simple instructions below then save, upload and overwrite your existing files. Your new custom adcode block will be at the bottom of the header/footer section of your vB Ad Management settings.

You can add as many custom blocks as you like as long as you give each one a different name. They'll work on any page, obey all permissions and work with all features including Ad-Sharing.

To name a custom adcode block, just find/replace every instance of the word "custom" in the code below with the new name of your choice.


IN FILE vb_ad_management_310.xml, FIND:

PHP Code:

<template name="footer_advertisement" templatetype="template"><![CDATA[
        <div align="center">
            $footer_adcode
        </div>
]]></template> 


ADD BELOW:

PHP Code:

<template name="custom_advertisement" templatetype="template"><![CDATA[
        <div>
            $custom_adcode
        </div>
]]></template> 


IN FILE includes/vb_ad_management/cache_templates.php, FIND:

PHP Code:

if ($vbulletin->options['adintegrate_footer_onoff'])
{
    $adtemplates[] = 'footer_advertisement';
} 


ADD ABOVE:

PHP Code:


if ($vbulletin->options['adintegrate_custom_onoff'])
{
    $adtemplates[] = 'custom_advertisement';
} 


IN FILE includes/vb_ad_management/global_start.php,FIND:

PHP Code:

if ($vbulletin->options['adintegrate_footer_onoff']) 


ADD ABOVE:

PHP Code:

if ($vbulletin->options['adintegrate_custom_onoff'])
{    
    if ($vbulletin->options['adintegrate_custom_adcode'])
    {
        $custom_split = explode("$adshared", $vbulletin->options['adintegrate_custom_adcode']);
        $custom_adcode = $custom_split[0];
        if ($custom_split[1])
        {
            $custom_adcode = $custom_split[0] . $GLOBALS['adcode_shared'] . $custom_split[1];
        }
        eval('$custom_advertisement = "' . fetch_template('' . custom_advertisement . '') . '";');
    }
    else if ($vbulletin->options['adintegrate_custom_adcode_rand'])
    {
        $custom_adcode = explode("$addelimiter", $vbulletin->options['adintegrate_custom_adcode_rand']);
        $custom_rand = array_rand($custom_adcode);
        $custom_adcode = $custom_adcode["$custom_rand"];
        $custom_split = explode("$adshared", $custom_adcode);
        $custom_adcode = $custom_split[0];
        if ($custom_split[1])
        {
            $custom_adcode = $custom_split[0] . $GLOBALS['adcode_shared'] . $custom_split[1];
        }
        eval('$custom_advertisement = "' . fetch_template('' . custom_advertisement . '') . '";');
    }    
} 


IN FILE includes/vb_ad_management/global_start.php,FIND:

PHP Code:

<setting varname="adintegrate_footer_adcode_rand" displayorder="45">
    <datatype>free</datatype>
    <optioncode>textarea</optioncode>
</setting> 


ADD BELOW:

PHP Code:

<setting varname="adintegrate_custom_onoff" displayorder="991">
    <datatype>boolean</datatype>
    <optioncode>yesno</optioncode>
    <defaultvalue>0</defaultvalue>
</setting>
<setting varname="adintegrate_custom_adcode" displayorder="992">
    <datatype>free</datatype>
    <optioncode>textarea</optioncode>
</setting>
<setting varname="adintegrate_custom_adcode_rand" displayorder="993">
    <datatype>free</datatype>
    <optioncode>textarea</optioncode>
</setting> 


[DementedMindz]

how do we update? any instructions on that?

[RedTyger]

It was in the update, titled "Instructions"

INSTRUCTIONS:
As this is no longer purely plugin-based to speed things up, there are now files to upload. It's very easy, just find your forum's includes directory and load the vb_ad_management folder to there. Do NOT include the includes folder in the zip file, that is just included to demonstrate where it goes on your server. The file's final location should be forum index/includes/vb_ad_management/vb ad management files/. Then upload the plugin, overwriting the one you already have installed.

[DementedMindz]

opps now I see it. Thank you again.

[DementedMindz]

im getting uncached templates postbit_advertisement which is the only one I use for now so I cant tell if the others are showing not cached.

[RedTyger]

Did you upload all the vb_ad_management files?

[DementedMindz]

yes I did im using vBMicroStats and right at the bottom it shows that template as uncached.

[RedTyger]

If it's installed correctly there should be no problem, I'm using vBulletin's built-in function that displays uncached templates and there are none. I suppose it's possible that modification runs before the templates for this modification are cached? I don't know.

Add this line to your includes/config.php file along with the rest of the settings then save the file and overwrite the existing config.php file on your setting.

$config['Misc']['debug'] = true;

Does the default vBulletin information say that templates are uncached? It lists templates in the footer.

[DementedMindz]

strange it dont say it there but it does on his... Do you have the older version of this until he or you can fix it?

[RedTyger]

Well as far as I can see, the problem is with his modification not mine. So there's no reason to use an older version.