SMTP Manager — Email autentificat și jurnal — Ghid de instalare & configurare

1. Cerințe#

• OpenMage LTS 19.x/20.x (ideal >= 19.5 / 20.1) sau Magento CE 1.9.x
• PHP 7.2–8.3 cu ionCube Loader activat (majoritatea hosting-urilor îl au; verifică cu o pagină phpinfo() sau întreabă furnizorul)
• Credențiale SMTP de la providerul tău (host, port, utilizator, parolă sau cheie API)

2. Instalarea fișierelor#

1. Descarcă pachetul din contul Imavio (Descărcări) după cumpărare.
2. Dezarhivează și urcă conținutul peste rădăcina Magento — se îmbină în app/code/local/Imavio/Smtp, app/etc/modules/Imavio_Smtp.xml și layout-ul de admin. Niciun fișier de core nu e suprascris.
3. Golește cache-ul: System → Cache Management → Flush Magento Cache. Scriptul de setup creează automat tabela imavio_smtp_log.
4. Extensia se instalează dezactivată implicit — instalarea nu schimbă nimic în felul în care magazinul trimite emailuri până nu o activezi la pasul 4.

3. Activarea licenței#

1. Mergi la System → Configuration → Imavio Extensions → SMTP Manager → License.
2. Lipește cheia de licență din contul Imavio și salvează.
3. Trimiterea nu depinde niciodată de starea licenței — licența deblochează doar actualizările și suportul (validată în fundal).

4. Configurare & test — înainte de activare#

1. Alege canalul de trimitere. SMTP e conexiunea clasică pe porturile 587/465/2525. API HTTP trimite prin API-ul providerului, pe HTTPS (portul 443), și are nevoie doar de o cheie de API — alege-l dacă hostingul îți blochează porturile SMTP (vezi pasul 6). Provideri API suportați: Brevo, SendGrid, Mailgun, Postmark, Mailjet, Resend.
2. Pe canalul SMTP, alege providerul din presets ca să se completeze automat host, port și criptare, apoi introdu credențialele. Setează numele HELO/EHLO și Envelope-From dacă releul tău le cere. Pe canalul API, alege providerul și lipește cheia — formularul îți arată exact ce cheie cere fiecare provider și capcanele lui obișnuite.
3. Configurează o rută de failover. Cea mai rezistentă combinație e un provider extern ca rută principală și serverul de mail al propriului server ca rezervă (host localhost, portul 25, fără criptare, fără autentificare) — serverul local funcționează și când SMTP-ul de ieșire e blocat.
4. Deschide dashboard-ul din Imavio → SMTP Manager și trimite un email de test. Diagnosticul pas cu pas validează configurația (inclusiv nepotrivirea 465+STARTTLS), verifică conectivitatea și face o trimitere reală, cu indicații prietenoase la orice eșec.
5. Abia după ce testul reușește, comută switch-ul Activat ca să direcționezi emailurile magazinului prin SMTP Manager.

5. Verificare#

• Plasează o comandă de test și declanșează un newsletter — confirmă că ambele sosesc din contul tău de trimitere.
• Deschide Imavio → SMTP Manager și verifică grila de jurnal: trimiterile reușite și eșecurile apar cu răspunsul brut al serverului. Folosește retrimiterea, exportul CSV sau vederea de detaliu (corpul afișat într-un iframe sandboxat) după nevoie.
• Rulează doctorul de livrabilitate din dashboard ca să verifici MX / SPF / DMARC pentru domeniul expeditorului și aplică remedierile DNS sugerate.

6. Nu mai ajung emailurile — ce verifici#

SMTP Manager te avertizează înaintea clienților: când mai multe încercări de trimitere eșuează la rând, fiecare pagină de admin afișează un avertisment cu ultima eroare, iar jurnalul păstrează răspunsul exact al serverului. Avertismentul dispare singur la prima trimitere reușită.

Cazul clasic: a mers săptămâni, apoi s-a oprit peste noapte. Pe hostingurile cPanel, cauza e aproape întotdeauna funcția SMTP Restrictions, care blochează conexiunile de ieșire ale conturilor de utilizator către porturile 25, 465 și 587 și forțează tot mailul prin sistemul de mail al serverului. Pentru că panoul cPanel se actualizează în fiecare noapte, o restricție care nu era aplicată corect poate începe să fie aplicată de pe o zi pe alta — setările tale nu s-au schimbat, dar portul e acum închis. În jurnal apare Connection timed out sau Could not open socket.

Trei soluții, cea mai bună prima:

1. Comută canalul pe API HTTP. Trimiterea merge atunci pe HTTPS, portul 443, pe care nicio restricție SMTP nu îl atinge. E rezolvarea definitivă și nu depinde de hosting.
2. Cere hostingului o excepție pentru serverul providerului tău. Funcționează, dar excepția poate să nu supraviețuiască unui update de panou sau unei migrări de server.
3. Adaugă serverul de mail local ca failover (host localhost, portul 25, fără criptare, fără autentificare). Livrabilitatea e mai slabă decât la un provider dedicat, dar emailurile continuă să plece în loc să se oprească de tot.

Alte cauze frecvente: o cheie de API expirată sau revocată (în jurnal, HTTP 401), o adresă de expeditor care nu mai e verificată la provider (HTTP 403 sau 422) sau o cotă zilnică de trimitere atinsă (HTTP 429 — pune o pauză între emailurile din coadă, în regulile de trimitere).

7. Actualizări & suport#

Versiunile noi apar în Descărcări în contul tău cât timp fereastra de actualizări e activă. O licență expirată nu oprește niciodată emailurile — doar afișează notice-uri în admin și pune pe pauză actualizările. Ai nevoie de ajutor? Deschide un tichet din contul Imavio — suportul e inclus în licență.