phpAdsNew Banner Ads integration (advertisements, classified ads, Adsense, etc.)

OpenAds / phpAdsNew Integration 1.0.4 for vBulletin 3.[56].x
2006-06-08 by mip

Integrates the OpenAds / phpAdsNew ads system by introducing a new template tag <ad ... />.
You can even deliver your Adsense stuff via phpAdsNew using HTML banners.

The features of phpAdsNew combined with the power of vBulletin's templating system gives you the possibility to place ads for specific user groups, forums, and keywords.

PREREQUISITES:
This plugin requires a working installation (local or remote) of a recent version ofOpenAds / phpAdsNew (free software released under the GPL).
When using OpenAds, replace phpAdsNew in this documentation with OpenAds (phpAdsNew is just the predecessor of OpenAds).

INSTALLATION:
When having a previous version of this product installed, see section UPGRADE instead.

Install product "phpadsnew-1.0.4.xml".
Set phpAdsNew path in Server Settings and Optimization Options to point to either your local phpAdsNew installation or a remote server (using XML-RPC).
It is strongly recommended to set $phpAds_config['compatibility_mode'] = true; in phpAdsNew config file, to prevent problems when phpAdsNew uses a database different from the one used by your vBulletin board.

When using XML-RPC, make sure to have lib-xmlrpc-class.inc.php and lib-xmlrpc.inc.php copied from phpAdsNew misc/samples/xmlrpc/php/ to your forum's includes/ directory (not necessary when using a local phpAdsNew installation).

Read the NOTES section below.

Click INSTALL in this thread to mark product as "installed" and receive notifications when a new version comes out.

UPGRADE:

• 1.0.3 --> 1.0.4
  1. Import product as usual, with "Allow Overwrite" set to Yes.
• 1.0.2 --> 1.0.3
  Upgrading is recommended, as this is a bugfix release.
  
  1. Import product as usual, with "Allow Overwrite" set to Yes.
     
  2. Recompile any templates where you experienced problems with the <ad .../> tag (notably those where this tag is used repeatedly on a line).
     
• 1.0.1 --> 1.0.2
  
  1. Import product as usual, with "Allow Overwrite" set to Yes.
     
  2. Set $phpAds_config['compatibility_mode'] = true; in phpAdsNew config file.
     
• 1.0 --> 1.0.1
  There's basically no need to upgrade, as the changes don't affect a working installation, but I recommend to do so, to ease possible upgrades in the future.
  1. Import product as usual, with "Allow Overwrite" set to Yes.
  2. Alter the path to phpAdsNew in vBulletin Server Settings and Optimization Options to point to your phpAdsNew installation.
     As opposed to version 1.0 of this product, a local path is not relative to the DOCUMENT_ROOT.

USAGE:
Use the newly introduced <ad ... /> tag in your templates.
The syntax is similar to phpAdsNew's view_raw() function call - the tag understands what, clientid, target, source, and withtext as arguments.

Please make yourself familiar with phpAdsNew prior to using this product. You can't expect this product to work, if you didn't check if your phpAdsNew is delivering your banners cleanly.

Examples:

• Get banner using keywords:
  <ad what="foo|bar" />
• Get banner for guest usergroup (in this case, "ug1" must be set as a keyword in phpADsNew, see 2nd screenshot):
  <ad what="ug$bbuserinfo['usergroupid']" />
  (same technique can be applied to deliver forum-specific ads)
• Similar invocation using template conditionals:
  <if condition="$bbuserinfo['usergroupid']==1"><ad what="" /></if>

NOTES:

1. Always use the latest stable version of phpAdsNew.
   Old versions had bugs and some even had severe security issues - I'll give no support for installations with an outdated phpAdsNew.
   At the time of writing, latest version is 2.0.8.
2. Templates which make use of the ad-tag might need to get recompiled after product change.
3. Recommendations for heavy-duty servers: Move the plugin code to files; try to avoid using xml-rpc or cache xml-rpc requests (e.g. with memcache).
4. Have an eye on current phpAdsNew security issues
5. This product comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.
6. Support is provided at will.
   Don't expect help if you haven't read instructions or phpAdsNew manual, if you're using non-standard vBulletin software or if your problem descriptions are useless.

PS:
This plugin is donationware - it helps you to make some money, so please be fair and honor my work with an adequate pecuniary donation.
Donate via Paypal

[bada_bing]

Hey guys,

