Banner Settings

Note: This article is for an old version of OpenX.

The latest OpenX documentation can be found at the following URLs:

This section allows you to configure all options which are
related to banners, such as default banners, allowed banner types and storage
settings.

Default image URL and Default destination URL

If Openads can't connect to the database
server, or can't find any matching banners at all, for example if the database
crashes or was deleted, nothing is displayed. You might want to specify a
default banner which will be displayed in these situations, in preference to
having no banner at all. The default banner specified here will not be logged
and won't be used if there are still active banners left in the database. Be
aware that this default banner should only be used as a fail-safe, not as a
regular banner. This is turned off by default.

Allow local banners (SQL), Allow local
banners (Webserver), Allow external banners and Allow HTML banners, Allow Text
ads

Openads can use different types of banners
and store them in different ways. The first two options are used for local
storage of banners. You can use the admin interface to upload a banner and
Openads will store the banner in the SQL database or on a web server. You can
also use a banner stored on a different external web server or use HTML to
generate a banner. You can disable any one of these types by altering these
settings. By default all banner types are turned on.

If you disable a certain banner type while
there are still banners available of the this type, Openads will allow the use
of these banners, but will not allow the creation of new banners of this
type.

Storing method

If you want to use local banners which are
stored on the web server, you need to configure this setting. If you want to
store the banners in a local directory set this option to Local directory. If
you want to store the banner on an external FTP server set this option to
External FTP server. On certain web servers you may want to use the FTP option
even on the local web server.

Public URL

If you store banners on a web server,
Openads needs to know which public URL corresponds with the local directory or
directory on the web server. Do not specify a trailing slash (/).

Local directory

Specify the directory where Openads needs
to copy the uploaded banners to. This directory must be writeable by PHP, and
this could mean you need to modify the unix permissions for this directory
(chmod). The directory you specify here must be in the web server' document
root, as the web server must be able to serve the files directly. Do not
specify a trailing slash (/). You only need to configure this option if you
have set the storing method to Local directory.

Moving banner files from the database to a
local directory

An advantage in having your image files in a separate
directory, outside of the Openads root, is that they are unaffected by
subsequent upgrades. If you already have those files stored in the database,
you can move them to the local directory. Firstly, as mentioned above, specify
Local directory as a storing method in the Main
settings:Banner settings
page. Ensure that you define the Public url
and and Local directory in the appropriate fields. Click Save
Changes
.

Now click the Maintenance tab. From the choose
section
drop-down list, select storage. Click the
Move images stored inside the database to a directory link.
Your images are moved from the database to the local directory you
specified.

Note that the storage option in the choose
section
drop-down list is only made available when you have specified
the public url and local directory locations.

FTP Host, Host directory, Login and
Password

Specify the FTP server where Openads needs
to copy the uploaded banners to. The directory you specify here needs to be in
the web server' document root, the web server must be able to serve the files
directly. If you don't specify a directory Openads will upload the banner to
the root directory of the ftp server. If you don't specify a username and
password Openads will attempt to login as an anonymous user with the
administrators e-mail address. It is not recommended to store your banners on
an FTP server, which can be accessed by anonymous users!!! Do not specify a
trailing slash (/). You only need to configure this option if you have set the
storing method to External FTP server.

Automatically alter HTML banners in order
to force click tracking

If this option is turned on Openads will
automatically alter HTML banners in order to allow the clicks to be tracked.
However even if this option is turned on it will be possible to disable this
feature on a per banner basis.

Allow PHP expressions to be executed from
within a HTML banner

It is possible to let Openads execute PHP
code embedded inside HTML banners. Running PHP code is always a security risk,
unless you are the only one using this system. This feature is turned off by
default.