Free SMTP by Need Email
=======================

This ZIP is valid for OpenCart 3.0.0.0 and later, including OpenCart 4.x. It is
an ordinary ZIP archive under 50MB and includes the OpenCart 3 `upload/` payload,
`install.xml`, and the OpenCart 4 payload/metadata.

OpenCart 3.x installation

1. Log in to OpenCart Administration.
2. Open Extensions > Installer.
3. Upload `need_email_free_smtp.ocmod.zip`.
4. In the installer list, select Install for the uploaded extension.
5. Open Extensions > Extensions > Modules.
6. Select Install for Free SMTP by Need Email, then select Edit.
7. Enter your Email Address and Password.
8. Select Connect Automatically.
9. NeedEmail verifies the credentials, discovers SMTP configuration, and configures OpenCart.
10. Enter a recipient Email Address and select Send Test Email.

OpenCart 4.x installation

1. Log in to OpenCart Administration.
2. Open Extensions > Installer.
3. Upload `need_email_free_smtp.ocmod.zip`.
4. Install the uploaded package.
5. Open Extensions > Extensions > Modules.
6. Select Install for Free SMTP by Need Email, then select Edit.
7. Enter your Email Address and Password.
8. Select Connect Automatically.
9. NeedEmail verifies the credentials, discovers SMTP configuration, and configures OpenCart.
10. Enter a recipient Email Address and select Send Test Email.

The normal setup requires only Email Address and Password. SMTP host, port,
security, and authentication details are discovered automatically.

Troubleshooting
---------------

Unable to Connect: verify the Email Address and Password. Your hosting provider
may be blocking outbound HTTPS connections to NeedEmail.

Authentication Failed: NeedEmail rejected the supplied credentials or SMTP access
is disabled for the mailbox.

SMTP Connection Failed: review Advanced Diagnostics and ask the hosting provider
whether outbound SMTP submission on the discovered port is allowed.

To remove the extension, disconnect first if desired, then uninstall the module
from Extensions > Extensions. On OpenCart 3, also uninstall the uploaded
extension entry from Extensions > Installer. The previous OpenCart mail settings
are restored when the extension is disconnected or uninstalled.
