email_newitem_template.html

What does this file do?

This file is used to produce the text and layout of an automated outgoing email message from 20/20 DataShed. This file may contain HTML and is used like stationary to produce dynamic email messages generated by 20/20 DataShed.

20/20 DataShed will send an automated notification the administrator of your web site when a new item is added to the database; that automated message can be customized using this template file, email_newitem_template.html.

Permissions and Security

Server

This file may inherit the permissions from its parent folder; but also requires that the IUSR_<localmachinename> (or equivalent) user account have NTFS permissions to read the file.

For comprehensive NTFS file and folder permission settings please see File/Folder Security (NTFS Permissions).

Internal

This file does not require internal security measures.

How to Maintain

This file does not require any maintenance. However if you have customized this file then we recommend you keep a local copy or backup copy of the revised/altered file.

Included In (Files)

The contents of this file are retrieved by the GetTemplateHTML() function in _globals.asp. This activity is not related to SSI, but rather the contents are retrieved as necessary using the Scripting.FileSystemObject object.

There is one page which utilizes this file:

• _Process_AddListing.asp

Inherits (Content)

This file inherits information from _globals.asp as necessary. Tokens can be included in the HTML code to produce dynamic content in the outgoing message. Not all tokens will have output in this context.

Other Features

This template can be disabled; this effectively disables the outgoing email notification for new items. More instructions are provided below.

How to Customize

This file is simply an HTML document and can be edited or created using any text or HTML editor. We recommend using a simple text editor such as NotePad, however WYSIWYG editors will work as well.

To make a simple change in the "email_newitem_template.html" file:

1. Access your web site with an FTP application such as CuteFTP, FTP Explorer, or Windows "My Network Places".
2. Download "email_newitem_template.html" from the templates folder of this application to your local computer.
3. Open "email_newitem_template.html" in a text editor such as Notepad.
4. In that file, locate the text or HTML code you wish to edit and make the change(s) you desire.
5. If you use a WYSIWYG editor, ensure that the editor did not add a title to the page. There should not be any text inside the <title> tag of the page.

   Example: <title></title>

   Email applications sometimes to unpredictable things with titles in HTML-formatted email messages.
6. Save the file.
7. Upload the file to your web site using the FTP application and overwrite the existing "email_newitem_template.html" file.
8. Reload the listings.asp, newuser.asp, or login.asp page and include the "?objApplication=RemoveAll" querystring in your URL to force 20/20 DataShed to flush out the old HTML template from the server's cache (and reload this new one).

   Example: http://www.your_domain.com/listings.asp?objApplication=RemoveAll

Important to Remember

• Although the "email_newitem_template.html" file resides in the templates folder, it will be viewed by email applications such as Outlook Express, Thunderbird, GMail, Yahoo, or Hotmail. Therefore it is best to use full URLs for all links and images so that all linkage will work from any location on the internet.
• The HTML in this file should be well-formed. A malformed file may cause errors.
• Some email applications are heavily monitored by anti-virus products and may reject email messages which contain script blocks, flash animation, or particular types (or sizes) of images. It is best to ensure that HTML-formatted email messages are modest and limited in functionality and size -- avoid using many images and avoid using client-side scripting technologies such as JavaScript.

How to Disable

If you want to "turn off" the automated email notification for new items then:

1. Access your web site with an FTP application such as CuteFTP, FTP Explorer, or Windows "My Network Places".
2. Download "email_newitem_template.html" from the templates folder of this application to your local computer.
3. Open "email_newitem_template.html" in a text editor such as Notepad.
4. Select the entire contents of the file and delete them.
5. Type one word:

   DISABLED

6. Save the file.
7. Upload the file to your web site using the FTP application and overwrite the existing "email_newitem_template.html" file.
8. Reload the listings.asp, newuser.asp, or login.asp page and include the "?objApplication=RemoveAll" querystring in your URL to force 20/20 DataShed to flush out the old HTML template from the server's cache (and reload this new one).

   Example: http://www.your_domain.com/listings.asp?objApplication=RemoveAll

Warning

If you must access this file using another product or software, then do so at your own risk; such activity is not supported by our license agreement and may void 20/20 Application's technical support obligations.

Send Feedback