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

[Olney]

Does this work with Max Media Manager the same???

[Sinister21]

Is there a way to install this on VB 3.0.6? if not, is there something similar I can use to integrate Phpadsnew to 3.0.6?

I've installed this hack..
https://vborg.vbsupport.ru/showthrea...ight=phpadnews

but it will not utilize the invocation codes from phpadsnew.

I need to have forum specific ads served accordingly.

Anyhelp is appreciated!

thanks guys!

[markbolyard]

Any idea how to show two zones (not at the same time, but alternating / allowing each) to show up in one spot?

IE: <ad what="zone:5", "zone:6" />

I have a spot that I want to show 120 width and 160 width banners in, and each of those are different zones, so I want to make one tag, that will show ads from both zones. Thanks.

[yayvb]

This message doesn't really belong in here, but I think I may have the best luck posting it in here. I tried to setup this hack to allow for phpadsnew to run ads on my site, but I couldn't get anything to display where I stuck the variables.

To make a long story short I have just been using the javascript code that phpadsnew has me use. The ads have been working wonderfully for more than a month now. Perhaps one of the recent changes that I made to the site that I forgot about did something to each page because now when I go to my site the ads appear to work for about 1 or 2 page views and then they completely disappear. If I view source I feel like the code is still there but the ads are no longer there, and internet explorer has the little yellow yield sign at the bottom left telling me that there is an error on line 3 char 1.



Does anyone know why this would happen or what would cause this? If I go into phpadsnew it seems to function perfectly and if I don't go to my site for a while and then go I see the ads for just one or two rotations, but then if I refresh or even go to another page or anything the ads no longer show.

Please see for yourself www.420boards.com

Thanks

Chris

*EDIT: I found that if you go to www.420boards.com with no file specified such as index.php, you can see the ad working fine, even if you refresh 10 times or more you'll be fine. The moment you go to a page that has a filename or even www.420boards.com/index.php, then the banners stop working automatically. I've even gone as far as to delete my .htaccess file in hopes of correcting the problem, but nothing. I can't find any recent changes that I've made or anything like that that would cause this to happen.

[tgmorris]

Originally Posted by markbolyard

Any idea how to show two zones (not at the same time, but alternating / allowing each) to show up in one spot?

When I wanted to select from 2 different zones I wound up using a template conditional. You could do the same and just randomize or alternate them using some external variable. Just a thought.

[Rukas]

Ive installed this and it seems to have broken member.php, i get the following error:


Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in /member.php(654) : eval()'d code on line 197

http://www.streethop.com/forum/member.php?u=3

[SuperJETT]

I have PAN working fine www.x-h2o.com/ad.php and imported the .xml and have the path set correctly (to best of my knowledge) but when I try to add the code for an ad to my header I get a database error where it's trying to change a template table in my PAN database, which doesn't exist.

Database error in vBulletin 3.5.3:

Invalid SQL:

			### REPLACE TEMPLATE: header ###
			REPLACE INTO vbtemplate
				(styleid, title, template, template_un, templatetype, dateline, username, version)
			VALUES
				(2, 'header', '<!-- logo -->\r\n<a name=\\\"top\\\"></a>\r\n<table border=\\\"0\\\" width=\\\"$stylevar[outertablewidth]\\\" cellpadding=\\\"0\\\" cellspacing=\\\"0\\\" align=\\\"center\\\">\r\n<tr>\r\n	<td align=\\\"$stylevar[left]\\\"><a href=\\\"\" . $GLOBALS[\'vbulletin\']->options[\'forumhome\'] . \".php\" . $GLOBALS[\'vbulletin\']->session->vars[\'sessionurl_q\'] . \"\\\"><img src=\\\"$stylevar[titleimage]\\\" border=\\\"0\\\" alt=\\\"\" . $GLOBALS[\'vbulletin\']->options[\'bbtitle\'] . \"\\\" /></a></td>\r\n	<td align=\\\"$stylevar[right]\\\">\r\n		\" . view_ad(\"zone:1\", \"0\", \"\", \"\", \"0\") . \"&nbsp;\r\n	</td>\r\n</tr>\r\n</table>\r\n<!-- /logo -->\r\n\r\n<!-- content table -->\r\n$spacer_open\r\n\r\n$_phpinclude_output', '<!-- logo -->\r\n<a name=\"top\"></a>\r\n<table border=\"0\" width=\"$stylevar[outertablewidth]\" cellpadding=\"0\" cellspacing=\"0\" align=\"center\">\r\n<tr>\r\n	<td align=\"$stylevar[left]\"><a href=\"$vboptions[forumhome].php$session[sessionurl_q]\"><img src=\"$stylevar[titleimage]\" border=\"0\" alt=\"$vboptions[bbtitle]\" /></a></td>\r\n	<td align=\"$stylevar[right]\">\r\n		<ad what=\"zone:1\" />&nbsp;\r\n	</td>\r\n</tr>\r\n</table>\r\n<!-- /logo -->\r\n\r\n<!-- content table -->\r\n$spacer_open\r\n\r\n$_phpinclude_output', 'template', 1137989173, 'SuperJETT', '3.5.3');

MySQL Error  : Table 'myusername_xads.vbtemplate' doesn't exist
Error Number : 1146
Date         : Sunday, January 22nd 2006 @ 10:06:13 PM

If I try to change the header in a different way, it works fine, but when trying to add <ad what=\"zone:1\" /> that's what happens.

Does this indicate I don't have my path to PAN set correctly?

[tgmorris]

Originally Posted by SuperJETT

Does this indicate I don't have my path to PAN set correctly?

It's more likely that you don't have compatibility mode set in PAN. I ran into the same problem as I have PAN in a separate db from my vb install and once I set compatibility mode things started working.

[SuperJETT]

Originally Posted by tgmorris

It's more likely that you don't have compatibility mode set in PAN. I ran into the same problem as I have PAN in a separate db from my vb install and once I set compatibility mode things started working.

Where do I send your carrot? Thanks!!! That was it. I assumed the database settings were fine for PAN since it was working and was looking elsewhere.

(I guess in compatibility mode it opens/closes the db connection a little cleaner?)

[Omranic]

can any one explain the used & working tags .. plz

I used to use all possible tags called in the first post here & all not worked wxwpt only the tag <ad /> as I writed it empty with no atribute

plz explain all possible tags knowing that there is many users need to use it but has no experience with phpadsnew