SMTP pophelp

[Bloke]

Improvements on these welcome. All featured on the prefs panel:

html_email: Email format
Email body text can either be sent as plaintext with linebreaks, HTML, or both. If both are chosen, compatible mail clients will render the best option based on user choices but the overall message size will increase.

[We may need to put some stuff in here about how to set up templates/forms for either system but the mechanism for doing that hasn't been decided yet, so we can defer adding this description until we've chosen the best way forward.]

enhanced_email: Use enhanced mail features
Enabling this option will reveal additional configuration options for routing email through external mail gateways. Setting it to No will use the built-in mail facility of your server, which may result in messages being undelivered or ending up in spam boxes.

smtp_host: SMTP host
Hostname of the email gateway that will be used to deliver email on behalf of Textpattern. Your chosen provider will supply this information: consult their documentation.

May be overridden by defining the SMTP_HOST constant in your config.php file.

smtp_port: SMTP port
Messages will be sent to the host gateway via this port. Common entries are 25 (for unsecured mail), and 587 for TLS/SSL. Your provider may have chosen a different port to bypass common mail blockers, so consult their documentation.

May be overridden by defining the SMTP_PORT constant in your config.php file.

smtp_user: SMTP user name
If you are required to authenticate to the host mail gateway, supply the username, email address or token supplied by your mail provider.

May be overridden by defining the SMTP_USER constant in your config.php file.

smtp_pass: SMTP password
Password for authenticating to the mail gateway, if required.

It is recommended to override this by defining the SMTP_PASS constant in your config.php file. This prevents the value being stored in the database where it may be more easily read/exported by other Textpattern users.

smtp_sectype: SMTP security method
Mechanism over which communication will take place between the server on which Textpattern is installed and the mail gateway. Your chosen provider will specify which option to use. Select the highest grade you can.

It is not recommended to use 'None' unless you are having connection/certificate issues or intercepting email from a localhost environment during site development. Some providers may insist on using 'none' for hosting plans that do not offer authentication for mail relaying.

May be overridden by defining the SMTP_SECTYPE constant in your config.php file. Valid values are ssl, tls or none.