Im really having a tough time trying to get the ads to display on my site.. Can someone help me with this. Can you post the simple code to just display an ad from
a specific zone2? And If I want to have the add show up on top of my forums (Header) where do I put this code.

Thanks

[markbolyard]

<ad what="zone:1" />
<ad what="zone:2" />
<ad what="zone:3" />

and so on. So if you want to have zone 2 in your header, place the second example in tha are you want zone 2 ads to display.

[mattyk72]

hmmm, I can get it to work with java but not with the <ad...> code

[bada_bing]

Originally Posted by markbolyard

<ad what="zone:1" />
<ad what="zone:2" />
<ad what="zone:3" />

and so on. So if you want to have zone 2 in your header, place the second example in tha are you want zone 2 ads to display.

Another question... Where in the header template do I place this?

[markbolyard]

Depends on where you want it. Why not post the link to your forum, then and I'll look at the code. Explain where you want it to show.

[bada_bing]

Link to my site is www.seekingadultfriends.com/forums

[bada_bing]

Originally Posted by markbolyard

Depends on where you want it. Why not post the link to your forum, then and I'll look at the code. Explain where you want it to show.

Did you take a look?

[D.Ilyin]

Conditions:
vB + phpAdsNew 2.0.8 + phpAdsNew Integration 1.0.4 for vBulletin 3.5.x
Path for phpAdsNew in vBulletin panel (here - ./admincp/options.php?do=options&dogroup=server) - correct.
Optinons of phpAdsNew 2.0.8:
Added another one HTML banner with same following code:

PHP Code:

<?php
include("http://notmyhost.com/link/banner1.htm");?>
<?php
include("http://notmyhost.com/link/banner2.htm");?>

When brouse phpAdsNew adminpanel banners shows fine!
Option "Allow PHP expressions to be executed from within a HTML banner" - enabled.
This option $phpAds_config['compatibility_mode'] set to true in phpAdsNew config file.
In FOUMHOME template was added (keyword the same sa for added in phpAdsNew)

<ad what="banner" />

Question: Why when i view admin panel of phpAdsNew i see bener as well, but when i view forum in sourse code of page i see only

<!-- BEGIN ad 126277454 --><!-- END ad 126277454 -->

this?

I read thread two times. The same problems was report but answers are..... apsent.

PS Another banners are works fine, but this .....

[D.Ilyin]

Does anybody use externals text banners?
When i set in Banner properties - Target - this url http://notmyhost.com/link/banner2.htm, the story with empty banner code repeated .
Someone help me please.....

[jaybolt]

First off, this is probably the most useful vB hack I have installed. It helps me run my ad campaigns efficiently and with the minimum of fuss. This is how I have set up the hack:

1. In your global.php file for vBulletin, search for:

// templates to be included in every single page...
$globaltemplates = array_merge($globaltemplates, array(
	// the really important ones

In the list add:

// ADSERVER TEMPLATE ADDITION
       'adserver',

2. Create a new template called 'adserver' in your VB styles and templates area. This is the code I use:

<div style="position: absolute; top: 10px; right: 80px; padding: 1px; border: 2px #C0C0C0 solid;">

<if condition="$foruminfo['forumid']==24"><ad what="zone:3" /><else />
<if condition="$foruminfo['forumid']==105"><ad what="zone:3" /><else />
<if condition="$foruminfo['forumid']==106"><ad what="zone:3" /><else />
<if condition="$foruminfo['forumid']==11"><ad what="zone:4" /><else />
<if condition="$foruminfo['forumid']==18"><ad what="zone:5" /><else />
<if condition="$foruminfo['forumid']==14"><ad what="zone:7" /><else />
<if condition="$foruminfo['forumid']==16"><ad what="zone:8" /><else />
<if condition="$foruminfo['forumid']==69"><ad what="zone:9" /><else />

<ad what="zone:6" />
</if>
</if>
</if>
</if>
</if>
</if>
</if>
</if>
</div>

What is basically does is some CSS positioning to put the ad at the top right of the screen and then it assigns different forum ids to different ad zones within phpadsnew.

Finally, in your NAVBAR template in vb, add the following to the top of your template:

$adserver

And thats it - that should position your banner at the top right of your forum pages and should display the correct banner relating to your phpadsnew zone set up. It defaults in my case to showing 'zone:6' ads if no other forum is selected.

I hope this helps someone - made it very easy for me when I update my vbulletin versions.