Magento 2 SMTP

Magento 2 SMTP extension enables sending Emails in Magento 2 store with a minimum chance to end up in spam box and thus run a successful Email campaign.

 

Table of Content

  1. Extension Installation Guide
  2. Configuration
  3. SMTP Configuration Settings
  4. Developer Settings
  5. Manage SMTP Email Logs

 

  1. Extension Installation
  • For Magento Marketplace Customers
    • Find the Composer name and version of the extension in the extension’s composer.json file.
    • Login to your SSH and run:
      • composer require meetanshi/magento-2-smtp
    • Enter your authentication keys. Your public key is your username; your private key is your password.
    • Wait for Composer to finish updating your project dependencies and make sure there aren’t any errors.
    • To verify that the extension installed properly, run the command:
      • php bin/magento module:status Meetanshi_SMTP
          • By default, the extension is probably disabled.
          • Enable the extension and clear static view files:
      • php bin/magento module:enable Meetanshi_SMTP --clear-static-content
      • php bin/magento setup:upgrade
      • For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
      • For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
      • php bin/magento cache:flush
         
  • For Meetanshi Customers
  • Extract the zip folder and upload our extension to the root of your Magento 2 directory via FTP.
  • Login to your SSH and run below commands step by step:
  • php bin/magento setup:upgrade
  • For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
  • For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
  • php bin/magento cache:flush

Note: Make sure to configure the cron job to make the extension work smoothly.

  1. Configuration
    For configuring the extension, login to Magento 2, move to Stores à Configuration à Meetanshi à SMTP where you can find various settings to enable the extension.
  • Enabled: Set “YES” to enable SMTP extension.
  • Logs E-mails: Select “YES” to Log E-mails in a separate grid.
  • Clean Email Log Every: Enter number of days after which you want to clear the email log.
  • Blacklist E-mail IDs: Enter email IDs that you want to block.

 

 

  1. SMTP Configuration Settings
    Here, configure various settings related to SMTP provider and credentials.
  • SMTP Provider: Select the SMTP Provider with which you want to send mails and the system will auto-fill some other fields as host, port and protocol, still this fields are editable.
  • Host: It will be filled automatically on the basis of your SMTP Provider. Still you can edit it.
  • Port: It will be filled automatically on the basis of your SMTP Provider, still you can edit it.

There are 3 type of default ports:

  • Port 25: Emails sent by Protocol other than SSL, TLS will be sent via this portal.
  • Port 465: Emails sent by Protocol SSL will be sent via this portal.
  • Port 587: Emails sent by Protocol TLS will be sent via this portal.
  • Protocol: Choose the protocol to send the email. It will be filled automatically on the basis of your SMTP Provider. Still, you can edit using the following information:
  • None: Selecting this means that you accept all risks that can occur with your sent emails.
  • SSL: Meaning Secure Socket Layer, this protocol ensures that all data exchanged between the web server and the browser is secure and stay safe.
  • TLS: Meaning Transport Layer Security, this protocol can secure data or messages and validate the integrity of messages through message authentication codes.
  • Authentication Method: Select method name for authentication on the base of your SMTP provider.
    • None: It means no authentication is necessary.
    • Plain: Authentication by login is using username and password. Password is not encrypted in this format.
    • Login: Authentication by login is using username and password. Password is encrypted in this format.
    • Cram MD-5: The CRAM-MD5 authentication mechanism is more secure than the other two mechanisms described earlier because the password cannot be retrieved by decoding the BASE64 encoded client response. 
  • Username: where you enter the account name matching format of the SMTP Provider you had selected.
  • Password: password of the Username. After saving, the password will be encrypted.
  • Return – Path Email: Enter the email ID where you want to send non-delivery receipts and bounce messages.

 

Send Test Email
Configure the setting to send the test email to validate the above settings.

  • Email Sender: Select the sender of the email.
  • Send To: Enter the email ID on which you want to send the test email.

Click “TEST NOW” button. If the information entered is correct, a successful email notification will be sent from the username to Email ID set above.

 

 

  1. Developer Settings
    This is helpful for developers.
  • Developer Mode: Set YES to enable the developer mode.

 

  1. Manage SMTP Email Logs
    To view the email logs, move to Stores à Meetanshi SMTP à Manage SMTP Email Logs where you can find various settings related to email logs. From here you can have a detailed picture of all the mails send to customers from the system. You can click “Clear” button to clean the log. You can use manual actions such as view, resend and delete as well. You can use resend and delete mass actions to resend and delete multiple email logs together.