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

[HobbiesPR]

The www.phpadsnew.com site is not working for me.

[pcxmedia]

any idea why this wont work in 3.6.4?

it just won't save the template when i drop the code into it.

[jw00dy]

That's certainly not this mod's problem. sounds like you have other problems.

The way this mod works, it is almost completely autonomous from the version you are running. I think this would mod would more then likely run on any version.

[diretur]

First of all thank you for this hack.

I have a banner on the navbar and I want it to be different in different forums. I put this code in the navbar template:

PHP Code:

<if condition="in_array($forumid, array(104))"><ad what="zone:43"/>
<else /><ad what="zone:37" /> 


In this way I'll have zone:43 in forum 104, and zone:37 anywhere else.
Now I want, for example, to put zone:44 in forum 105 and zone:43 in forum 104 and zone:37 anywhere else. But if I put his code in the template:

PHP Code:

<if condition="in_array($forumid, array(104))"><ad what="zone:43"/>
<else /><ad what="zone:37" />
<if condition="in_array($forumid, array(105))"><ad what="zone:44"/>
<else /><ad what="zone:37" /> 


I will have two banners in the other forums (two zone:37 are showing up).
Can somebody please tell me how to solve this problem?

[diretur]

solved:

PHP Code:

<if condition="in_array($forumid, array(104))"><ad what="zone:43"/>
<else />
<if condition="in_array($forumid, array(28))"><ad what="zone:45"/>
<else /><ad what="zone:37" />
</if>
</if> 


[GetGamer.com]

I cannot get this working. It used to work, but when I switched to a new server, it stopped working with the codes in vBulletin. phpAdsNew still works fine, but I'd like to use the <ad what="___" /> codes.

I'm running phpAdsNew 2.0.9-pr1, vBulletin 3.6.4 with vBSEO 3.0.0 RC6, version 1.0.4 of this plugin, PHP 4.3.9 and MySQL 4.1.20

The zone tags are getting inserted properly, for example:

<td width="50%" align="right">
<ad what="zone:26" />
</td>
</tr>
<tr><td colspan="2" align="center"><a href="http://www.bigblueball.com/forums/register.php">Join today</a> and you won't have to look at these ads any more. <a href="http://www.bigblueball.com/forums/website-news/34758-become-bigblueball-member-its-easy-free.html">Learn more.</a></td></tr>
</table>

<!-- END TEMPLATE: navbar -->

I'm using local mode, and I've tried both relative and full paths.

It's frustrating because it used to work perfectly until I moved to a new server. Any clues?
You can see it in (in)action here: http://www.bigblueball.com/forums/ms...st-stored.html
There should be a PAN-served graphic advert to the right of the Google Adsense medium rectangle.

[mrahul]

does this work for 3.6.x ?? if not any proposals for the release to 3.6.x ??

[GetGamer.com]

Originally Posted by mrahul

does this work for 3.6.x ?? if not any proposals for the release to 3.6.x ??

Several people have reported that this works fine in 3.6.4, and in fact, it did for me, too -- until I moved to a new server. I'm still trying to sort out why it's not working. No errors, but no ads, either.

[criscokid]

It is recommended to set $phpAds_config['compatibility_mode'] = true; in phpAdsNew config file.

I need to change the setting to try get this this plugin to work - if it's set as 'false' then the forum stops with a mySQL error when I edit the templates.

I've already got PAN running ok without this plugin. The moment change the setting in the config file all of the banner ads stop displaying. What could be the cause of this?

[want2lrnvb]

Nothing is working for me on 3.6.4. I have PAN hosted on another server and want to access it from the forum.

I have the invocation code in the header portion of my style template and have tried the php and javascript versions.

No image is showing but it does seem to show movement from the other server as it is contacting the other location.

First question- how can I verify that my PAN is working right? Do I need to create a .php file and if so what code goes there to test it- the invocation code?

Second- Will this work on this version?

Thanks in advance!