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

[shunx91]

Hi Guys,

I tried to install the hack but I'm getting the following messages:

Style Manager

Warning: main() [function.main]: open_basedir restriction in effect. File(/lib-xmlrpc.inc.php) is not within the allowed path(s): (/home/httpd/vhosts/clubwrx.net/httpdocs:/tmp) in /includes/lib-xmlrpc-class.inc.php on line 18

Warning: main(lib-xmlrpc.inc.php) [function.main]: failed to open stream: Operation not permitted in /includes/lib-xmlrpc-class.inc.php on line 18

Warning: main() [function.main]: open_basedir restriction in effect. File(/lib-xmlrpc.inc.php) is not within the allowed path(s): (/home/httpd/vhosts/clubwrx.net/httpdocs:/tmp) in /includes/lib-xmlrpc-class.inc.php on line 18

Warning: main(lib-xmlrpc.inc.php) [function.main]: failed to open stream: Operation not permitted in /includes/lib-xmlrpc-class.inc.php on line 18

Can someone please help? I've had tons of trouble getting phpadsnew to display properly on vBulletin. Any help would be appreciated.

[jw00dy]

Your openbasedir config isn't allowing the location that you have installed openAds to.

So you need to edit httpd.conf and add the location that you installed openads to or move the openads location.

I know nothing of your config, but usually their is an httpd.conf for each user so you can fix it for one account and not all.

Good luck.

[shunx91]

jw00dy,

Thanks for your help. Is the httpd.config a part of phpadsnew or vbulletin/ Also where can I find it and what should I look for inside? Thanks for your help.

[jw00dy]

it's a part of neither. httpd.conf is the configuration file for apache webserver.

The other option is to install openAds in a location that's not restricted (meaning it's already allowed in openbasedir.

I can already tell you need to just remove it and then install it in a normal location like public_html/openads/ or public_html/forums/openads/ or something along those lines.

[shunx91]

Thank you sir!

I was able to forward your feedback to my tech and he was able to help me solve most of the problem. Thanks again!

[jketron]

How do you get openads to display on the left sidebar?

[dholt]

Default banners are displaying good.

I created a user account to added a Banner and it is not showing.

as of now it is displaying the Default banner but what do I do so it rotates the Default and the new banner that I just added?

I added the banner to the header template using the <ad what="foo|bar" />

do I need to change this to make it display both ads

[jjj0923]

what is the advantage of using this plug-in over just inserting the generated javascript by phpads ad I've been doing for the last 4 years?

thanks in advance.

[jw00dy]

The advantage to me is that I don't have to modify my templates to change ads.

I can using openads, change them if I please. If I change my channel, I just update openads with the new code for that zone and I'm set. It really makes it easy.

You can also run more then one type of ad in the same spot, as openads will take care of rotating to a different ad size for you. So you can run full banners, half banners, and leader board banners in the same spot. Just add 3 different banners tied to the same ad space and you're golden.

This adds the code so that setting up your locations is easy using either keywords or zones. I recommend it.

[Fred.]

I upgraded from PhpAdsNew to the lastest Openads
And now a have a problem.

The banner image don't show



When i go to properties
i get this

Look at the URL (that's the problem)



I have tried different things but stil no solution

I hope someone can help me.