What is it ?
eRS (eRecommend Site) allow visitors to send (Recommend) an e-mail message
about your site to friends simply by entering the email address (and name
optional).
It's ensure that two good email addresses are entered to avoid anonymous
spamming. The message and result look page are customizable, and a copy can be
mailed to the site owner by turning this option on.
Very easy to install.
System Requirements:
- Perl 4.0 or newer; you can get it at http://www.perl.com/
- A web server, you must have access to add / execute CGI scripts.
Download current version
Current version is v1.1, created 01/10/2000, last modified 01/15/2000.
Download source code / scripts and documentations :
Tar/Gzip archive : eRS.tar.gz (0 Ko)
DOS Zip format : eRS.zip (0 Ko)
What this archive contains ?
This archive comes with 12 differents files:
1) COPYING: Copyright informations (GPL).
2) README: This file.
3) LISEZMOI: French doc...
4) enews.cgi: The script.
5) cgi-lib.pl: CGI-Lib of Steven E. Brenner used here..
6) eRS_log.txt: Log file.
7) eRS_messEn.txt or eRS_messFr.txt: Message to send.
8) template.html: Sample present result file.
9) form.html: Sample form.
Installation and Configuration:
It's a Perl script, so installation is pretty easy. You don't need to
compile anything.
Copy *.cgi and *.pl in your /cgi-bin/ directory.
Copy *.txt in your data directory
Copy template.html, in your template data directory.
Copy form.html in your web directory.
Make it executable, unix only (chmod a+rx *.cgi)
Make writable data file, unix only (chmod a+rw *.txt)
You will have to do some configuration:
Edit ers.cgi scripts and change #/usr/bin/perl, if it's necessary...
Edit ers.cgi and change "Necessary Variables Section"
my $DISPLAY_LANG = 'Uk'; # Fr to use french message, else english.
my $WEBMASTER_EMAIL = 'webmaster@ftls.org'; # Webmaster E-Mail
my $DATA_DIR = '/Absolute/path/to/data_dir/'; # data dir.
my $LOG_FILE_NAME = 'eRS_log.txt'; # Log file name.
my $MESSAGE_FILE_NAME = 'eRS_messEn.txt'; # Message send file
my $CONFIR_MESSAGE_NAME = 'eRS_messEn_cnf.txt'; # Confim message name.
my $TEMPLATE_RESULT = $DATA_DIR.'template.html';
# Template for result look.
my @REFERERS = ('http://www.mydom.dom'); # Witch web site can use this CGI.
my $SEND_MAIL_TO_SENDER = 0; # Send a confim message to sender.
my $SEND_MAIL_BCC_WEBMASTER = 0; # Send Bcc mail to webmaster for each post.
my $DELAY = 10; # Minimum delais (Minutes) before
# another message can be send by same IP.
# I you can prefer to use Mail::Sender module
my $MAIL_CMD = '/usr/sbin/sendmail -t'; # Send Mail command (Unix Only)
my $USE_SENDMAIL_UNIX = 1;
# 1 Use unix sendmail command, 0 use Mail::Sender module
#use Mail::Sender;
# En: Uncomment, Only if you don't use Sendmail (NT)
How to run it ?
Got to your form.html page and test it...
How to change template :
You can edit all templates files to customize it, but eNews use many
tags (Noted Value_NAME) to insert data, don't forget to add it's.
Version history:
Version 1.1 01/15/2000 - Create archive, add Mail::Sender.
Version 1.0 01/10/2000 - Script Created.
Copyright:
This software is copyright (C) 1999 Frederic TYNDIUK. It is distributed
under the terms of the GNU General Public License (GPL). Because it is licensed
free of charge, there is NO WARRANTY, it is provided AS IS. The author can not
be held liable for any damage that might arise from the use of this software.
Use it at your own risk.
See the file COPYING for more details (or http://www.gnu.org/).
Updates ?
Latest version and New Scripts can be found at:
http://www.ftls.org/en/
Contact:
Please feel free to contact me with any comments, suggestions, bug fixes
criticism, or just a happiness messages.
If you run into any problems while trying to configure these scripts
first read this file carefully, if you don't find any solution, send me a Mail.
E-Mail: tyndiuk@ftls.org
Web: http://www.ftls.org/
Frederic TYNDIUK
