LTG php ads new
24 April 2005
I just finnished coding a new plugin in the 
LTG PHP Ads New extention and wanted to show it here first before I will put it into 
TER with updated documentation. The plugin was written for the website L!VE Travel Guides where I work for on a daily base.
What does it do?
The extension ltg_phpadsnew create an interface in TYPO3 to the well know phpadsnew advertising server. You can maintain and manage your advertisement in phpadsnew and with this little interface you can show these advertisements on your site.
The plugin PI1
The first plugin I made in the extension could basicly only be used on one single page. Or with some handly typoscript you could show it in seperate trees. Well, the handy typoscript turned not out to be that handy when your website is bigger then 3000 pages, that's why I wrote the PI2 plugin.
The plugin PI2
The extra code I have been writing for the last couple of days consist of two parts.
- Add advertisements in the list module under page
- Add the display plugin (witch is also callable from TypoScript)
Adding Advertisements:
You can add advertisements on any page with the following options:
- Force option, you can make a advertisements always show up
- Weight option, the heigher the weight.. the higher it will show above other advertisements
- Depth option, how many levels deep should this advertisement be active
- keywords option, use keywords also found on pages you can specify on what pages it should show up.
Displaying Advertisements:
The plugin will gather and render the advertisements on a page, looking for advertisements on higher, up in the tree pages filter and sort them like you want them to show up. The following options are available:
- Setup an SQL Order By to sort the advertisements. Default set to: forceshow desc, weight desc, crdate asc
- Set a maximum number of advertisements shown on that page (see side note).
- Wrap single advertisements, like .wrap option in TYPO3
- Wrap all advertisements, like allWrap in TYPO3
Rendering rules for advertisements:
The advertisements are rendered in the following order:
- Gather all advertisements shown on the page, they will ALWAYS be shown.
- Gather all forced advertisements in the page tree. They will ALWAYS be shown if the advertisement is within the tree depth AND the keywords match.
- Get all advertsisments on the tree untill the number of advertisements as set in the plugin, they are also filtered by keywords and tree depth.
Keyword matching Rules:
If one of the keywords fields is empty, on the page OR on in the advertisements then there is no filter action. If both are set, the need to intersect before it's get shown.
site note:
The option for the maximum number of advertisements is only used when advertisements loaded higher in the tree and the option is not set to forced. We created a force option so high paying advertisers will always show up, so we don't check the maximum number of advertisers. Also advertisers that want to show an advertisements just on a single page is shown, otherwise there is a change that they pay for an advertisement but it will never shown up.
Download and test
You can ofcourse download and test the extension. it has been developed in a 0.4.0 version of TYPO3 and I did a quick test for backward compatibility which succeeded.
Let me know if it worked for you, have any requests on it etc. I will tune up the documentation and put it on TER
Cheers,
R. van Twisk
ries(at)vantwisk.nlcallto://r.vantwisk.nl