In this README: |
REQUIRES
SUMMARY
FEATURES
DISTRIBUTION / LICENSE
INSTALLATION
HOW TO USE
CHANGES
TODO
REQUIRES back to top |
1. web server (only tested on UNIX and LINUX) 2. Perl 5.00503 (may work with others)
SUMMARY back to top |
This multipurpose sign-up sheet will allow you to easily and quickly create a signup sheet for just about any event. A limit to the number of people allowed to sign up for each time slot can be specified. The data is stored in a plain text flat file database, so users can be removed by simply editing the file if it is ever needed. As with any of my scripts, I am always interested to see who is using and what modifications, if any, have been made. If you are willing, please send an email to me and tell me you are using my script so I can check it out!
FEATURES back to top |
Create as many open slots for signup as you want! Uses a template.html file to quickly make everything match your current site Simply ftp your stuff or use the web based manager Specify your own colors. Set limits as to how many people can sign up for a specific slot, or choose no limit. You choose whether or not other users view the schedule information. You choose whether or not users can sign up for multiple slots at a time.
DISTRIBUTION / LICENSE back to top |
This software is released under the GPL. Please see the included LICENSE file. Copyright (C) 2003 Erin Spiceland This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Use this script at your own risk! I make no warranties that it is hack proof!
INSTALLATION back to top |
Installation is easy: 1. put all of these files under your cgi-bin (or other executable web directory). 2. chmod 755 signup.cgi 3. If you did not copy over the blank data.dat file, then touch data.dat (so that it doesnt complain that no data file exists). 4. *optional* - chmod 666 data.dat (if your server does not execute CGI scripts as the user. Hopefully you wont have to do this for security reasons). 5. edit sitevariables.pl to match your needs NOTE: this is where you specify each slot you want the users to be able to choose from. 6. You may need to modify the first line of signup.cgi to point to where perl is located on your server. #!/usr/bin/perl (most common) #!/soft/script/bin/perl (for users in web.utk.edu/~username/cgi-bin/) 7. Now just point your browser at it! e.g.- http://www.fuzzymonkey.org/cgi-bin/signup.cgi. At my school under web.utk.edu users must use cgiwrap to use cgi on the account and must point to http://web.utk.edu/cgi-bin/cgiwrap/username/signup.cgi You may optionally put all of these files under a subdirectory.2. Configure My Signup Sheet
3. You're done!Edit sitevariables.pl to suit your needs. You will need to specify your preferences on colors, a font, a template, your confedentiality preferences, the information you want to get from your users, and all the different things, such as dates and times, your users can choose from.
Fire up your browser and point it at the signup.cgi script. Good Luck! Email me if you use it!
HOW TO USE back to top |
Just point your browser at it.
e.g.- http://www.yoursite.com/cgi-bin/signup.cgi
If you get an internal server error, run it from command line so that you can see what is going wrong. See my FAQ on my script page for more info.
CHANGES back to top |
07.12.2003 Version 2.1 Added the ability to allow users to make more than one choice at a time if desired.
02.01.2003 Version 2.0. Complete overhaul. The script was completly rewritten - none of the code is the original. Added features are the ability to choose whether or not your users see the schedule, templatability, ability to define what info you get from your users, and the ability to set a limit of infinity.
11.21.2001 First real README :)
TODO back to top |
I need to do/need help with the following itemsSend questions or comments to erin@fuzzymonkey.org Thanks, Mike and Erin SpiceAnything else you want me to add... just email me.