Mit OmniAds kannst du jede Art von Werbung an jeder beliebigen Stelle in deinem Wordpress Blog platzieren.

For an english description click here.

Übersicht

• Units
  • HTML-Untis
  • PHP-Units
  • FILE-Units
• Channel
• Einbindung
  • in Template
  • Widgets
  • in Beiträgen
• Download

Units

Eine Unit kann mit beliebigem Adcode befüllt werden. Dabei werden die folgenden beiden Unit-Typen unterschieden.

HTML-Units

Können Text, Html und Javascript enthalten.

PHP-Units

Können neben Text, Html und Javascript auch PHP-Code enthalten. Da der PHP-Code im Kontext von Wordpress ausgeführd wird, kann man auf beliebige Daten zugreifen. Dadurch kann man sehr fein einstellen, wann und wie Werbung angezeigt werden soll. Allerdings führt eine Fehlerhafte Unit u.U. zu einem Crash. Deshalb Sorgfalt walten lassen!

Beispiel

Zeige die Unit nur auf einer Suchergebnisseite an.

< ?php if( strpos( $_SERVER[ 'REQUEST_URI' ], '?s=' ) !== false ): ?>
/* ad code here */
< ?php endif; ?>

Zeige die Unit nach jedem zweiten Beitrag an.

< ?php global $omniads_index; if( !isset( $omniads_index ) ) $omniads_index = 0; ?>
< ?php if( ++$omniads_index % 2 == 0 ): ?>
/* ad code here */
< ?php endif; ?>

Nutze die Post-Tags

< ?php
$omniads_tags = get_the_tags();
/* use tags here */
?>

Sämtliche Daten eines Posts wie Tags, Kategorien, Titel sind verfügbar.

FILE-Units

Diese Dateien müssen im Unterverzeichnis < …OmniAds…>/units/ liegen. Eine Datei mit der Endung .php wird auch als solche behandelt und kann bel. PHP-Code enthalten. Jede andere Dateiendung wie .html oder .txt … wird als Text interpretiert und kann Text, Html, Javascrip, Flash etc. enthalten.

Channel

Einem Channel können beliebig viele Units zugeordnet werden. Es wird immer eine Unit per Zufall ausgewählt und angezeigt.

Einbindung

in Templates

Um eine Unit oder einen Channel im Template anzuzeigen musst du an der gewünschten Stelle den folgenden Code einbinden.

Für einen Channel

< ?php if( function_exists( 'omniads_channel' ) ) omniads_channel( 'CHANNEL_NAME' ); ?>

Für eine Unit

< ?php if( function_exists( 'omniads_unit' ) ) omniads_unit( 'UNIT_ID' ); ?>

Eine Unit, die dem Channel more zugeordnet ist, wird auf der Detailseite eines Posts direkt nach dem <!–more–> – Tag eingeparst.

Widgets

Wenn dein Wordpress Theme Widgets unterstützt, dann kannst du jede Unit oder jeden Channel in einem Sidebar Widget platzieren.

in Beiträgen

Du kannst einen Channel oder eine Unit an jeder Stelle in einem Beitrag oder einer Seite anzeigen lassen.

Für einen Channel
<!–omniads:CHANNEL_NAME–>

Für eine Unit
<!–omniads:UNIT_ID–>

Description in english

Overview

• Units
  • HTML-Untis
  • PHP-Units
  • FILE-Units
• Channel
• Integration
  • in Template
  • Widgets
  • in Posts
• Download

Units

A Unit can containt any adcode you like. OmniAds comes with two differend types ob units.

HTML-Units

Can contain only Text, Html and Javascript.

PHP-Units

Can contain Text, Html, Javascript and PHP-Code. The PHP-Code gets executed in the wordpress context. Therefore you can access any kind of information Wordpress knows. Be careful, because poorly coded units can crash the your blog.

Example

Show the unit just on the search result page

< ?php if( strpos( $_SERVER[ 'REQUEST_URI' ], '?s=' ) !== false ): ?>
/* ad code here */
< ?php endif; ?>

Show the unit after every 2nd post.

< ?php global $omniads_index; if( !isset( $omniads_index ) ) $omniads_index = 0; ?>
< ?php if( ++$omniads_index % 2 == 0 ): ?>
/* ad code here */
< ?php endif; ?>

Use the post tags

< ?php
$omniads_tags = get_the_tags();
/* use tags here */

You can access any metadata like posts tags, categories …

FILE-Units
Those files have to be placen in < …OmniAds…>/units/ A file with the extension .php get’s executed a normal PHP-Code. Files with different extension like .html or .txt … will be interpreted a text and can contain text, html, javascrip, flash …

Channel

You can associate as many units as you like with one channel. One unit gets delivered by random.

Integration

in templates

To show a unit or a channel in the template use the following code:

channel

< ?php if( function_exists( 'omniads_channel' ) ) omniads_channel( 'CHANNEL_NAME' ); ?>

unit

< ?php if( function_exists( 'omniads_unit' ) ) omniads_unit( 'UNIT_ID' ); ?>

A unit associated with a channel named more will be parsed in after the <!–more–> – tag on the detail page of you post.

Widgets

If your theme is widget ready, you place a unit or a channel in your sidebar.

in posts

Use the following tags to place a channel or a unit in your post or page.

channel
<!–omniads:CHANNEL_NAME–>

unit
<!–omniads:UNIT_ID–>

Download OmniAds v0.54