####################### 
# postcard.pl 1.3 README 
# 
# By Command-O Software 
# http://www.command-o.com 
# Programmer: Kendall Comey, kendall@command-o.com 
# 
#Copyright 1997 
# All Rights Reserved 
######################## 
IMPORTANT NOTICE	
If you have version 1.1 or 1.2 throw it away and use version 1.3 instead!

You should have received the following files when you downloaded this script: 
1. README - This file. 
2. postcard.pl - The actual script. 
3. postcard.setup - The file you will use to set most of your variables. 
4. cardcenter.html - The first html page the user will access. 
5. postcard.html - The html page from which a user previews a postcard. 
6. preview.html - The html page from which a user send a postcard. 
7. pickup.html - The html page a user accesses to pick up a postcard. 
8. show_postcard.html - The template for the actual html postcard. 
9. thank_you.html - The html page the user sees after sending a postcard. 
10. mail.txt - Text file containing the message that is email to postcard recipient. 
11. cgi-lib.pl - A perl library. 

Following are instructions for installing and modifying the aforementioned files. 

### 
postcard.pl 
### 
This file must be installed in your cgi-bin and be chmoded 755. The first line of the script must point to the location
of perl on your server. In most cases this is either 
#!/usr/local/bin/perl 
OR 
#!/usr/bin/perl 
Also, if for some reason you do not install the postcard.setup in your cgi-bin as recommended, the line 
require 'postcard.setup'; 
in the script must reflect the path of the postcard.setup on your server. 

### 
postcard.setup 
### 
Place this file in your cgi-bin and chmod to 755. You will need to change the variables in this file to reflect your
server specifics before you upload the file. 

How to Set the variables: 
$url_of_postcard_html = "http://your_server.com/postcards/postcard.html"; 
This is the url that points to the html file postcard.html. 

$url_of_pickup_html = "http://your_server.com/postcards/pickup.html"; 
This is the url that points to the html file pickup.html. 

$preview_postcard = "/www09/web/untrac/postcard/preview.html"; 
This is the system path to the html file preview.html. 

$cardlist = "/www09/web/untrac/postcard/card.list"; 
This is the system path to the file which will have the postcard database written to it. 

$thank_you = "/www09/web/untrac/postcard/thank_you.html"; 
This is the system path to the html file thank_you.html. 

$show_postcard.html = "/www09/web/untrac/postcard/show_postcard.html"; 
This is the system path to the html file show_postcard.html. 

$reply_to = "your_email\@your_server.com"; 
The return email address you would like specified. You need to backslash the @ sign as shown.

$company = "Your Company"; 
Your name or your company name. Used in email. 

$subject = "A Postcard for You!"; 
Subject of email to recipient of postcard. 

$mail_message = "/www09/web/untrac/postcard/mail.txt"; 
The system path to the text file mail.txt. 

$mailprog = '/usr/lib/sendmail -t'; 
The system path to the sendmail program on your server. The -t is there for security reasons.

$date_command = "/usr/bin/date"; 
The system path to the date command. 

$days = "14";
The number of days after which a postcard is no longer retrievable. 

### 
cgi-lib.pl 
### 
Put this file in your cgi-bin and chmod to 755. 

### 
Create a directory named postcards and chmod it so it's writeable (either 755 or 777). 
### 

#Note: Some servers use cgi-local instead of cgi-bin. 
### 
cardcenter.html 
### 
Put in postcards directory. You will need to change the form action tag to read: 
<form action="http://your_server.com/cgi-bin/postcard.pl" method="POST"> 
The html page can be edited freely. 

### 
postcard.html 
### 
Put in postcards directory. You will need to change the form action tag to read: 
<form action="http://your_server.com/cgi-bin/postcard.pl" method="POST"> 
The html page can be edited freely. However, do not change the names of the input fields or the values of the
images. This page displays the smaller images of your photographs or graphics. 

### 
preview.html 
### 
Put in postcards directory. You will need to change the form action tag to read: 
<form action="http://your_server.com/cgi-bin/postcard.pl" method="POST"> 
The html page can be edited freely. Do not alter the hidden fields. 

### 
pickup.html 
### 
Put in postcards directory. You will need to change the form action tag to read: 
<form action="http://your_server.com/cgi-bin/postcard.pl" method="GET"> 
The html page can be edited freely. Do not change the input field names. 

### 
show_postcard.html 
### 
This html page can be edited freely. The "%%variable%%" holders need to remain in the file, but can be relocated. 

### 
thank_you.html 
### 
This html page can be edited freely. The "%%name%%" holder needs to remain in the file, but can be relocated. 

### 
mail.txt 
### 
This text file can be edited freely. The "%%variable%%" holders need to remain in the file, but can be relocated. 

### 
All files should be uploaded as text. That's it! Send a postcard! 

