CGI Email - Revision history

Wesley at 20:58, 3 December 2012

2012-12-03T20:58:23Z

← Older revision		Revision as of 14:58, 3 December 2012
Line 72:		Line 72:
	{{footer}}		{{footer}}
	[[Category:Hosting Archives\|CGI Email]]		[[Category:Hosting Archives\|CGI Email]]
			tag cgiemail

Jorgen at 21:31, 3 November 2011

2011-11-03T21:31:48Z

← Older revision		Revision as of 15:31, 3 November 2011
Line 18:		Line 18:
	<p>Please fill out the form below.</p>		<p>Please fill out the form below.</p>
	<hr>		<hr>
	<form method="POST" action="http://~~www~~.xmission.com/cgi-bin/cgiemail/~username/mail.txt">		<form method="POST" action="http://user.xmission.com/cgi-bin/cgiemail/~username/mail.txt">
	Your Name: <input type="text" name="name" size="50"><br>		Your Name: <input type="text" name="name" size="50"><br>
	E-Mail Address: <input type="text" name="required-email" size="50"><br>		E-Mail Address: <input type="text" name="required-email" size="50"><br>
Line 34:		Line 34:


	In red, you will see the <form> tag. The method will be post, and the action will be your template message through our cgi-email script. The syntax shown in the form tag above should be followed exactly. You will, of course, replace "acctname" with your XMission account name, and mail.txt with the location and name of your template message. Your template message must be located in your public_html directory or a sub-directory within it. To show an example of a variation, the XMission username will be "web", the template message will be located in the public_html/contact/ directory, and it will be named "order.txt". <pre><form method="POST" action="http://~~www~~.xmission.com/cgi-bin/cgiemail/~web/contact/order.txt"></pre>		In red, you will see the <form> tag. The method will be post, and the action will be your template message through our cgi-email script. The syntax shown in the form tag above should be followed exactly. You will, of course, replace "acctname" with your XMission account name, and mail.txt with the location and name of your template message. Your template message must be located in your public_html directory or a sub-directory within it. To show an example of a variation, the XMission username will be "web", the template message will be located in the public_html/contact/ directory, and it will be named "order.txt". <pre><form method="POST" action="http://user.xmission.com/cgi-bin/cgiemail/~web/contact/order.txt"></pre>

	A notable bonus of using cgi-email is shown above in green. You can make a field required by preceding its name with "required-". XMission recommends that you make the email address a required field. The reason being, if you reply to your form and there is no email address present, your reply will automatically be sent to XMission's webmaster instead of the intended recipient.		A notable bonus of using cgi-email is shown above in green. You can make a field required by preceding its name with "required-". XMission recommends that you make the email address a required field. The reason being, if you reply to your form and there is no email address present, your reply will automatically be sent to XMission's webmaster instead of the intended recipient.

Dapper: /* Introduction */

2009-10-01T21:47:45Z

Introduction

