Easily Install and Configure phpAdsNew

Document Sample
Easily Install and Configure phpAdsNew Powered By Docstoc
					                               Easily Install and Configure phpAdsNew

Before you read this article, make sure you have a Linux web server running PHP, and MySQL. If you
have all have all the requirements continue on, if not, either find a web server with what is needed, or
read this tutorial, and run your own. It will explain how to install Apache 1.3, PHP, and MySQL.
                                    Installation (Console Part)
You are first going to have to download the phpAdsNew package. I used the current package, you may
use the development package if you like, however things may have changed and be a little different
from how I explain them, the current phpAdsNew package as of the writing of this article is Version 2
After you download the phpAdsNew package, unzip it and move the directory that gets uncompressed
over to your htdocs directory. (Mine is at /usr/local/apache/htdocs, so that's what I will be using,
wherever you see that, change the path change it to whichever your path might be). I changed the name
of the default directory; you might want to do the same.

  unzip phpAdsNew-rc3.zip
  mv phpAdsNew-rc3 /usr/local/apache/htdocs
  cd /usr/local/apache/htdocs
  mv phpAdsNew-rc3 phpAdsNew

You should now have a directory called 'phpAdsNew' in /usr/local/apache/htdocs.
Next step, database creation. Create the database with the following line:

  mysqladmin create phpAdsNew -u username -p

If there was an error creating the database, it would tell you, if you don't get an error, everything went
as planned.
                                 Installation (Web Browser Part)
Now open up your web browser and goto http://your-url.com/phpAdsNew/admin/install.php and go
through the installation procedure. You can go through this on your own, or follow everything I do.

Install Page #1:
You can change the language to the language of your choice, but English (International) works just
fine. Hit the Proceed > button to continue to the next page.

Install Page #2:
Insert the "Database Hostname" into the first box. localhost should be fine.
Insert the "Database port number" into the second box. 3306 is the default port
Insert the username who has access to the database into box number 3.
And that user's password into box number 4.
The next box will contain the name of the database you just created. phpAdsNew
Leave the next 2 settings alone.
Hit Proceed > to continue.

Install Page #3:
Insert an administrator username in the first box, a password in the second box, and the password again
in the third box. You can use admin as a login, but that will be the first choice for someone trying to get
into your system.
The last box should have all the correct information in it, double check to be sure. It should read
Hit Proceed > to continue.

Install Page #4:
This page is just informing you that you have completed the configuration process, and phpAdsNew is
ready to be installed on your system.
Hit Proceed > to continue.
If everything went well (and it should have) you will be prompted with a login and password box. Put
in the name of the admin account you just created and the password, and log in.

*Poof* you will now be logged in and at the settings menu.

Page #1 - deals with all of the database settings. All of the options on this page are pretty
straightforward. I left all the settings at their default settings, except I turned Popups, and P3P Policies
Off. Click Save Settings to continue onto the next page.

Page #2 - deals with all the information pertaining to the users host information and Geotargetting data.
I enabled the first 2 switches, and left Geotargetting turned off. Click Save Changes to continue onto
the next page.

Page #3 - deals with the statistics engine that is built into phpAdsNew. Again, here, its ok to leave
everything at its default state except if you are running QMail, then you have to enable the QMail
Patch under the Email Warnings section. Make all the necessary changes to this page then click Save
Changes to continue onto the next.

Page #4 - deals with the banner settings. Insert a location of the default banner, and where you want the
default banner to point. Everything is fine as it stands, you can change settings to suit your needs
though. Click Save Changes to continue to the next page.

Page #5 - deals with the administrator settings. Insert all of the relevant information and click Save
Changes to continue on.

Page #6 - is for the User Interface Configuration. A good application name could be Yoursite's
Advertising Program. If you want to use a custom header or footer file, insert the location to these files
in the next 2 boxes, if not, leave them blank. GZIP content compression is nice, it will compress the
files before it sends it out. This will help save on your bandwidth bill, so I recommend enabling it.
Insert a welcome message to your advertisers or disable it completely, its your choice. Click Save

