Customers of our previous products frequently asked, "How can I gather more information from my visitors when they send an inquiry about a listing on my site?"
For instance, the "f-email.asp" page provides a form in which the registrant must provide their name, email address, and a message. However, many businesses would like to harvest more information from people as they inquire about a listing. For example:
There are many questions that may be pertinent to your business model or marketplace that are not currently included in the standard email form in 20/20 DataShed.
The f-email_UserDefinedForm.inc provides you the ability to add your own form elements to the email form. The information may then be sent to the listing agent's email address -- what is done with the information after that is entirely up to your imagination.
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).
This file does not require internal security measures.
Security Warning: This file, as it has a *.inc file extension and is written in plain text, should not contain sensitive information. If you write ASP or VBScript code in this file and perhaps connect to a database or contain connection strings, passwords, or other sensitive information, you should be aware that visitors of your web site may be able to view the entire contents of this file in their web browser. For this reason, we encourage you to not add any sensitive or confidential information to this file. We recommend that this file simply contain form elements and/or relevant text.This file does not require maintenance. However, if you have altered the file from its original state then you may want to keep a local or backup copy.
This file is included in "f-email.asp" (via SSI [Server-Side Includes]) immediately before the "Submit" button in the email form. As such, any form elements or content written in this file will appear at the end of the current input boxes and before the submit button.
Any user input gathered from form elements that you add to the page can then be included in an email message to the listing agent or administrator. This behaviour is controlled in the email_inquiry_template.html file found in the templates folder.
For advanced users/customers who have experience with ASP and/or VBScript, it's relevant to point out that this file can contain VBScript and ASP code. Any ASP or VBScript script blocks within this file will be processed normally.
Note: You should not use <form></form> tags in the HTML code in this file. This file is included in the f-email.asp file after the current form elements and before the "submit" button; thus, the contents are already contained within a <form>.
There are two possible uses for this file:
To add a simple form element to this file:
Do you own a house? <input type="checkbox" name="Owns a House"><br />
Is it "little"? <input type="radio" name="A Little House" value="Yes"> Yes <input type="radio" name="A Little House" value="No"> No<br />
Is it on the prairie? <input type="text" name="On the Prairie">
The output of this HTML code is:
Do you own a house?
Is it "little"? Yes No
Is it on the prairie?
Remember, these elements will appear on the newuser.asp page will appear to be part of the registration form. So while the example above is functional it doesn't look pretty -- we would recommend that you carefully organize your form elements into a nicely formatted table or <div>.
The next step is to receive the user's input. This is discussed further in email_inquiry_template.html.
If you must access this file using another product or software, 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.