Adverts TWiki Plugin

This plugin provides a convenient interface to http://phpadsnew.com

Syntax Rules

Adverts are picked by selection strings, as per the phpAdsNew user manual.

It implements a %ADVERT and a %ADVERTRIJS - these both map to PhpAdsNew Remote Invocation JavaScript system. The other invocation methods are not supported.

See Adverts Plugin Test - this has an example invocation and some diagnostics

Selection rules

Inside the {} go the selection criteria.

Here is an extract (from page 73) of that manual, containing some of handy examples:

Below you will find examples of how the selection string could be configured. The examples include different statements, logical operators and multiple expressions.

1. key1|main
   • Match a banner with keyword key1. If there are no banners with this keyword try to match a banner with keyword main.
2. key1,key2|campaignid:3
   • Match a banner with keyword key1 or key2. If there are no banners with this keyword try to match a banner with client id 3.
3. key1,-campaignid:2 Match a banner with keyword key1, don’t match banners with client id 2.
4. |campaignid:2,clientid:4|key1|global Match a banner with id 4. If there are no matching banners try to match a banner with client id 2 or 4. If there are no matching banners try to match a banner with keyword key1. If there are no matching banners try to match a banner with keyword global.
5. html,+key1,+key2,-campaignid:2 Match a html banner with keyword key1 and key2, but don’t match banners from client with id 2.
6. 3,+468x60,4,+468x60,5,+468x60 Match a banner with a width of 468 and a height of 60. The banner id must be 3, 4 or 5.
7. key1/key2/key3 Match a banner with keyword key1, key2 and key3. If no matching banners are available try to match a banner with keyword key1 and key2. If there are

still no matching banners available try to match a banner with keyword key1.

1. key1/key2/key3@468x60 Match a banner with keyword key1, key2 and key3. If no matching banners are available try to match a banner with keyword key1 and key2. If there are still not matching banners available try to match a banner with keyword key1. The banner must not have a width of 468 and a height of 60.

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %ADVERTSPLUGIN_SHORTDESCRIPTION%

• One line description, is shown in the Text Formatting Rules topic:

• • Set SHORTDESCRIPTION = This plugin provides a convenient interface to the functionality in PhpAdsNew

• The root address of the the ads software.
• If the i.e. admin interface is at http://server.../phpAdsNew/admin/index.php then ADVERTSCRIPTBASE is //server.../phpAdsNew (no trailing /)

# * Set ADVERTSCRIPTBASE = http://adverts.yourserver.com

• • Rather than set this here you probably want to set this as ADVERTSPLUGIN_ADVERTSCRIPTBASE in SitePreferences

• Anyone who can change this can change what ads you show!
  • Set ALLOWTOPICCHANGE = AdminGroup

Plugin Installation Instructions

1. Install Php Ads New?
2. unzip the plugin
3. Point ADVERTSCRIPTBASE to your adserver
4. Use Ad Sponsor