Page #7 - is for the Interface Defaults. The default configuration is fine; however, feel free to make
changes to suit your needs. Click Save Changes.

You have just successfully configured the phpAdsNew ad system. You are now ready to continue on to
start adding clients and banners.
                                    Adding a Client/Campaign
Start off by making sure that you are logged in as the administrator. (This should be the only account so
far) If you are not logged in, log in now and click on the "Inventory" tab near the top of the screen.
Click on the same tab, if you are already logged in.
Now click on the "Add new advertiser" link. You will now have a form to fill out. Start out by filling in
the Basic Information. Default language will be the language that you are currently configured to use.
The advertiser report section is all the options pertaining to either the software package sending a report
on how their banner is doing, or an email warning the advertiser that their banner has been deactivated.
Provide some login information for the advertiser, and set up some permissions on the account. You
might not want to give them access to activate and deactivate their banners. Click Next to continue.

You have now setup an advertiser account. You now have to setup an ad campaign for that advertiser.
That's what you will do on the next page you are brought to. First enter a name for the ad campaign.
You now have some options to setup. If your advertisers are paying you monthly keep "Unlimited"
checked. If your advertisers are paying you per view or per click, fill in the proper fields with the
proper information.
You can also choose to activate the campaign immediately, or on a certain date. Don't forget to set a
expiration date, and a priority on the ad campaign. You have a couple different options when setting
the priority. Well... 2 to be exact. High priority and low priority. They are both explained right there so
read carefully and choose wisely. Click on Save Changes and you have completed creating an ad
                                 Adding a Banner to a Campaign
To start down the road of adding a banner to an ad campaign, go back to the inventory menu by
clicking on the "Inventory" tab near the top of the screen. Now click on the advertiser you just added.
#1 in the picture below, this will then bring up the menu with the create option. Now click on create, #2
in the picture below.

You should now be at the second page for adding a banner. You have 4 different banner types Local
Banner, External Banner, HTML Banner, and Text Ad. (If you have the popup option enabled, you
should have that aswell).

Local Banner (SQL)
The banner will be stored in your MySQL database when you choose this option.

External Banner
You would choose this option if the banner is hosted on another site.

HTML Banner
You would choose this option if you are using a service like Commission Junction, where they track
adviews and banner clicks aswell. You will know to use this option if they give you the HTML to be
added to your site.

Text Ad
This one is pretty self explanatory. A basic text ad, this will be stored in your MySQL database.
After you choose which type of banner to add, fill in all the information on the page and click Save
Changes at the bottom of the page and continue on to page 3.
You can setup ad limitations here. You can set the ads so they don't show up on your site for a certain
ammount of time after being displayed once, or how many times to show that ad to a certain user, etc.
If you don't want any limitations just click Save Changes, else fill in the relevant boxes and click Save
Changes to continue on. You have now added a banner. Now scroll over to the left hand side of your
screen under the navigation menu and click on "Banner Overview" this will show you all the banners in
that campaign. From here you can delete ads, deactivate them, reactivate them etc.
                                      The Navigation Menu
If you don't know where the Navigation menu is, just look to the left hand side of your screen, and you
will see it there. The "Inventory" link will take you to the same menu as the "Inventory" tab near the
top of the screen.
The "Advertisers & Campaigns" link will bring you back to your list of advertisers.
"Campaign Overview" will give you all the information about the current campaign you have launched
for the selected campaign.
You may also move campaigns from one advertiser to another, or delete one under the "Modify
Campaign" Section.
                                    Generating Banner Code
Generating the banner code is really easy. Click on the "Generate Bannerbode" buttom at the top of the
Choose which mode you would like to use to display the banners, I use local mode. Now select which
advertiser or campaign you would like to generate the banner code for, fill in the rest of the relevant
information and click generate.
Either copy the banner code, or click on "Copy to clipboard" and then place the code wherever you
would like the banner to be placed on your site.

Shared By: