Mail Settings

To set up your mail correctly please choose the protocol for sending e-mails. 

Choose Mail for your server's internal PHP mail function or SMTP to connect your external mail. 

Mail Protocol: Inner Mailer

Each shared hosting companies have its own spam or block e-mail rules. If you want to use PHP mail, you need to make sure that your server can send emails and it is configured properly. This can be sendmail, postfix, or anything else that your server is set up with. Please contact your hosting if the mail does not work correctly.

Mail Parameters: When using 'Mail', additional mail parameters can be added here  (e.g. "-fwebmaster@example.com") (deprecated in 1.3.3)

The parameters can be used to pass additional flags as command-line options to the program configured to be used when sending mail, as defined by the sendmail_path configuration setting. For example, this can be used to set the envelope sender address when using sendmail with the -f sendmail option.  -f will set the From address, -r will override the default Return-path that sendmail generates (typically the From address gets used). If you want your bouncebacks to go to a different address than the from address, try using both flags at once: "-f myfromemail@example.com -r mybounceemail@example.com"

Mail Protocol: SMTP

SMTP refers to using another server (not your hosting) to deliver your emails.

SMTP Host: type the IP address or the name of the server

SMTP Username: here you have to type the full email address of the email account you created earlier. Don't type just the username part, but the whole address (e.g. username@yourdomain.com)

SMTP Password: type the password of the same email account. Make sure your mail password contains only UTF-8 characters.

SMTP Port: Port may vary. The most common ports are 25, 465, 587

SMTP Timeout: Default value 5. Sometimes you need to increase this value to give more time for the mailer to answer.

         Example of Gmail SMTP

          SMTP Host - ssl://smtp.gmail.com (or smtp.gmail.com for AbanteCart 1.3.3+)

          SMTP Username - your username (aka username if your email is username@gmail.com)

          SMTP Password - your Gmail password

          SMTP Port - 465

          As a security precaution, Google (Gmail) may prevent an application from accessing your account if it's the first time Google has seen this application sign in to your account, or if it's attempting to sign in from a new location. Gmail sends an email “Suspicious sign-in prevented” and after login in Gmail asks you to confirm this attempt as legal. Just follow Google instructions. Also please check if you have any firewall on your server that blocks outgoing connections.

Mail Protocol: system/config

Starting from AbanteCart 1.3.3 the new email library is included helping connect to different mail transports (3rd Party Transport). Please edit your /system/config.php file to configure the mail transport. 

Here are a few examples of the configurations you need to add to your config.php file. To work with other mail transports please follow symphony guides.

Google Gmail SMTP exampe

const MAILER = [
 //'dsn' => null,
 // OR
'protocol' => 'smtp', // or ses+smtp, gmail+smtp, mandrill+smtp, mailgun+smtp, mailjet+smtp, postmark+smtp, sendgrid+smtp, sendinblue+smtp, ohmysmtp+smtp
 //we use "username" also as ID, KEY, API_TOKEN, ACCESS_KEY
'username' => 'username@gmail.com',
'password' => 'your_gmail_app_password',
'host' => 'smtp.gmail.com',
'port' => 465
];

Amazon SES is an email platform that provides an easy, cost-effective way for you to send and receive email using your own email addresses and domains. Make sure to set sending permission in Amazon SES dashboard

const MAILER = [
    //'dsn' => null,
    // OR
    'protocol' => 'ses+smtp', // or ses+smtp, gmail+smtp, mandrill+smtp, mailgun+smtp, mailjet+smtp, postmark+smtp, sendgrid+smtp, sendinblue+smtp, ohmysmtp+smtp
    //we use "username" also as ID, KEY, API_TOKEN, ACCESS_KEY
    'username' => 'ATIA6H2YCK2CFSJX7M', //your SMTP key
    'password' => 'kUMmlg4fdfghfgOA54C', //your SMTP password
    'host'     => 'email-smtp.eu-west-2.amazonaws.com', //your SMTP endpoint
    'port'     => 465 //or 587 etc
];

Mailchimp transactional email is a delivery API, or application programming interface, that can deliver transactional emails to customers. 

Keep in mind that Mailchimp Transactional is formerly known—and is sometimes still referred to—as “Mandrill”

Every Mailchimp Transactional account has a reputation and hourly quota and understanding how reputation works is key to ensuring the high deliverability of your messages. 

To generate API key navigate to the Settings of your Mailchimp Transactional account (Mandrill app) and look for the API Keys section

const MAILER = [
    //'dsn' => null,
    // OR
    'protocol' => 'mandrill+smtp', // or ses+smtp, gmail+smtp, mandrill+smtp, mailgun+smtp, mailjet+smtp, postmark+smtp, sendgrid+smtp, sendinblue+smtp, ohmysmtp+smtp
    //we use "username" also as ID, KEY, API_TOKEN, ACCESS_KEY
    'username' => 'any_username_will_work', // Any string (Mailchimp recommend using the primary contact email on your Mailchimp account)
    'password' => 'mandrillapp_API_KEY', // Any valid Mailchimp Transactional API key
    'host'     => 'smtp.mandrillapp.com', //your mandrill SMTP endpoint
    'port'     => 587
];

To increase the timeout please change the default_socket_timeout in your php.ini

Related articles

• Page:
  Emails not received (User Manuals)

  • troubleshooting
  • mail
• Page:
  Mail/SMS to customers (User Manuals)

  • mail
  • send_mail
  • send_sms
  • send_im
• Page:
  IM settings (User Manuals)

  • settings
  • mail
  • im
• Page:
  Error: MAIL FROM/RCPT TO/DATA not accepted from server! (User Manuals)

  • troubleshooting
  • mail
• Page:
  Forms Manager (User Manuals)

  • mail
  • forms_manager
• Page:
  Mail Settings (User Manuals)

  • mail
  • settings
• Page:
  E-mail (store email) (User Manuals)

  • mail