Help for htmail v1.5About htmailhtmail is a generic forms-to-email gateway. With it, you can implement feedback forms and simple surveys that will be e-mailed to you. How to use htmail at the University of MichiganThis document assumes some familiarity with Navigating the World Wide Web and Creating and editing html documents in the U-M environment. This document further assumes that you have an IFS home directory and access to both a World Wide Web browser and a simple text editor.
As a security measure, htmail can only send e-mail to pre-enabled e-mail addresses. If you wish to use htmail, you must first send e-mail to webmaster@umich.edu and ask that your e-mail address be enabled for use with htmail. Note: htmail service is available only to U-M facutly, staff, students, and affiliates. Your e-mail address will be enabled for use with htmail within 2 days. When your e-mail address is enabled, you will receive an e-mail message which describes how to get started with htmail. Use your favorite web browser (i.e. Netscape, Internet Explorer, Mosaic, etc.) to open the URL: http://www.umich.edu/cgi-bin/htmail/e-mail@address where e-mail@address is replaced with the e-mail address you have just had enabled for use with htmail. Save the source of that document into an html form in your Public/html directory. Procedures for doing this vary from browser to browser, but typically there will be a "Document Source" choice under the "view" menu or something similar. Once you view the source of this page, save it as a new file in
your Public/html directory.
How to customize htmail at the University of MichiganIt is possible to make rather complex fill-in forms for use with htmail. Here is an example of a form which incorporates a number of more advanced features. To make complex forms such as this one, you need to know two things: how to create html forms, and what fields are available for use in the htmail cgi application. For a good description of the tags used to create html forms, please see the HTML Quick Reference. The fields that you may use in your htmail forms include:
You may use any other name for fields you create; these extra fields will be appended to the bottom of the e-mail message you receive.
How to get htmail to install at your own siteFor help, contact webmaster@umich.edu.
Using templates with htmailThis section of the documentation is not necessary to make a working form. Templates are intended to make htmail more flexible, but are not necessary. Using these templates, it is possible to format the e-mail message sent by your form in virtually any way you lake. This could be used to make the submitted form easier to add to a database program or simply to make the submitted form more attractive and readable.HTMail uses template files based on the Server Side Include (SSI) Standard. Mor information on SSIs is available from: http://www.umich.edu/faq.html To make the e-mail address of the user appear in your template, you would use the tag: <!--#echo var="from" -->Be very carefull that the variable names in your template file exactly match the form field names in your htmail form. This will ensure that the completed form will be passed along and sent to you in e-mail. Step By Step
CopyrightCopyright (C) 1996 by the Regents of the University of Michigan. User agrees to reproduce said copyright notice on all copies of the software made by the recipient. All Rights Reserved. Permission is hereby granted for the recipient to make copies and use this software for its own internal purposes only. Recipient of this software may not re-distribute this software outside of their own institution. Permission to market this software commercially, to include this product as part of a commercial product, or to make a derivative work for commercial purposes, is explicitly prohibited. All other uses are also prohibited unless authorized in writing by the Regents of the University of Michigan. This software is offered without warranty. The Regents of the University of Michigan disclaim all warranties, express or implied, including but not limited to the implied warranties of merchantability and fitness for any particular purpose. In no event shall the Regents of the University of Michigan be liable for loss or damage of any kind, including but not limited to incidental, indirect, consequential, or special damages. w e b s e r v i c e s @ u m i c h . e d u Page Last Modified: Tuesday, 28-Mar-2000 16:14:36
EST
|