gypsymail.py is a Python clone of the cgiemail form mail script Copyright (C) 2001 Sheila King 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, version 2 of the License. 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; It is in the file gpl.txt. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. you can contact the author, Sheila King at: sheila@thinkspot.net For documenation and installation instructions, see the file: gypsydoc.html Contents of this distribution: ------------------------------ readme.txt (this file) gpl.txt (the GNU Public License: terms for use and distribution) gypsymail.py (the main script file) gypsyutils.py (helper functions for the main script) defaultconfig.txt (the configuration file - edit for your particular set up) gypsymail.err (the error log file) sample1.html (a sample html file-shows use of check boxes, radio buttons) sample1.txt (the text template that corresponds to sample1.html) sample2.html (a sample html file-shows use of required fields and text area) sample2.txt sample3.html (a sample html file-shows use of menu. mailing list form) sample3.txt sample4.html (a sample html file-shows use of confirmation fields) sample4.txt sample5.html (same as sample1, but with different success options) sample6.html (also the same as sample1, but yet other success options) config5.txt (config file for use with sample5.html) config6.txt (config file for use with sample6.html) successtemplate5.html (html success template for use with sample5.html) successtemplate6.html (html success template for use with sample6.html) Version history: version 0.7.1 beta - 2002.9.15 -implemented optional use of subdirectories under the /cgi-bin/templates directory, for organizational purposes. version 0.7.0 beta - 2002.3.10 -implemented templated success page options. -added documentation on the templated success pages -added samples to the distribution package, to demonstrate templated success pages. version 0.6.5 beta - 2002.3.8 (not publicly released) -added documentation (thanks to Jon Newell of Brisbane, Australia) on how to configure MicroSoft IIS servers to properly return the PATH_INFO environment variable required by the Gypsy Mail script. (This environment variable is switched off by default on IIS.) version 0.6.4 beta - 2002.3.2 (not publicly released) -implemented better error messages during script initialization -added optional debug logging options and statements to aid in diagnosing installation and configuration difficulties. -added comments on Windows file paths to documentation. version 0.6.3 beta - 2001.7.18 -corrected misleading and confusing directions in the various files, such as gypsydoc.html and defaultconfig.txt. -stripped out all occurences of CRLF (carriage-return/line-feed) in the entire message, including headers, to fix problems with Windows linefeeds vs. standard SMTP protocol (problem occured on display in Outlook Express). version 0.6.2 beta - 2001.7.17 -Partially implemented custom success page. Script can now redirect to any desired URL on the success page. version 0.6.0 beta - 2001.5.28 -Wrote an html document file instead of the help.txt file. Much more extensive documentation. -Changed the way that a field is exempted from a check for headers inserted by a hacker. Removed the previous noverify tag from the form field names. Now this is handled by putting an additional line in the config file of the form values-FormFieldName = . -Added a confirm- option. Now two fields can both check for the same data and verify that the input matches (such as for confirming passwords, and the like). -Check for CRLF characters in the message body text and replaced them with LF characters, to prevent double line spacing in some situations. -Moved most configuration information from the main gypsymail.py file to a separate configuration file. This allows for the main script to run different forms with different configuration options. -Moved many of the functions used by the main script to a separate file, gypsyutils.py. version 0.5.5 beta - 2001.5.15 - fixed dependency on the REQUEST_URI environment variable, which may not be set in some cases. This was used in the message header of the e-mail for the X-Mailer field. Replaced with a combination of SERVER_NAME, SCRIPT_NAME, and PATH_INFO. version 0.5.4 beta - 2001.4.21 - fixed log error routines related to the PATH_INFO environment variable. If the wrong path variables are entered, and the script cannot find the template file specified (or if no template file is specified), returns an error message without crashing the script (avoids 500 Internal Server Error) version 0.5.3 beta - 2001.4.21 -first public release. End of readme.txt