How to use Gmail SMTP Connect in Joomla!

Introduction

Starting in January 2025, Google will no longer allow third-party apps or devices to access Google Accounts using only a username and password. This change aims to improve account security by requiring the use of modern authentication protocols such as OAuth 2.0. Without making the necessary updates, email functionalities on websites and applications using Gmail's SMTP server may stop working.

The Gmail SMTP Connect plugin for Joomla! provides a simple and secure solution to adapt to these changes. By using OAuth 2.0, the plugin ensures compliance with Google's new security policies and safeguards sensitive account data. This guide will show you how to install, configure, and use Gmail SMTP Connect to keep your email communication reliable and secure.

1. Installation

1. Download the Plugin: Visit Web357's Download Area and download the Gmail SMTP Connect plugin for Joomla!.
2. Access Installation: Go to System → Install → Extensions in your Joomla! admin panel.
3. Upload the Plugin: Click "Choose File," select the downloaded ZIP file, and click "Upload & Install."
4. Confirm Installation: Wait for the installation confirmation message. The plugin is now installed.

2. Configuration

2.1. Google Cloud Console Configuration

To use the plugin, you need to configure a Google Cloud project to obtain OAuth credentials:

1. Create a Google Cloud Project: Visit Google Cloud Console, sign in, and create a new project.





2. Enable Gmail API: Go to APIs & Services → Library and enable the Gmail API for your project.



3. Set Up OAuth Consent Screen: Access the OAuth Consent Screen menu and configure it:
   • Choose "External" for the user type.
   • Fill in the app name and email fields.
   • Skip the Scopes and Test Users

   Save the settings.








4. Create OAuth Credentials: Navigate to APIs & Services → Credentials, click "Create Credentials," and choose "OAuth Client ID."
   • Select "Web application" as the application type.
   • Enter your redirect URI (found in the plugin's settings).

   Save the Client ID and Secret.

2.2. Joomla! Plugin Settings

Now configure the plugin within Joomla:

1. Access Plugin Settings: Go to System → Plugins and locate "System - Gmail SMTP Connect."
2. Enter Credentials: Copy the Client ID and Secret from Google Cloud Console and paste them into the plugin settings.
3. Configure Email Settings: Set the OAuth email, sender's email, and encryption (TLS or SSL).
4. Save and Authenticate: Click "Authenticate with Gmail" and complete the authorization process.

3. Testing the Setup

1. Send Test Email: Go to the "Send Test Email" section in the plugin settings.
2. Enter Test Email: Provide a recipient's email address and click "Send Test Email."
3. Verify Success: Check for a success message and confirm the test email is received.

Test Email successfully delivered (screenshot).

4. Common Issues and Solutions

• Invalid Client Error: Ensure the Client ID and Secret are correct and match the Google Cloud project.
• Redirect URI Mismatch: Verify the Redirect URI matches the exact URL in the plugin settings.
• Authentication Issues: Check that the Gmail API is enabled and all credentials are accurate.

Conclusion

By following these steps, you can successfully use Gmail SMTP Connect to enable secure and reliable email delivery in Joomla. Ensure you keep both Joomla! and the plugin updated for optimal performance and compatibility.