## User Documentation for PerlADS 1.1
##    Written by: Rickard Sjöström [, <name>]
#######################################################
#######################################################

TODOs:
 - feature: add photo-upload feature
 - bug: fix "number of ads per page"-bug
 - bug: adding a ad takes you to a blank page when trying to view it <fixed, jan 2005>
 - bug: language support works badly, redesign or remove
 - feature: dont show add until viewing the ad

Important:
Try to set up the script as it comes when downloading it 
and then if nescessary configure it for you needs!
Of course you have to change in setup file.


General
- There is only one database maintain by the script. Is
a pipe seperated text file.
- The script supports multiple languages but the initial
configure does not uses this (see setup.cfg)
- When set up with multiple language support call the
script using: http://foo.com/cgi-bin/ads/ads.pl?lang=X
(where X is one of your language files)

### SETUP
#######################################################
Changes listed according to eache file:
- ads.pl
   Here you should only need to edit the first line and set
   it to where Perl is located: usually #!/usr/bin/perl or 
   #!/usr/local/bin/perl 
   Optionally you can also change which setup file to use.


- setup.cfg 
   Set all variables as described in this file.


### PERMISSIONS
#######################################################
This is the recommended permission for each directory and file.
- ads:   => 755
         ads.pl => 755
         setup.cfg => 755
         admin.pl => 755
         header.txt => 644
         footer.txt => 644

- data:  => 755
         data.txt => 777
         id.txt => 777

- language_files: => 755
                  * => 644
### STEP-BY-STEP
#######################################################
This assumes you have ftp access to your website
1. Unzip your files on your local machine.
2. Change the files as recommended in section SETUP above.
3. Upload the to the server (e.g /cgi-bin/ads/) using ASCII mode!
4. Set the permissions as recommended under in section  PERMISSIONS above.


### SPECIAL NOTES: WINDOWS NT
#######################################################
In order to get the e-mail function to work check with your ISP
if there is support for blatmail which "simulates" the sendmail program
on Uni*x machines. Try to set the mail program variable to the path 
to blatmail e.g c:\winnt\blat\blat.exe. There is no support for
SMTP servers in PerlADS.