phpAdsNew is a banner management and tracking system written in PHP.
[faq] [configuration]
[api] [homepage]
[report
bugs] [forum]
Please read first the INSTALL file for installation instructions.
If you are upgrading from a previous version of phpAdsNew you should read the
UPGRADE file for instructions.
In the current release, you have to configure all your information in config.inc.php.
Before you can use phpAdsNew you need to tell phpAdsNew which database to use and which username and password to use.
Specify the hostname of the MySQL database server.
Specify the username which phpAdsNew must use to gain access to the MySQL database server.
Specify the password which phpAdsNew must use to gain access to the MySQL database server.
If you wish to use different table names, for example to match the existing table names of you project, you can specify the alternative names here. Be aware, the tables you name here must be created; phpAdsNew will not automatically create these tables.
If you want to use persistent connections to the database server you must specify "1", otherwise specify "0". The use of persistent connection can speed up phpAdsNew considerably, but requires a lot of resources. If phpAdsNew is using too many resources, you should take a look at this setting first. Persistent connections are turned off by default.
MySQL lock the table when it is inserting a row. If have many visitors to your
site, it could be possible phpAdsNew must wait before inserting a new row, because
the database is still locked. When you use insert delayed, you don't have to
wait and the row will be inserted at a later time when the table is not in use
by any other thread. Another major benefit of using insert delayed is that inserts
from many clients are bundled together and written in one block. This is much
faster than doing many separate inserts, but could cause data corruption when
the database server should crash. This option is turned off by default.
phpAdsNew needs to know a few things about the system you are using in order to function correctly, for example the location of phpAdsNew.
phpAdsNew needs to know where it is located on the web server in order to work correctly. You must specify the URL to the directory where phpAdsNew is installed, for example: http://www.your-url.com/phpAdsNew
You should put here the relative path (e.g.: /home/login/www/header.htm) to have a header and/or footer on each page in the admin interface. You can put either text or html in these files (if you want to use html in one or both of these files do not use tags like <body> or <html>)
If you want you can change the look of phpAdsNew by changing these colors. The default color scheme is blue.
Specify the default language phpAdsNew should use. This language will be used as a default for the admin and client interface. Please note: you can set a different language for each client from the admin interface and allow clients to change their language themselves.
phpAdsNew currently supports these languages:
czech, dutch, english, flemish, french, german, hungarian, italian, polish,
russian-cp1251, russian-koi8r and spanish.
Specify the name you want to use for this application. This string will be displayed on all pages in the admin and client interface.
This name is used in the e-mail sent by phpAdsNew.
Traditionally phpAdsNew used rather extensive logging, which was very detailed but was also very demanding on the database server. This could be a big problem on sites with a lot of visitors. Since version 1.9 phpAdsNew uses a new kind of statistics, the compact statistics, which is less demanding on the database server, but also less detailed. The compact statistics only logs daily statistics, if you need hourly statistics you can turn the compact statistics off.
Normally all AdViews are logged, if you don't want to gather statistics about AdViews you can turn this off.
Normally all AdClicks are logged, if you don't want to gather statistics about AdClicks you can turn this off.
phpAdsNew logs the ip address of each visitor by default. If you want phpAdsNew to log domain names you should turn this on. Reverse lookup does take some time; it will slow everything down.
If you don't want to count clicks and views from certain computer you can add these to this array. If you have enabled reverse lookup you can add both domain names and ip addresses, otherwise you can only use ip addresses.
For most people a week starts on a Monday, but if you want to start each week on a Sunday you can.
Specifies how many decimal places to display on statistics pages.
phpAdsNew can sent you e-mail if a client has only a limited number of clicks or views left. This is turned on by default.
phpAdsNew can sent the client e-mail if he has only a limited number of clicks or views left. This is turned on by default.
The limit on which phpAdsNew starts sending warning e-mails. This is 100 by default.
phpAdsNew can use four different types of banner retrieval: Random banner retrieval (0, default), Normal sequential banner retrieval (1), Weight based sequential banner retrieval (2) and Full sequential banner retrieval (3).
For example, you have set 4 banners in phpAdsNew and the second banner is weight 2 (rest of the banners is weight 1):
Random banner retrieval: 1312312331231231231232312314121312
Normal sequential banner retrieval: 1234 3214 4213 2314 3241
Weight based sequential banner retrieval: 12324 43122 31221 21342 42321
Full sequential banner retrieval: 1234 1234 1234 1234 1234
phpAdsNew includes a powerful banner retrieval system. For more information, please read the API section. With this option, you can activate conditional keywords. This is turned on by default.
For each banner, you can specify one or more keywords. This option is needed if you want to specify more than one keyword. This is turned on by default.
If phpAdsNew can't connect to the database server, or can't find any matching banners at all, for example when the database crashed or was deleted, it won't display anything. Some users may want to specify a default banner, which will be displayed in these situations. 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 this default banner should only be used as a failsafe, not as a regular banner. This is turned off by default.
The administrator username, you can specify the username that you can use to log into the administrator interface.
The administrator password, you can specify the password that you can use to log into the administrator interface.
Specify the administrator's full name. This used when sending statistics via email.
The administrator's e-mail address. This is used as from-address when sending statistics via email.
You can alter the e-mail headers used by the e-mails which phpAdsNew sends.