← Older revision		Revision as of 15:47, 1 October 2009
Line 3:		Line 3:

	<div class="messagebox metadata">'''Note''': These instructions assume you are familiar with basic HTML and fill-out forms. You should also note that all file names and form fields are case sensitive. XMission uses a CGI tool called cgi-email to generate email from a fill-out form page without the need for a separate email client (which would be needed with a <a href=mailto:acctname@xmission.com> tag). To configure your own email form, you need to create a form with the appropriate "action" URL and create a template email message. These steps are outlined in detail below.</div>		<div class="messagebox metadata">'''Note''': These instructions assume you are familiar with basic HTML and fill-out forms. You should also note that all file names and form fields are case sensitive. XMission uses a CGI tool called cgi-email to generate email from a fill-out form page without the need for a separate email client (which would be needed with a <a href=mailto:acctname@xmission.com> tag). To configure your own email form, you need to create a form with the appropriate "action" URL and create a template email message. These steps are outlined in detail below.</div>

	For easy reference and comparison, XMission creates a simple email form in your public_html directory when your account is activated. The files are mail.html (the fill-out form) and mail.txt (the template message). You may choose to modify these to fit your needs or just view their structures to better understand how you will need to create your own.

	For more details about CGI Email, or to learn how to set it up on your own server, refer to [http://web.mit.edu/wwwdev/cgiemail/ MIT's CGI Email] help pages.		For more details about CGI Email, or to learn how to set it up on your own server, refer to [http://web.mit.edu/wwwdev/cgiemail/ MIT's CGI Email] help pages.

Mfrazier: /* Creating the Template Message */

2008-03-25T16:38:11Z

Creating the Template Message

← Older revision		Revision as of 10:38, 25 March 2008
Line 47:		Line 47:
	The format of the template after the header lines is up to you. The only thing you must have is the names of the form fields in brackets. Below is an example of a text template to go with the form above. You may also review your mail.txt file.		The format of the template after the header lines is up to you. The only thing you must have is the names of the form fields in brackets. Below is an example of a text template to go with the form above. You may also review your mail.txt file.

	<~~nowiki~~><~~pre~~>		<pre><nowiki>
	To: John Doe <username@xmission.com>		To: John Doe <username@xmission.com>
	From: [name] <[required-email]>		From: [name] <[required-email]>
Line 58:		Line 58:
	Comments or Request:		Comments or Request:
	[content]		[content]
	</~~pre~~></~~nowiki~~>		</nowiki></pre>

	You would, of course, replace "John Doe" with the name of the person or department that the email message is being sent to, and "username@xmission.com" with the destination email address.		You would, of course, replace "John Doe" with the name of the person or department that the email message is being sent to, and "username@xmission.com" with the destination email address.

Mfrazier: /* Creating the Template Message */

2008-03-25T16:36:38Z

Creating the Template Message

← Older revision		Revision as of 10:36, 25 March 2008
Line 47:		Line 47:
	The format of the template after the header lines is up to you. The only thing you must have is the names of the form fields in brackets. Below is an example of a text template to go with the form above. You may also review your mail.txt file.		The format of the template after the header lines is up to you. The only thing you must have is the names of the form fields in brackets. Below is an example of a text template to go with the form above. You may also review your mail.txt file.

	<pre>		<nowiki><pre>
	To: John Doe <username@xmission.com>		To: John Doe <username@xmission.com>
	From: name <required-email>		From: [name] <[required-email]>
	Reply-to: required-email		Reply-to: [required-email]
	Subject: subject		Subject: [subject]

	Sender's Name: name		Sender's Name: [name]
	Email Address: required-email		Email Address: [required-email]

	Comments or Request:		Comments or Request:
	content		[content]
	</pre>		</pre></nowiki>

	You would, of course, replace "John Doe" with the name of the person or department that the email message is being sent to, and "username@xmission.com" with the destination email address.		You would, of course, replace "John Doe" with the name of the person or department that the email message is being sent to, and "username@xmission.com" with the destination email address.


	==Adding a "success" Page==		==Adding a "success" Page==

Mfrazier at 21:49, 18 March 2008

2008-03-18T21:49:39Z

← Older revision		Revision as of 15:49, 18 March 2008
Line 1:		Line 1:
			{{archived}}
	==Introduction==		==Introduction==

Line 70:		Line 71:

	Unlike the other form fields, you cannot change the name of the "success" field. It must be named "success" for it to work properly. The value is the URL of the success page that you want to appear after the sender has successfully completed and submitted the form. The example above will show the file named "successpage.html" in acctname's public_html directory. The success page value must be a fully-qualified URL, so you may want to be sure it works in a browser first.		Unlike the other form fields, you cannot change the name of the "success" field. It must be named "success" for it to work properly. The value is the URL of the success page that you want to appear after the sender has successfully completed and submitted the form. The example above will show the file named "successpage.html" in acctname's public_html directory. The success page value must be a fully-qualified URL, so you may want to be sure it works in a browser first.


			{{footer}}
			[[Category:Hosting Archives\|CGI Email]]

Mfrazier: Hosting Archive:CGI Email moved to Hosting Archives:CGI Email

2008-03-07T23:59:28Z

Hosting Archive:CGI Email moved to Hosting Archives:CGI Email

← Older revision		Revision as of 17:59, 7 March 2008
(No difference)

Mfrazier: CGI Email moved to Hosting Archive:CGI Email

2008-03-07T23:54:09Z

CGI Email moved to Hosting Archive:CGI Email

← Older revision		Revision as of 17:54, 7 March 2008
(No difference)

Mfrazier: CGIemail moved to CGI Email

2008-02-28T01:10:46Z

CGIemail moved to CGI Email

← Older revision		Revision as of 19:10, 27 February 2008
(No difference)

Deadguy: new page

2007-07-29T00:56:28Z

new page

New page

==Introduction==

<div class="messagebox metadata">'''Note''': These instructions assume you are familiar with basic HTML and fill-out forms. You should also note that all file names and form fields are case sensitive. XMission uses a CGI tool called cgi-email to generate email from a fill-out form page without the need for a separate email client (which would be needed with a <a href=mailto:acctname@xmission.com> tag). To configure your own email form, you need to create a form with the appropriate "action" URL and create a template email message. These steps are outlined in detail below.</div>

For easy reference and comparison, XMission creates a simple email form in your public_html directory when your account is activated. The files are mail.html (the fill-out form) and mail.txt (the template message). You may choose to modify these to fit your needs or just view their structures to better understand how you will need to create your own.

For more details about CGI Email, or to learn how to set it up on your own server, refer to [http://web.mit.edu/wwwdev/cgiemail/ MIT's CGI Email] help pages.

==Creating the Form==

When you create your form, there are two main things you will need to do. The first is to be certain that all the form fields have a unique name. The second is to properly set the <form> tag. Any standard form entries may be used (such as radio buttons, check boxes, pull-down select menus, etc.). Below is a short example of a proper form, but you may also review your mail.html.

<pre>
<html>
<head>
<title>John Doe's Email Form</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<p>Please fill out the form below.</p>
<hr>
<form method="POST" action="http://www.xmission.com/cgi-bin/cgiemail/~username/mail.txt">
Your Name: <input type="text" name="name" size="50"><br>
E-Mail Address: <input type="text" name="required-email" size="50"><br>
Subject: <input type="text" name="subject" size="50"><Br>
<Br>
Message / Request: <Br>
<textarea name="content" rows=10 cols=66></textarea>
<Br>
<input type="submit" value="Send" name="submit">
<input type="reset" value="Clear" name="reset">
</form>
</body>
</html>
</pre>

In red, you will see the <form> tag. The method will be post, and the action will be your template message through our cgi-email script. The syntax shown in the form tag above should be followed exactly. You will, of course, replace "acctname" with your XMission account name, and mail.txt with the location and name of your template message. Your template message must be located in your public_html directory or a sub-directory within it. To show an example of a variation, the XMission username will be "web", the template message will be located in the public_html/contact/ directory, and it will be named "order.txt". <pre><form method="POST" action="http://www.xmission.com/cgi-bin/cgiemail/~web/contact/order.txt"></pre>

A notable bonus of using cgi-email is shown above in green. You can make a field required by preceding its name with "required-". XMission recommends that you make the email address a required field. The reason being, if you reply to your form and there is no email address present, your reply will automatically be sent to XMission's webmaster instead of the intended recipient.

==Creating the Template Message==

The template message is the email message that will be sent to you when the form is submitted. It's a simple text file in the format of an email message. Because cgi-email sends this text file as an email message, it must have the proper header fields to work properly and must not have any blank lines before the first field.

The format of the template after the header lines is up to you. The only thing you must have is the names of the form fields in brackets. Below is an example of a text template to go with the form above. You may also review your mail.txt file.

<pre>
To: John Doe <username@xmission.com>
From: name <required-email>
Reply-to: required-email
Subject: subject

Sender's Name: name
Email Address: required-email

Comments or Request:
content
</pre>

You would, of course, replace "John Doe" with the name of the person or department that the email message is being sent to, and "username@xmission.com" with the destination email address.

==Adding a "success" Page==

By default, there is a text confirmation page that notifies the sender that the email message was sent successfully. However, some XMission subscribers would like to replace it with a nicer HTML success page. This is easy with cgi-email.

You will need to open the HTML form and add a hidden form field. The syntax will look like the following example
<pre><input type="hidden" name="success" value="http://www.xmission.com/~acctname/successpage.html"></pre>

Unlike the other form fields, you cannot change the name of the "success" field. It must be named "success" for it to work properly. The value is the URL of the success page that you want to appear after the sender has successfully completed and submitted the form. The example above will show the file named "successpage.html" in acctname's public_html directory. The success page value must be a fully-qualified URL, so you may want to be sure it works in a browser first.