Differences

This shows you the differences between two versions of the page.

--- magento2:extensions:magento-2-smtp-extension [2026/03/06 18:57] – created - external edit 127.0.0.1
+++ magento2:extensions:magento-2-smtp-extension [2026/04/08 22:58] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Magento 2 SMTP Extension User Guide for Magento 2 ======
+====== Magento 2 SMTP Extension – User Guide ======
 ===== Extension context =====
-This is a Toweringmedia Magento 2 extension guide generated from the Magento Admin virtual product catalog.
+This document provides a comprehensive guide for the Toweringmedia SMTP Extension for Magento 2. It is intended for store administrators and developers who want to configure and manage email delivery through SMTP instead of Magento’s default mail system.
-===== Product page =====
+===== Overview =====
-  * [[https://toweringmedia.com/magento-2-smtp-extension|Magento 2 SMTP Extension]]
+The Toweringmedia SMTP Extension for Magento 2 offers a secure, reliable, and fully configurable email delivery solution. It replaces Magento’s default mail transport system with a robust SMTP-based system designed for enterprise-grade performance.
-===== Overview =====
+This extension ensures that all transactional emails—such as order confirmations, invoices, shipments, and customer communications—are delivered efficiently and consistently.
-The Toweringmedia SMTP Extension for Magento 2 provides a reliable, secure, and fully configurable email delivery system that ensures all transactional, sales, and customer communication emails are delivered successfully. Designed for merchants who need complete control over their email infrastructure, this extension replaces Magento’s inconsistent built-in mail transport with a hardened, enterprise-grade SMTP engine. Built with compatibility and future-proofing in mind, Toweringmedia SMTP supports all major email providers—including Gmail, G Suite, Outlook365, Zoho, Amazon SES, SendGrid, Mailgun, and any custom SMTP server. The extension also includes support for modern authentication methods , ensuring your.
+It supports a wide range of email service providers including Gmail, Google Workspace (G Suite), Outlook 365, Zoho Mail, Amazon SES, SendGrid, Mailgun, as well as any custom SMTP server.
+The extension is built with modern security standards in mind and supports advanced authentication mechanisms such as OAuth, ensuring compliance with current email provider requirements.
+===== Key features =====
+  * Improved email deliverability and reduced spam issues
+  * Reliable transactional email flow
+  * Seamless integration with major email service providers
+  * Detailed email logging and debugging support
+  * Support for secure authentication methods (OAuth, TLS, SSL)
+  * Easy configuration from Magento Admin panel
 ===== What this extension does =====
-  * Higher inbox delivery rates
+  * Enhances inbox delivery rates by using trusted SMTP servers
-  * More reliable order/notification email flow
+  * Ensures reliable sending of order and customer notification emails
-  * Direct provider integration
+  * Allows direct integration with third-party email providers
-  * Logging and traceability
+  * Provides logging for tracking sent emails and troubleshooting issues
-  * Security compliance for modern OAuth systems
+  * Supports modern security protocols to meet compliance standards
 ===== Installation =====
-Install and validate in staging before production rollout.
+Please refer to the installation guide in the following article [[https://toweringmedia.com/installation|https://toweringmedia.com/installation]]
-<code bash>
+===== Setup SMTP extension with Gmail API =====
-cd /path/to/magento
-# Install from your licensed package source
-php bin/magento setup:upgrade
-php bin/magento setup:di:compile
-php bin/magento setup:static-content:deploy -f
-php bin/magento cache:flush
-</code>
-===== Configuration =====
+This section provides a step-by-step guide to configure the Magento 2 SMTP Extension using Gmail API with OAuth 2.0 authentication.
-Configure extension options in Magento Admin, then validate key storefront/admin flows tied to this extension.
+==== Step 1: Create a project in Google Cloud Console ====
+  - Log in to your Google Cloud Console
+  - Click on the project selector and choose **New Project**
+  - Enter a project name (e.g., SMTP Connector for Magento)
+  - Click **Create**
+  - Select the created project from the top navigation
+{{:magento2:extensions:screenshot-2026-03-30-090403-png-783_553--03-30-2026_09_08_am.png?400|}}
+==== Step 2: Enable Gmail API ====
+  - Open the navigation menu
+  - Go to **APIs & Services → Enabled APIs & Services**
+{{:magento2:extensions:towering-media-developer-chat-room-swatwik-ghorai-toweringmedia-com-towering-media-mail-03-30-2026_09_38_am.png?400|}}
+  - Click **Enable APIs and Services**
+  - Search for **Gmail API**
+  - Select and click **Enable**
+{{:magento2:extensions:screenshot_2026-03-30_093957.png?400|}}
+{{:magento2:extensions:screenshot_2026-03-30_094051.png?400|}}
+==== Step 3: Configure OAuth consent screen ====
+  - Navigate to **APIs & Services → Credentials**
+{{::apis-services-_-apis-services-_-smtp-connector-for-_-_-google-cloud-console-03-30-2026_01_41_pm_.png?400|}}
+{{:magento2:extensions:apis-services-_-apis-services-_-smtp-connector-for-_-_-google-cloud-console-03-30-2026_01_42_pm_.png?400|}}
+{{:magento2:extensions:screenshot_2026-03-30_142032_.png?400|}}
+  - Click **Configure Consent Screen**
+  - Click **Get Started**
+{{:magento2:extensions:screenshot_2026-03-30_094317.png?400|}}
+{{:magento2:extensions:screenshot_2026-03-30_094417.png?400|}}
+  - Enter application name (e.g., SMTP)
+  - Provide support email
+  - Choose **Internal** as audience
+  - Save configuration
+{{:magento2:extensions:screenshot_2026-03-30_094447_.png?400|}}
+==== Step 4: Create OAuth client credentials ====
+  - Go to **Credentials**
+  - Click **Create Credentials → OAuth Client ID**
+{{:magento2:extensions:screenshot_2026-03-30_094613.png?400|}}
+  - Select **Web Application**
+  - Enter a name (e.g., SMTP)
+{{:magento2:extensions:screenshot_2026-03-30_135112.png?400|}}
+  - Add Authorized Redirect URI from Magento SMTP settings
+{{:magento2:extensions:screenshot_2026-03-30_095113.png?400|}}
+  - Click **Create**
+  - Copy Client ID and Client Secret
+{{:magento2:extensions:screenshot_2026-03-30_095430.png?400|}}
+==== Step 5: Configure API scopes ====
+  - Navigate to **Data Access**
+  - Click **Add or Remove Scopes**
+{{:magento2:extensions:screenshot_2026-03-30_095721.png?400|}}
+  - Set rows to 100
+  - Select required scopes
+{{:magento2:extensions:screenshot_2026-03-30_095817.png?400|}}
+  - Click **Update**
+  - Click **Save**
+{{:magento2:extensions:screenshot_2026-03-30_095957.png?400|}}
+==== Step 6: Configure SMTP settings in Magento Admin ====
+  - Log in to Magento Admin
+  - Navigate to SMTP settings
+  - Set SMTP Provider to **Gmail**
+  - Enter Gmail email address
+  - Set Authentication Method to **OAuth 2.0**
+  - Enter Client ID and Client Secret
+  - Save configuration and flush cache
+{{:magento2:extensions:screenshot_2026-03-30_100114.png?400|}}
+==== Step 7: Authorize Gmail account ====
+  - Scroll to SMTP configuration section
+  - Click **Authorize with Google**
+  - Complete authentication in popup
+  - Verify status shows:
+    * OAuth is configured and authorized
+    * Authorization Status: Authorized
+{{:magento2:extensions:screenshot_2026-03-30_100337.png?400|}}
+==== Step 8: Verify email functionality ====
+  - Enter test email address
+  - Send test email
+  - Verify email delivery
+If the email is received, SMTP configuration is successfully completed.
 ===== Validation checklist =====
@@ Line 55: / Line 148: @@
   * [[magento2:extensions:start|Magento 2 extension index]]
   * [[start|Global docs home]]