
What you need:
 - a webserver, e.g. apache (http://www.apache.org/)
 - a database, e.g. mysql (http://www.mysql.com/)
 - Perl (http://www.perl.org/)
 - DBI perl module (http://www.cpan.org/ or http://www.mysql.com/)
 - Msql-Mysql perl module (http://www.mysql.com/)
 - HTML::Template perl module (http://www.cpan.org/)
 - Some but very little knowledge of HTML and Perl

To install the scripts, copy the tarball to your cgi-bin
directory, do 

 tar -zxvf pcards.tar.gz  
 cd pcards 

and there you will find:

-rw-r--r--   INSTALL        
-rw-r--r--   README         
-rwxr-----   cron-card.pl   
drwxr-xr-x   pages          
-rw-r--r--   pcard-setup.pl 
drwxr-xr-x   postcards      
-rw-r--r--   postcards.sql  
-rwxr-xr-x   preview-card.pl
-rwxr-xr-x   select-card.pl 
-rwxr-xr-x   send-card.pl   
-rwxr-xr-x   show-card.pl   
-rwxr-xr-x   write-card.pl  

Move the postcards directory to your htdocs or html directory 
(or wherever your HTML files are).
This directory contains an example HTML file and some images
to help you get started.

You can run cron-card.pl from anywhere on your filesystem, 
just make sure that inside cron-card.pl you set the full 
path to pcard-setup.pl. 
Setup a cron job to run cron-card.pl every day, eg. at midnight.
Put the script in /etc/cron.daily (RedHat, usually runs at 4 am) 
or add a line like:

0 0 * * *      /var/www/cgi-bin/pcards/cron-card.pl 1>/dev/null 2>/dev/null

to your crontab file (usually /var/spool/cron/crontabs/) to run the
script everyday at midnight. Or use whatever administration tool
you have to setup cron jobs.

Check the location of perl (do a "which perl"), if different
from /usr/bin/perl, you will have to adjust this in the first 
line of the scripts.

Edit the beginning of pcard-setup.pl to suit your system and
setup the tables necessary in your database as shown in the file
postcards.sql, for MySQL do 

  mysql < postcards.sql

and setup a username and password to access the database
pcards, e.g.

  mysql
  USE mysql; 
  INSERT INTO db VALUES ('%','pcards','username','Y','Y','Y','Y','N','N');
  INSERT INTO user VALUES ('your.dowmain.com','username',password('password'),'N','N','N','N','N','N','N','N','N','N');
  quit

and then

  mysqladmin reload

to load the new attributed permissions.

That's all.


