Installing Arrow Trader Lite III
1. Uploading
Visit the download page here first and download the correct package.
After you've downloaded the ATL package, create a directory called at3 in your cgi-bin directory,
and upload the package (.tar.gz file) to it, in binary mode
2. Unpacking
With your favorite SSH client, make your way to the directory in which you've uploaded Arrow Trader
using the SSH commands written below, and unpack it.
To unpack, type gunzip at3_bsd4.tar.gz followed by enter.
Then type tar -xvpf at3_bsd4.tar followed by enter.
* This is an example for the FreeBSD 4 package.
3. Installing
Now the files are unpacked, run the installer by typing ./install.cgi
followed by enter, and select option 1) new installation.
!! do not load install.cgi in your browser.
!! do not install ATL3 with the root account
!! do not run install.cgi more than once
!! delete install.cgi once you're done with the installation or chmod it to 0
Now go to http://www.yourdomain.com/cgi-bin/at3/admin.cgi and log in!
The default login is user / pass.
Be sure to have cookies enabled, otherwise you can't log in.
Configuring Arrow Trader Lite III
1) Menu --> Settings --> Username + Password
Click on 'Settings'. Fill out a new username and password.
2) Menu --> Settings --> General Settings
url to http /img/ dir: this is the url to your AT image directory, probably http://www.yourdomain.com/at3/
url to http /cgi-bin/at/ dir: this is the url where you installed AT, probably http://www.yourdomain.com/cgi-bin/at3/
3) Menu --> Settings --> Active / Passive Trades
A trade remains passive and won't receive traffic back as long as it has sent less than the amount of hits that you specify here.
For now, leave it at 0 because all your new trades will start at 0 as well, but later on you can increase this number to 10 - 100.
4) Menu --> Settings --> Extra out Traffic Handling
Once a surfer has visited all your active trades, he is sent to exout. Even when you set this to 'send to gallery url',
you should still change the exout url, since it's also used as error url.
5) Menu --> New Trades --> Your info
This is where you fill out the info of your own site, which other webmasters will use when adding trades.
6) Menu --> New Trades --> Settings For New Trades
Here you set the settings new trades will get. It's not a bad idea to cap new trades so you get a chance to review
the trade before you send normal amounts of traffic. Also, to identify new trades easily, consider giving new trades
a difference background color.
7) tracking incoming hits
To track incoming hits, you need to place the following code in your index.shtml file
<!--#include virtual="/cgi-bin/at3/in.cgi" -->
for php mainpages use
<?php virtual ("/cgi-bin/at3/in.cgi"); ?>
To see if SSI (server side includes) is enabled, open your main site,
and check for a line similar to the following
document.cookie='atref=noref$#; path=/;
If you still see the #include virtual= .. line, ask your host to enable SSI.
If you see an error like "an error occurred while processing this directive",
you either uploaded the incorrect package, or the permissions of the cgi files are incorrect.
8) writing outgoing links
out.cgi takes a number of arguments that allow you to define how it should work
&s= set the percentage of hits that should go to galleries
&l= give the link a name. Fill out the botlink tag here for hidden bottraps
&c= set how many clicks should go to galleries before using the &s= skim
&u= set the gallery url. this must be at the end of your link!
&gr= tell ATL to send to trades from this group before using other trades
Some examples
<a href="cgi-bin/at3/out.cgi?s=70&l=teenthumb&c=2&u=http://www.somegallery.com/01/">Teen Gallery</a>
skim set to 70%, linkname is teenthumb, surfer will see 2 galleries before &s=70 is used
<a href="cgi-bin/at3/out.cgi?s=100&l=banner&c=0&u=http://www.mysponsor.com?s=60&l=992">Teen Site</a>
skim set to 100%. But, since this is a direct link to a sponsor you don't want to send a click on this link
to a trade. So we use &c=0 which means that a click on this link will always to go the url, regardless of all other settings.
The url the surfer is send to is http://www.mysponsor.com?s=60&l=992
This is why the &u=url part must always be on the end. Now ATL knows it shouldn't mess with
the ?s=60 part and the &l=992 part in the url, because those codes are for the sponsor.
| Basic Bash Commands |
(for ssh client) |
| - pwd |
Display the full path to the the directory you are in |
| - ls |
Display the contents in the directory that you are in |
| - cd ../ |
Go one directory level up. (from /usr/www/domain/htdocs/ to /usr/www/domain/ for example) |
| - cd mydirectory |
Go to another directory ("mydirectory" in this case) |
If you need more help installing Arrow Trader, please ask on the support forum.
Permissions Table
Whenever the script isn't counting hits, storing trades, or giving internal server error 500 errors,
make sure the permissions of the files are correct before asking on the forum.
In 99% of the cases, wrong permissions are the cause of the problem.
By default, the installer tries to set the right permissions.
| File or Directory |
Permissions |
| D: /cgi-bin/at3 |
755 |
| F: /cgi-bin/at3/*.cgi |
755 |
| D: /cgi-bin/at3/d |
777 |
| F: /cgi-bin/at3/d/* (all sub dirs & files) |
777 |
| D: /cgi-bin/at3/l |
777 |
| D: /cgi-bin/at3/l/* (all sub dirs & files) |
777 |
| D: /cgi-bin/at3/x |
755 |
| F: /cgi-bin/at3/x/*.cgi |
755 |
|
