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

[arindra]

Hi All
i have one more question .
I have the phpadsnew latest version installed but on a DIFFERENT DOMAIN , BUT in the SAME SERVER .

What mode would i be using local mode or by remote invocation ?
thanks in adv

[arindra]

finally got it to work

[jcerious]

I don't want to ad banners I just want to run short lines of text. Does anyone know if you can do that with this?

[jerx]

Yes, you can use text only ads. phpAdsNew is very powerful and can handle all kinds of ads. Here is the website:
http://phpadsnew.com/two/

[arindra]

yes u can , i just tried it with text fiorst , then banner ... as well

[hdraye]

Great Hack Thanx

I am using this on my site:

             <if condition="$foruminfo['forumid']==3 OR $foruminfo['forumid']==6">
  <ad what="fol" />
<else />
  <ad what="zone:3" />
</if>

and it works great, but what if I have 30 forums and eache will have a different key word, can I have the code figure out the forum id variable and use the related keyword (I would set it in PNA as forum id, just the number)? and if yes how please?

TIA

Hani

[floydian1]

I'm an idiot... don't understand how to load this thing.

I click on the download and I'm taken to a webpage that starts like this. What am I looking at here?

<?xml version="1.0" encoding="ISO-8859-1" ?>
- <product productid="mip_phpadsnew" active="1">
<title>phpAdsNew Integration</title>
<description>Integrates phpAdsNew into the template system</description>
<version>1.0.3</version>
<codes />
<templates />
- <plugins>
- <plugin active="1">
<title>view_ad function</title>
<hookname>init_startup</hookname>
- <phpcode>
- <![CDATA[
if (!function_exists('view_ad'))
{

[SuperJETT]

I'm going to throw out my experience and how I have went about setting it up after running into some issues after a server move.

I went from a php5/mysql5 server to a php4/mysql4 box and had several issues. I could get PAN working straight up, but not integrated no matter what combination of compatibility mode settings and other things.

So, I got it back to working by itself, dumped the db, then imported the tables into my vbulletin db, changed the config to reflect the db change, imported the product again, and it works fine just like before.

The only difference is my vb db is a bit bigger, but in the end it's probably simpler than having 2 separate db's to take care of.

One other note for Linux newbies (which I was not long ago): setting the local path to PAN, mine ended up being /abc/def/username/www/phpadsnew with no trailing slash. I have no access to /abc/def/ but it still needs to be included because that's the true path to the folder on the local machine.

[drgonzo120]

will this also work under 3.5.4 ????

thanks

[drgonzo120]

Originally Posted by floydian1

I'm an idiot... don't understand how to load this thing.

I click on the download and I'm taken to a webpage that starts like this. What am I looking at here?

<?xml version="1.0" encoding="ISO-8859-1" ?>
- <product productid="mip_phpadsnew" active="1">
<title>phpAdsNew Integration</title>
<description>Integrates phpAdsNew into the template system</description>
<version>1.0.3</version>
<codes />
<templates />
- <plugins>
- <plugin active="1">
<title>view_ad function</title>
<hookname>init_startup</hookname>
- <phpcode>
- <![CDATA[
if (!function_exists('view_ad'))
{

that's the contents of the xml file, save it as an xml file ... or copy the content and paste it into an empty file which you save as *.xml ...