Banner Exchange Script - How to Install
Our banner exchange script, Link Demon, can easily be installed in your web site. Check out the systematic process of installation.
1. Unzip the file that you have downloaded into the root of your web folder. If you do not have physical access to the server, you will have to unzip the file on your computer then upload all files into your online account with your favorite FTP program.
Example: c:\inetpub\wwwroot
You should now have a folder with the unzipped contents in it.
2. Next, make sure that your data folder (i.e. c:\inetpub\wwwroot\data) permissions are set for the IUSER_<machine name> user Read, Write and Delete. Make sure that these changes are implemented in all the files and folders below it. Always keep in mind that you may need to contact your web host provider and ask them to do this for you.
Setting up the permissions is the most important step to execute before installing our banner exchange script. Make sure the changes are incorporated into the IUSR_<machine name>user.
3. Point your browser to the setup.asp file located at the top-level of your folder.
Example: http://www.yourdomain.com/setup.asp
4. Once you have accepted the terms and conditions, follow the instructions and fill out all the fields on the form.
5. These are the values that you are supposed to enter into the online setup form.
Admin Username
This will be the login name that you will use to log into the main admin page.
Admin Password
This is the password that you will need to enter in order to log in to your admin account.
Your Web Site's Name
This is the name of your web site, for example, LoudASP.com
Your Web Site's URL
This is the URL of your web site, for example http://www.loudasp.com
Your SMTP Address
This is your outgoing email server's address.
Your Email Address
This is the email address that your users will use to contact you.
Service Name
It is the title that you want your new service to be termed as.
Banner Directory
The full physical path to where user banners will be stored. For Example: c:\inetpub\wwwroot\linkdemon\banners. Do Not include an ending slash "\".
Banner URL
The full URL path to where user banners are stored. For Example: http://www.loudasp.com/linkdemon/banners. Do not include an ending slash "/".
System Directory
The full physical path to where your Link Demon system files are located. For Example: c:\inetpub\wwwroot\linkdemon. Do not include an ending slash "\".
Link Demon URL
This is the URL path to the folder that stores the Link Demon script files. For example: http://www.loudasp.com/linkdemon. Do not include an ending slash "/".
New User Credits
New User Credits is the number of credits each new user can avail of. The default is 50. But you can change this number at your will. A credit is the system's way of keeping track of how many banner views each user gets on your network.
Number of Banners
This indicates how many banners you will let a user have at a time. If you set this number to 5, each user will be allowed to upload 5 banners onto your network.
Banner Size
This field is for setting the maximum size for each banner. This number is in bytes. If any banner exceeds the stipulated banner size, the banner will be deleted.
Banner Width
This shows how wide your banner will be when shown on the member sites. We recommend a width around 468 pixels.
Banner Height
This is how high your banners will be when shown on the member sites. We recommend a height around 60 pixels.
Banner View Points
This denoted the number of credits a user will get for showing one of your banners on their pages. This doesn't have to be a whole number. We recommend 0.5 points.
Banner Click Points
This is similar to view points. This is the number of credits per every time someone clicks on your banner from a member's page, instead of the number of credits per view. We recommend one point.
Review Banners
Setting this value to "YES" enables you to approve each banner before it is live on your network.
6.Once you have finished the above steps, you will be informed with a congratulations screen. You have made it!
7. If you wish to allow your users to purchase "Banner Credits", you need to log into your Admin Center and setup your PayPal details.
8. Once you have successfully installed your Link Demon installation, it is recommended that you delete the files ./setup.asp and ./data/update.asp for security reasons.
Setup Instructions - PayPal IPN
The purpose of setting up of your PayPal account with Instant Payment Notification (IPN) is to ensure that your Link Demon system receives instant notification of a successful payment. So, you can make quick changes in your PayPal account.
The IPN-Installation procedure:
- Log in to your Premier or Business PayPal Account.
- Go to the 'Profile' tab.
- Click on the 'Instant Notification Preferences' link in the 'Selling Preference' column.
- Click Edit.
- Check the box and enter the following URL: http://www.yourstore.com/paypal_return.asp
- Click Save.
You have successfully setup your PayPal IPN.
Notification Validation
You have to ensure that the payment has been made into your Paypal account. You have to verify that the email address used as your 'PayPal ID' previously set in Link Demon system settings, has been registered and confirmed in your PayPal account.
Banner Credits
The frequency of banner exchange is measured by 'Banner Credits". If a user has banner credits, his banners will be shown on members' websites. PayPal Integration enables users to purchase banner credits.
The Spider
Link Demon uses Microsoft XMLHTTP object. This comes standard with XP. You may have to download it via Microsoft's website if you are using an older version of 2000. This is a free COM.
To disable spider:
Open the file /includes/functions.asp and comment out lines 49-63 and line 65.
Banner Code
Users have to insert your banner code into their web pages. Simple cut and paste method will serve the purpose. If users have purchased banner credits from your system, then insertion of banner code is not required.
In absence of a banner in your system, a default text message will be shown instead. With your knowledge of ASP and HTML, you can change the message by editing the code in showbanner.asp on
line 12-16.
Administration
The full administration page of Link Demon enables you to have complete control over your banner exchange network. You will have to run the setup first to reap the advantages of the admin pages.
Integrating Link Demon Into Your Existing Web Site
You can integrate Link Demon into your existing web site with your limited knowledge of HTML. If you have a fair idea of ASP, you can customize it as well.
Customizing Your Success Page
Developing your own success page is simple. Add one line of code:
<!--#include file="includes/success_paypal.asp" -->
Customizing Your Cancel Page
Developing your own cancel page is simple. Add one line of code:
<!--#include file= "includes/cancel_paypal.asp" -->
Other Pages You Can Customize
You can also customize the look and feel of other pages in the same way.
The pages are:
Forgetpassword.asp
Login.asp
Newuser.asp
Newusersecret.asp
Newusercreatell.asp
Newuserdone.asp
Useraccount.asp
Upgrading from a Previous Version
If you want to upgrade your system DO NOT use setup.asp script. This is for new installation only.
Upgrading 2003.00X to 2003.100
- Extract all the new files from your web site.
- Copy your existing database to the
/data/link_demon-database/directory
- Copy your existing users' banners to the
/data/link_demon-banners/directory
- With a text editor, edit dataconn.asp located in the /data/directory to now show:
<% Yourphysicalpath\data\link_demon-database.asp%>
- You will have to read, write and delete permission for the IUSER_<Machine Name> user on the Link Demon DATA Directory and all sub-folders, files etc.
- Run the update.asp script in your data/directory; that's all.
- Your system has been upgraded.
Upgrading 2003.1xx
- Extract all the new files to your web site.
- Run the update.asp script located in your /data/directory.
- That's all. Your system has been upgraded.
|