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

[BiReL41r]

I might try this...looks like a good hack.

[dreamer81]

ok it works now, but how do i cloak my urls????

i mean REAL cloaking, i currently have a cool javascript that i created myself, that cloaks the url. even when u right click on the link. Most cloaking software fails on this, but not my script, so how do i implement that?

[dreamer81]

ok huge bug!!

this line will only show the first ad
PAN ad: <ad what="zone:2" /> <ad what="zone:1" />

for some reason, i cannot show two ads on the same line in the template. I have no idea why..... can you fix this?

[Smiry Kin's]

Very Nice System! excatly what im looking for!

[The M.I.P.]

Originally Posted by dreamer81

this line will only show the first ad
PAN ad: <ad what="zone:2" /> <ad what="zone:1" />
for some reason, i cannot show two ads on the same line in the template. I have no idea why..... can you fix this?

Thx for reporting this. It was caused by a buggy regular expression and is fixed in version 1.0.3 of this product. Please see upgrade section in my first post.

Originally Posted by fbastello

Basically, I added the following line just before return "<!-- BEGIN ad {$adcomment} -->{$ad['html']}<!-- END ad {$adid} -->";
in the view_ad function plugin:
$phpAds_context[] = array('!=' => 'bannerid:'.$ad['bannerid']);

This basically will allow you to have several <ad what="zone:1" /> anywhere in your templates and be sure that the same banner is not displayed twice.

I also thought about this before, but didn't implement it, because in my eyes, a zone denotes a location and therefore should be unique on page.
But as it might be useful for some people, I added this to version 1.0.3 introducing a new setting "Banner Dupe Check". However - I don't recommend using the same zone repeatedly on a page.

[fbastello]

Brilliant! Thanks for the update!

[apfparadise]

Great Mod, INSTALLED!!!! Working flawlessly.

[tanyeri24]

I getting this error if I put the <ad ..> tag on header template:
Fatal error: Call to a member function scalarval() on a non-object in /home/security/public_html/includes/lib-xmlrpc.inc.php on line 729

I have remote phpadsnew and copied the 2 files to my forum includes (describted like on your NOTES..)

Thx for helping in advance

[Masiello]

Fantastik Thread and Mod, Thanks!

[Masiello]

I have found a code to set a schedule Tasks to work on vbulletin, but it seems not working really after the time I have set and dont working in general, anyone Have any idea how to set fine in Schedule Tasks of vbulletin?