Setting Up Your Emailworks Maillist Manager

From Emailworks Wiki / Documentation

Once installation of Emailworks Maillist Manager is completed on your server, it's time to login to Administrator Area and setup preferences based on your needs.

You can login to your Administrator Area by opening your web browser and entering the following URL:

http://yoursite.com/Emailworks/admin/

Emailworks Maillist Manager will request administrator login information from you. Please enter your administrator account username and password to continue. If human image verification system enabled (it's enabled by default), you will be asked to verify the image shown:

Once you are successfully logged into Administrator Area, you will see the main menu on the top:

Move your mouse over "Settings" menu. A sub-menu will be shown to you which contains different setting categories:

Account Information

This section allows you to update your administrator account information:

First Name
Last Name
Username
Password

Email Settings

This is the section where you setup how to handle email delivery, bounce tracking, SPAM complaint handling or load balancing.

You will see 6 tabs on the top:

Email Addresses
Bounce Settings
Load Balancing
Email Sending
Spam Complaints
Request By Email

Email Address

In this tab, you set the email addresses that will be used for notifying about system events:

System Email From Name: Enter the name that will be shown in "from" field of every outgoing email for users and administrator
System Email From Email Address: Enter the email address that will be shown in "from" field of every outgoing email for users and administrators
System Email Reply To Name: Enter the name that will be shown in "reply-to" field of every outgoing email for users and administrator
System Email Reply To Email Address: Enter the email address that will be shown in "reply-to" field of every outgoing email for users and administrators
Send Alerts To: Enter the email address where system notification emails should be sent to

Bounce Settings

This section allows you to setup bounce handling for your email campaigns. This is a very important procedure because it will keep your subscriber lists clean and up-to-date by monitoring delivery reports against invalid email addresses.

Catch-All Email Address Domain: Emailworks Maillist Manager uses proven VERP technique to identify bounces with the highest accuracy rate. Therefore, every outgoing email in Emailworks Maillist Manager is "signed" with a special return-path email address that are specific to every user, recipient, campaign and list. Enter the domain where you will be using for bounce handling in this field. Please note that catch-all email setting must enabled and pointed to an email address for this domain. An example domain is: yoursite.com
Soft To Hard Bounce Threshold: Enter the threshold level to mark soft bounced email addresses as hard bounced. Emailworks Maillist Manager will set bounce level to hard bounced after the defined amount of soft bounce detection for a specific email address.
Process Type: You can track bounced email addresses in two ways: Setting up an email piping or POP3 email box. Select the one you prefer. For more information about setting up your bounce handling, please refer to "Setting Up Email Processing For Bounce, SPAM Complaint and Subscriber Request Handling"

If you have chosen POP3 processing type in "Process Type" field, Emailworks Maillist Manager will ask for POP3 connection parameters:

POP3 Server Host: Enter the host of your POP3 server. Example: mail.yoursite.com
POP3 Server Port: Enter the port where your POP3 server is running. Default port number for POP3 server is 110
POP3 Username: Enter username of your POP3 email address
POP3 Password: Enter password of your POP3 email address

If you are having problems about setting up bounce handling, don't hesitate to contact us. We will be happy to assist you.

Load Balancing

If you are hosting Emailworks Maillist Manager on a limited server environment, you can enable Load Balancing feature to slow-down the email delivery.

Enable Load Balancing feature and enter the following information to set your load balancing feature:

Emails To Send: Enter the number of emails to send every period. Example: 500
Seconds To Wait: Enter the number of seconds to wait (sleep) between every period. Example: 60

Based on the example written above, your Emailworks Maillist Manager will send 500 emails every period and wait for 60 seconds between every period.

If you are not having email sending problems on your server, disable this feature to maximize your email sending speed.

Email Sending

This section defines the method to send your emails. You should set email sending settings based on your server configuration. You may contact your hosting provider to learn more about your mail server capabilities and limits.

Sending Methods:

SMTP
Local MTA
PHP Mail Function
PowerMTA
Save To Disk

SMTP

If MTA that you are going to use for email delivery is hosted on a remote server, this method will be the right choice. Once you select SMTP method from the list, Emailworks Maillist Manager will ask for SMTP connection parameters. If you don't have a MTA for sending mass emails, you may consider using a third party reliable SMTP service such as SMTP.com service. Emailworks Maillist Manager has a built-in support for SMTP.com service.

Host Address: Enter the address of your SMTP server. It can be an IP address or a domain
Port: Enter the port for the connection. Default SMTP port is 25
Security: Select the security which your SMTP server uses. If your SMTP server accepts plain connection, just select the empty option
Timeout: Enter the time out in seconds to set how long Emailworks Maillist Manager should wait to receive a response from your SMTP server. 10 seconds will be okay for most settings.
Authentication: If your SMTP server requires username/password authentication, enable this option

If you enable SMTP authentication, Emailworks Maillist Manager will ask for your SMTP access username and password:

Username: Enter the username for logging into your SMTP server
Password: Enter the password for logging into your SMTP server

X-Mailer Header