Attachment Folder

You should decide where on your site you wish to have the attachments stored. Do not place this inside of the system temporary folder as your system probably wipes this from time to time. Attachments will be stored under this folder in a sub folder with the ID number of the email in the database. You will be able to see this ID number in the JMailQ listing in the admin. Inside this directory will be another folder for each attachment, numbered 0 through n, one for each attachment.


Count by Recipient (No/Yes)

Should JMailQ count an email as a single send without regard to the number of recipients (No), or count an email send for each recipient (Yes). Recipients are those email addresses listed in the TO, CC and BCC fields.


Send By Recipient (No/Yes)

Normally when an email is sent, a connection is made to the SMTP server and a list of all recipients is sent to it, and then the email itself is sent. When hosting companies count email sends by recipient it is not possible to ensure we stay under their limits when we send an email in this normal manner. By selecting Yes to this option JMailQ will create a separate email send connection for each recipient. JMailQ can then follow the configured send limits for hosting companies who count in this manner. Note: JMailQ does not actually duplicate the email in the database for each recipient, it simply keeps track of which recipients it has already sent to.


Max Execution Time (50)

This is the maximum amount of time, in seconds, to spend processing the email queue per delivery run. There is no real limit on this, but, it should be less than the delivery interval set in your Cron task. See the section on the Delivery Script for more details. If a second delivery run somehow starts before a previous run has finished, the delivery system checks a lock and if the lock is set the second task will immediately return. When processing Spam Checks during delivery the execution time includes the time interval for this process which can be in up to 5 seconds per email. You should factor this into this maximum execution time setting.


Delivery Interval (10)

The Delivery Interval is the amount of time, in milliseconds, to wait between each email send. This allows you to be friendly to SMTP servers. Some SMTP servers will consider a sender as a spammer if too many emails are sent within a short period of time. You should balance this number with the Max Batch Size and Max Execution Time values.


Max Batch Size(1000)

The maximum number of emails sent, based on the Count By Recipient setting, that the delivery script will send in any one delivery run. A setting of zero means no maximum.


Max Per Minute/Hour/Day (1000)

Sets a limit on the maximum number of emails to send during the defined period. A value of zero means no limit for that period. Tune these values based on your hosting providers restrictions.


Maximum Send Retries (3)

In the event a send fails for some reason, rejected by the receiving SMTP server for example, this is the number of times the system will attempt to retry the send before marking a permanent failure.


Purge After Days (3)

This is the number of days of email that the system will retain in the database. Older emails and their attachments will be purged after this time period.