phpAdsNew : version 2.0.4-pr2
phpAdsNew is an open-source ad server, with an integrated banner management interface and tracking system for gathering statistics. With phpAdsNew you can easily rotate paid banners and your own in-house advertisements.
Installation Procedure 
Quick Tips
The script can be downloaded from here.
The file that you will download is saved in .zip format; this is a compressed bundle containing the files in the distribution. Unzip this archive in a temporary directory on your computer using decompression software.
Start your FTP software and upload all content to your web server preserving the file structure.
Let's assume you install the contents of the phpAdsNew folder to /var/www/html/ad
URL: http://www.mywebsite.com/ad
Point your web browser to http://www.mywebsite.com/ad. The first thing you should see after starting the installer should be the welcome page. On this page you will find some general information regarding phpAdsNew and support. After reading this page you can proceed to the license page which will explain a bit about the license under which phpAdsNew is released. Click Proceed to begin the actual installation.
Before you can continue you need to setup the administrator account. You can use this account to log into this administrator interface and manage your inventory and view statistics. Configure the administrator account with your information.
Database settings.
*Please use "127.0.0.1" for the database hostname.
Database Name: (enter your DB name, you can get this information in you Site Admin Panel)
Username: (enter your DB username)
Password: (enter your DB password)
Congratulations, the installation of phpAdsNew is now complete, click "Proceed"
The system will direct you to that phpAdsNew Admin Control Panel. We strongly suggest you to read the user guide at this point.
http://www.samplesite.org/ad/phpadsnew/misc/documentation/user-guide.pdf
After you had configured phpAdsNew, please use your FTP client to secure the file config.inc.php.
Set the file permission of config.ini.php to 444:
To change file permissions using a FTP client, select the file by clicking on it once on the remote system side and then right-click on the file to bring up the option menu and select CHMOD.
You will see the "lock icon" after you had secured config.ini.php in the previous step.
(Refresh your control panel)
First Part - Setting up the Publisher (Reference User Guide Page 54)
Question: Why Create a Publisher?
Answer: Before you can define which banners are displayed you need to create at least one Publisher. Usually the first publisher you define is used for your own website.
- To setup this first publisher, click on the "Publisher & Zones" tab.
- Click on "Add new publisher".
- Fill in the required fields and any other options you wish to give this publisher.
Note: If there are other web sites that are going to be using the Invocation Code, set those up as a separate publisher.
Second Part - Setting up the Zones (Reference User Guide Page 57)
Question: Why Create Zones?
Answer: Zones are used to define a space on a website which is used for advertising. A zone can be a single specific space on only one page, or a space which is used on multiple pages, but show the same banners. Some examples of zones are; Home Page - Header, Home Page - Footer, Forum - Header, News - Footer, etc. If you want zones on other sites, you should setup this other site as a separate publisher.
- To setup a zone, you need to first select the publisher you want the zones setup under.
- Click on "Zone Overview Tab".
- Click on "Add new Zone".
- Fill in the required fields and any other options you wish to give this zone.
Note: In certain conditions you might need a zone which isn't limited to a specific size, for example when you want to create a bar of different banners which have the same width, but may have a different height, or you need a no width and height limit. If you specify an asterix (*) as the width or height (or both), phpAdsNew will ignore this property.
Third Part - Time to Generate the Invocation Code to Display Banners (Reference User Guide Page 75)
- Click on the "Publisher & Zones" tab. Then click on a "Zone" you want within that "Publisher".
- Click on the "Invocation code" tab under that Zone.
- There you'll select from the drop-down menu "Remote Invocation for XXXXXXX (how you want it displayed. Want to know what each type of invocation code does, reference the User Guide on page 77)".
- Fill in the Parameters and click "Generate"
- Copy and paste this generated code into the web page you want that Zone to display in. Save and upload that new page to the server.
- Continue step 5 above for all other zones.
Note: If you want to use the same code again on the same page, make sure to re-generate the code again so you get a unique identifier for tracking impressions and click-throughs.
Back to Tutorial Top
