# $ # $ (Cougalist version 5.1) # $ # $ The main thing about version 5 is its free ! I temporarily tested it as kind of # $ a donation ware type program but as I already know, most people don't like paying # $ for things so I thought, whats the point (and took the license away). # $ The script is still not allowed to be used to make a profit from but you can use # $ it where ever you want, if you would like to make a donation... even better ;) # $ # $ This code is distributed in the hope that is will be useful but WITHOUT ANY # $ WARRANTY. ALL WARRANTIES, EXPRESSED 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: 5.1 # $ $Author: Paul Williams # $ $Email: paul@rainbow.nwnet.co.uk # $ $URL: http://www.cougasoft.org/ # $ $Created: 21/11/1996 13:06 # $ $Last Modified: 01/04/2000 18:15 # $ # $ Copyright 1996, 1997, 1998, 1999, 2000 Cougasoft. All rights reserved. # $ What's new in version 5.0 - For a start the script is taken out of the trial ware status. - Added $SPEED variable and $CHECK_MAILPROG variables at the top of the scripts. - Help for each option now viewable in real time via the script. - New REGEXP search capability for the user database. - Admin limits user results to a specific number and allows data scrolling. This could be a little buggy because I gave it a complete over haul so email me please if you find any problems, on the other hand, also send me a quick email if you would like to see additional features. Ok, you should of recieved the following files to get this script up and running :- 1. cougalist.cgi 2. cml-admin.cgi 3. cml-data.ais 4. cml-pref.pref 5. readme.txt 6. cougalist.gif If you don't have all these please go back to - http://www.cougasoft.org/ README CONTENTS --------------- 1. Installation ------- Change perl location(s) ------- Upload + Chmod 2. Administration Overview ------- Preferences ------- Users () ------- Send Mail ------- Layout Pref 3. Wish List ------- A few things I would like 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. Paul Install option has been taken away, if you email me really nicely with your ftp server, username & password I might install / check a script for you but I have recently been abused by people taking advantage of my kind offer. 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/perl ]- to the path your perl interpreter is located on your server. The most common location is as its set at the moment but some servers I have been on have perl located at #!/usr/local/bin/perl. ---- Please do this for cougalist.cgi & cml-admin.cgi If you don't know where it is you can either :- 1. Type -[ which perl ]- on the telnet screen. 2. E-mail administration and ask where perl is located. 3. If you are admin, go rent a movie ! ;) # # $-------------------------------------------------------------------------------------------- # # U P L O A D I N G - S C R I P T S # # $-------------------------------------------------------------------------------------------- # Upload the following files:- No. Script|GIF Where Chmod to ---- ---------- ----- -------- 1. cougalist.cgi /cgi-bin/ 755 2. cml-admin.cgi /cgi-bin/ 755 3. cml-data.ais /cgi-bin/data/ 666 4. cml-pref.pref /cgi-bin/data/ 666 5. cougalist.gif /imx/ - NOTE: - Make sure your CGI-BIN is chmodded to 731 (not necessary) - 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 (recommended) or place it - in the same directory as the script. Either way the script - will still work the same ;) When uploading graphics do not upload them into your cgi directory (unless you know they will work inside it) or any of its subdirectories because some cgi dirs treat files with any extension as CGI files. [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 cougalinks.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 :) # # $-------------------------------------------------------------------------------------------- # # A D D I T I O N A L - I N F O # # $-------------------------------------------------------------------------------------------- # NOTE: Once these stages have been completed correctly the script should work ! Now, go to administration [cl-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 ;) # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, P R E F E R E N C E S # # $-------------------------------------------------------------------------------------------- # If you would like more information on each of the preferences, in the tables, each option which has help information also has a link. I believe each option which warrants further information has been covered but if there is one missing please let me know. # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, U S E R S # # $-------------------------------------------------------------------------------------------- # Use this to browse or delete any of the users added to your database. To delete a user just check the checkbox next to the user(s) you would like to delete and press the delete button. You will notice the new search feature here, what you type in the search box must be in the form of a regular expression (If you don't know what they are do a search on the internet for more information as it goes beyond the scope of this readme). So remember to escape RE special characters. Example RE searches: # To find all email addresses with a net suffix \.net$ # Find any users who's name begin with 'N', 'B' or 'C' ^(N|B|C) # Find users whos name begins with 'C' or 'D' and ends with 'S' or 'N' # will match like: Chris, colin, dan etc... ^(C|D).*(S|N)$ # Just users who have 'jim' anywhere jim Like the last example search, you can still use normal words to search users so you can still perform accurate searches without the aid of regular expressions (but if you do know how to use regular expressions the power is there for you to exploit). # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, S E N D M A I L # # $-------------------------------------------------------------------------------------------- # This is the part that does the business, fill in the subject and write the message you would like to send. You should stick within the boundaries of the main text area because it is the right size to stop email clients (like netscape etc...) from word wrapping the email making it look extremely cock eyed. Before you send your mail to everyone on your list you can check the 'send test' button which will email you a copy of the mail as it stands and exit (so it only sends a copy to you). All you then have to do if you are happy with the spelling mistakes etc... is press back on the browser button, un check 'send test' and re submit the form. -- When you press the "send-email" button it will start sending the email's out to all your users, a screen will not return until all the e-mails have been sent, if you have a few it will seem to time out but have no fear, its still sending them :) I am working on either a faster way or a quick fix for this, I may use nph- to get the screen back as fast as possible. Watch out !!!! # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, P R E F E R E N C E S # # $-------------------------------------------------------------------------------------------- # If you would like more information on each of the preferences, in the tables, each option which has help information also has a link. I believe each option which warrants further information has been covered but if there is one missing please let me know. # # $-------------------------------------------------------------------------------------------- # # W I S H - L I S T # # $-------------------------------------------------------------------------------------------- # As I have a collection of CGI scripts with more in the works I am always looking for contributions so I put together my wish list. If you can help me out with anything I would love to hear from you; Computers; As I program in a few languages I need to test my free programs on different Os's so I am looking for complete computer donations, esp. NT, LINUX and BSD and any other type of OS would be a big plus. Web Space; As some multi user versions of my scripts are nearing completion I will soon be requiring some free web space with the following: at least 50MB, telnet access, access to a C compiler (GCC Preferably), mSQL, perl5, *NIX OS, and any other bells and whistles you care to mention :) Dedicated Internet Line; I think this one is a long shot but if there is anyone out there who could sort me out with a dedicated internet connection that would be excellent, after 3 years of programming CGI scripts on the internet my modem is just not doing the trick, recently I had been looking at getting a cable modem but after the initial tests my cable company decided to pull the plug on it. Other stuff I've been looking for; FILM: The black caldron, I have never seen this cartoon yet and also can't seem to find it anywhere. Pool table Dart board - You have to take your aggression out somehow. Aston Martin Vantage - I just had to try that one. Anything to do with the Simpsons :) # # $-------------------------------------------------------------------------------------------- # =========================================================================================== # $-------------------------------------------------------------------------------------------- #