About TemplateMailer :: Try / Purchase :: Support :: Company Information :: Feedback

CONFIGURATION

Configuration File
The TemplateMailer configuration file "config.xml" provides the global settings used by the TemplateMailer system. By default this file is located in the root folder where the SendTemplateMail.aspx and other web pages which are to use the TemplateMailer system are located. However alternative locations can be specified within the ServerControl or "_ConfigFile" hidden form fields. Without the present of the config.xml file and if the first NodeElement is not the with a valid key, the TemplateMailer will not function.

The TemplateMailer config.xml file should be formatted as follows :

<?xml version="1.0" encoding="utf-8" ?>
<root>
<ConfigValues>
<LicenseKey></LicenseKey>
<AllowAltMailServer>false</AllowAltMailServer>
<AllowHTMLTags>true</AllowHTMLTags>
<AllowedRecipients>*@templatemailer.com</AllowedRecipients>
<AllowByPassRecipientList>false</AllowByPassRecipientList>
<txtTemplate>emailtemplates/test.txt</txtTemplate>
<htmlTemplate></htmlTemplate>
<ThankYouTemplate>emailtemplates/test.txt</ThankYouTemplate>
<MailServer>localhost</MailServer>
<SecondaryMailServer>localhost</SecondaryMailServer>
<TeriaryMailServer>localhost</TeriaryMailServer>
<MailPort>25</MailPort>
<SenderEmail></SenderEmail>
<RecipientEmail></RecipientEmail>
<unAuthorizedURL>http://www.disney.com</unAuthorizedURL>
<SendAutoResponse>false</SendAutoResponse>
<SendHTML>false</SendHTML>
<Referrers>localhost, templatemailer.com, www.templatemailer.com</Referrers>
<dsn>SAVED FOR FUTURE USE</dsn>
</ConfigValues>
</root>

NodeElement Definitions

LicenseKey The license key provided with your trial or purchase of TemplateMailer.
AllowAltMailServer This boolean (true/false) will allow the option to change the default email server at either design time or through hidden form fields. If set to false, no changes to the mailserver is allowed.
AllowHTMLTags This boolean (true/false) will allow the option to pass information to the TemplateMailer system by way of standard GET/POST HTML fields, hidden or otherwise. For the TemplateMailer WebDelivery service to function, this must be set to true.
AllowedRecipients For added security besides checking the referring url for authorization to use the TemplateMailer system, only those recipients listed within the AllowedRecipients field can have emails delivered to them. Addresses marked with the wildcard "*" will deliver to all addresses within the specified domain. e.g. *@templatemailer.com. NOTE. For .NET developers using the TemplateMailer server control, all addressed placed within the Properties for RecipientEmail, CCEmail and BCCEmail are automatically added to this authorized list.
AllowByPassRecipientList This boolean (true/false) will allow the TemplateMailer to bypass the list of allowed recipient domains specified in the CONFIG.XML file. Warning, by setting this to TRUE can allow this to send to any recipient and open your TemplateMailer to potential spam attacks. It is recommended that this feature be turned on dynamically within your code behind, review the TemplateMailer web site for more details.
txtTemplate This is the location of the template to be used when processing the TEXT email message. This field may be overridden at design time or through hidden form fields. If this field is not provided at any of the three staged (config.xml, design time, hidden form field) the a default template is created by TemplateMailer to send a sorted Fieldname : Fieldvalue of all form fields that do not begin with "_" as the field name. The file path to the file must be defined as a relative path from the config.xml file.
htmlTemplate This is the location of the template to be used when processing the HTML email message. This field may be overridden at design time or through hidden form fields. If the "SendHTML" setting is set to false, no HTML message regardless if the template is provided will be sent. The file path to the file must be defined as a relative path from the config.xml file.
ThankYouTemplate This is the location of the template to be used when processing the returning Thank You message. This template should be a well-formed HTML document as it will be sent back to the web browser. This field may be overridden at design time or through hidden form fields. If the "_redirectURL" field is provided at design time or through hidden form fields this template will not be displayed. The file path to the file must be defined as a relative path from the config.xml file.
MailServer This is the IP or URL of the mail server to send email messages through. Be sure to confirm this server has relay capabilities. If the server requires SMTP authentication refer to the ADVANCED METHODS section of this document for more details. If AllowAltMailServer is set to "true" this can be overridden at design time or through hidden form fields.
SecondaryMailServer This is the IP or URL of the secondary mail server to send email messages through. This is used in the event the primary MailServer fails to respond. Be sure to confirm this server has relay capabilities. If the server requires SMTP authentication refer to the ADVANCED METHODS section of this document for more details. If AllowAltMailServer is set to "true" this can be overridden at design time or through hidden form fields.
TertiaryMailServer This is the IP or URL of the tertiary mail server to send email messages through. This is used in the event the primary and secondary MailServers fails to respond. Be sure to confirm this server has relay capabilities. If the server requires SMTP authentication refer to the ADVANCED METHODS section of this document for more details. If AllowAltMailServer is set to "true" this can be overridden at design time or through hidden form fields.
MailPort This will set the port used to connect to the SMTP server. The default setting is 25.
SenderEmail This is the default sender's email address for all email messages. This field may be overridden at design time or through hidden form fields.
RecipientEmail This is the default recipient's email address for all email messages. This field may be overridden at design time or through hidden form fields.
unAuthorizedURL This is the URL to redirect unauthorized browsers who attempt to use and process the TemplateMailer system.
SendAutoResponse This global setting will turn on or off the ability to send AutoResponse messages regardless if the AutoResponse information is provided. This can not be overridden at design time or through hidden fields.
SendHTML This boolean (true/false) will allow the restriction of sending HTML messages. If set to true, no HTML messages will be sent. This field may be overridden at design time or through hidden form fields.
Referrers This is the list of available URL's which can process and send mail messages through the TemplateMailer system. By default, localhost and 127.0.0.1 are included.
dsn This is saved for future usage.


Copyright 2001 - 2017
Tectonic Concepts, LLC, All Rights Reserved