# $ # $ (Mail select version 3.8) # $ # $ Mail Select was first made for myself because I was interested in sending binary # $ files via sendmail, this if you have been a regular visitor to my site was not actually # $ completed until 2.8. Now I have made a sendmail program for windows and windows NT # $ my mail select program can be used by the win32 sector. (N/A Yet) # $ # $ This code is distributed in the hope that is will be useful but WITHOUT ANY # $ WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY DISCLAMED. This includes # $ but isn't limited to warranties of MERCHANTABILITY or FITNESS FOR A PARTICULAR # $ PURPOSE. The RESELLING of this code is STRICTLY PROHIBITED. # $ # $ $Revision: 3.8 # $ $Author: Paul Williams # $ $Email: paul@rainbow.nwnet.co.uk # $ $URL: http://www.cougasoft.org/ # $ $Created: 17/11/1996 16:07 # $ $Last Modified: 01/04/2000 18:16 # $ # $ Copyright 1996, 1997, 1998, 1999 Cougasoft. All rights reserved. # $ Ok, you should of recieved the following files to get this script up and running :- 1. mail-select.cgi 2. ms-admin.cgi 3. ms-data.ais 4. ms-pref.pref 5. README 6. mailselect.gif If you don't have all these please go back to - http://www.cougasoft.org/ README CONTENTS --------------- 1. Installation ------- Change perl location ------- Upload + Chmod 2. Administration help ------- User Preferences ------- Activity Log ------- Layout Preferences N.B. If you have any problems with getting this script to work please :- 1. Exhaust this README file. [No Luck ?] 2. Email me with the problem (Be as specific as possible) [No Luck?] 3. Go to my site and fill in the 'Paul Install' form. I should then hopefully be able to install the script for you. I don't charge anything for this service but please bear in mind I will be using my spare time to help you and any contribution would go a long way with me ;) Register the script ;- Please Visit : http://www-register.cougasoft.org/register.cgi # ########## ------------------------------ ##################################################### # # I N S T A L L A T I O N # ########## ------------------------------ ##################################################### # Change the first line -[ #!/usr/bin/perl5 ]- to the path your perl interpreter is located on your server. This is the most common location. ---- Do this for mail-select.cgi & ms-admin.cgi If you don't know where it is you can either :- 1. Type -[ which perl ]- on the telnet screen. 2. E-mail admin and ask where perl is located. 3. If you are admin, go rent a movie ! ;) mail-select.cgi REQUIRES perl5 !!! Please make sure it points to perl5 & not perl, there is a difference. Well, there is on most servers :) To check the perl version type: 'perl -v' at the telnet prompt # ########## ------------------------------ ##################################################### # ########## ------------------------------ ##################################################### # Upload the following files:- No. Script|GIF Where Chmod to ---- ---------- ----- -------- 1. mail-select.cgi /cgi-bin/ 755 2. ms-admin.cgi /cgi-bin/ 755 3. ms-data.ais /cgi-bin/data 666 4. ms-pref.pref /cgi-bin/data 666 5. mailselect.gif /imx/ - NOTE: - Make sure your CGI-BIN is chmodded to 731 - Make sure the DATA files are chmodded to 666 NOTE: - When you upload the preference file you can do one - of two things, upload it to the data dir (as shown - above) or place it in the same directory as the script. - Either way the script will still work the same ;) [Ques: So Paul, how do you upload your scripts ? ]. [Answ: Good question :) here is how and what I use :- 1. I open WS_FTP95 [http://www.ipswitch.com] 2. Log on to my server 3. Upload script|data files to my directory in ASCII mode. - If you upload in binary the script may not work. 4. Chmod the script|data files to the correct permission. Follow these stages to chmod :- - Got to the DIR with the script (data file) in. - Right mouse click in the white box on the right under 'Mkdir' - Click on FTP Commands - Select 'SITE' - It should then ask you to enter a 'SITE STRING' Type there chmod 755 mail-select.cgi 5. Check the script in my browser for any errors. 6. Log off. 7. Have a nice cup of coffee and bask in my uploading glory :) # ########## ------------------------------ ##################################################### # ########## ------------------------------ ##################################################### # NOTE: Once these stages have been completed correctly the script should work ! Now, go to administration [ms-admin.cgi] and you will be prompted to make your password, and change all the necessary locations & info needed to start the script. The script needs to set a few valuable preferences to get it to work successfully. One last thing, DON'T PUT YOUR OWN PASSWORD STRAIGHT INTO THE PREFERENCE FILE. It's encrypted by the script so if you set it to 'daniel' it just will not work ;) # ########## ------------------------------ ##################################################### # ########## - END INSTALLATION [] -------- ##################################################### # # ########## ------------------------------ ##################################################### # # A D M I N I S T R A T I O N # ########## - USER_PREFERENCES [] -------- ##################################################### # EMAIL PREF ---------- Name - Your name Email - Your E-mail Organisation - Organisation (Leave blank for no organisation) Footer ? - This is if you would like to add something to the bottom of the attatchment. The box is wrapped but if you use the box as an email outline you will find its just right. USER PREF --------- Update your username || password at any time, although it is crypted, I suggest you change it every now and again. # ########## ------------------------------ ##################################################### # ########## - ACTIVITY_LOG [] ------------ ##################################################### # Shows latest downloads, who, when and what he/she downloaded. The log can be from 1-99, update how many downloads you have set in Layout|Data pref. # ########## ------------------------------ ##################################################### # ########## - LAYOUT_PREFERENCES [] ------ ##################################################### # LAYOUT PREF ----------- Your URL - Change this to the URL of your homepage, it is put on the main guestbook page. Mail-select GIF - Change this to the URL of my mailselect GIF, or the URL of your own graphic you would like to use. [Body text Page BgColor Background GIF Link Visited Link Active Link Table BgColor] - With the exception of Background GIF, these are all colors which you can alter to suit your needs. [ Must be in hexadecimal format i.e. #C0C0C0 ] Add my link ? - If this is checked, the top graphic has a link back to my site. [ If you can find it in your hearts to keep this checked I would be ever so greatful :) ] M-SELECT PREF ------------- Redirect User ? - Type in the URL you would like the user to be redirected too. If you leave this blank, a default page is whipped up. Download Types - Select what types of files you would like people to be able to mail-download. [ .html + .txt are the most popular types to offer for download ] - When .html is checked, it also allows .htm + .shtml files to be offered for download. Maximum Log - Type the number [from 10-100] of how many downloads you would like to keep a log of. DATA PREF --------- Data (LOG) File - The full location of ms-data.ais on your server. e.g 'data/ms-data.ais' Download Directory - This is the full location of the directory which you are placing all the files to offer for mail-download. e.g '/usr/home/cougasoft.org/html/download' Mail Program - This script requires [SENDMAIL] Type in the full location. e.g. /usr/sbin/sendmail If you don't know where it is you can either :- 1. Type -[ which sendmail ]- on the telnet screen. 2. E-mail admin and ask where sendmail is located. # ########## ---------------------- ############################################################# # ########## - EXIT(0) ------------ ############################################################# #