Opis /
Kowal Async Sales Email — asynchroniczne e-maile dla Magento 2
MAGENTO 2 · E-MAILE SPRZEDAŻOWE · DIAGNOSTYKA
Potwierdzenia w tle. Większa kontrola nad wysyłką.
Kowal Async Sales Email to moduł Magento 2, który ustawia domyślnie asynchroniczną wysyłkę natywnych e-maili sprzedażowych. Przy aktywnym trybie asynchronicznym standardowe potwierdzenia są przetwarzane przez zadania cron Magento, co pozwala oddzielić ich wysyłkę od obsługi żądania zakupu. Ogranicza to wpływ oczekiwania na transport pocztowy na standardową ścieżkę składania zamówienia.
Rozwiązanie obejmuje powiadomienia dotyczące zamówień, faktur, wysyłek i korekt. Korzysta z mechanizmu wysyłkowego Magento oraz dodaje komendę diagnostyczną, która pomaga sprawdzić konfigurację, oczekujące dokumenty i działanie zadań cron.
Zamówienia · Faktury · Wysyłki · Korekty
Co zyskuje Twój sklep?
Mniej oczekiwania w procesie zakupu
Oddzielenie wysyłki potwierdzeń od zakupu. Obsługa poczty przez natywne zadania cron ogranicza wpływ opóźnień transportu na żądanie checkoutu w zakresie objętym natywną wysyłką asynchroniczną.
Szybsze rozpoznanie zaległości. Raport pokazuje liczbę dokumentów oczekujących na wysyłkę osobno dla każdego obsługiwanego typu oraz datę utworzenia najstarszego z nich.
Czytelna diagnostyka i własny monitoring
Kontrola działania crona. Administrator może sprawdzić ostatnie wykonania zadań, zaległe uruchomienia i bezpieczne kategorie błędów.
Możliwość podłączenia monitoringu. Format JSON i kody wyjścia pozwalają wykorzystać raport we własnych narzędziach nadzorujących sklep.
Zachowanie decyzji administratora. Moduł dostarcza wartość domyślną; jawne ustawienia zachowują pierwszeństwo zgodnie z konfiguracją Magento.
Natywny mechanizm Magento
Moduł ustawia sales_email/general/async_sending na 1 w konfiguracji domyślnej. Jeżeli efektywna wartość pozostaje wyłączona, diagnostyka zgłasza ostrzeżenie. Ustawienia włączenia poszczególnych rodzajów e-maili pozostają obsługiwane przez Magento.
Progi ostrzeżeń dopasowane do sklepu
W sekcji konfiguracji Sales Emails moduł dodaje grupę Asynchronous Sales Email Diagnostics, dostępną w zakresie domyślnym:
Document Age Warning (minutes) — 30 minut Próg wieku najstarszego oczekującego dokumentu, liczony od jego utworzenia.
Cron Delay Warning (minutes) — 10 minut Próg używany do oceny opóźnień i aktualności wykonań crona.
Oba pola przyjmują całkowite wartości od 1 do 525600 minut. Wiek dokumentu jest wskaźnikiem diagnostycznym, a nie dokładnym czasem oczekiwania wiadomości na wysłanie.
Sprawdź stan wysyłki jedną komendą
Raport tekstowy można uruchomić poleceniem:
bin/magento kowal:async-sales-email:status
Wersja przeznaczona do integracji z monitoringiem:
Raport obejmuje efektywne ustawienie wysyłki asynchronicznej, progi ostrzeżeń, liczbę oczekujących dokumentów i stan czterech natywnych zadań wysyłkowych. Uwzględnia flagi wysyłki, ustawienia sklepów, rozpoznany wariant natywnej obsługi ponowień oraz filtr daty odtwarzany z konfiguracji natywnych handlerów. Osobno podaje liczbę dokumentów wykluczonych przez ten filtr i liczbę dokumentów z flagą email_sent = 0.
Komenda zwraca kod 0 dla stanu poprawnego, 1 dla ostrzeżeń oraz 2 dla błędu diagnostyki lub nieobsługiwanego formatu. Diagnostyka odczytuje dane; nie wysyła wiadomości ani nie zmienia flag dokumentów. Wynik nie zawiera treści wiadomości, adresów klientów ani surowych komunikatów błędów crona.
Warunki działania i zakres modułu
Cron, transport i obsługiwane wiadomości
Wysyłka wymaga działającego crona Magento i poprawnie skonfigurowanego transportu pocztowego. Moduł nie naprawia błędów SMTP ani STARTTLS. Nie dodaje własnej kolejki, workera lub mechanizmu ponowień; korzysta z obsługi dostępnej w Magento.
Zakres obejmuje natywne e-maile sprzedażowe. Resety haseł, rejestracja kont, formularze kontaktowe, newslettery i wiadomości niestandardowych rozszerzeń nie są objęte tym rozwiązaniem. Rozszerzenie wymuszające wysyłkę synchroniczną lub omijające natywne sendery może wymagać osobnej analizy.
Kontrola przed wdrożeniem
Przed włączeniem trybu asynchronicznego na istniejącym sklepie należy skontrolować historyczne niewysłane potwierdzenia. W zależności od flag dokumentów i natywnej logiki Magento mogą one zostać zakwalifikowane do przetworzenia.
Brak historii crona może wynikać z jej czyszczenia lub ze świeżej instalacji. Poprawne wykonanie zadania i przyjęcie wiadomości przez transport nie potwierdzają dostarczenia jej do skrzynki odbiorcy. Diagnostyka nie ustala pełnego źródła efektywnej konfiguracji; raportuje osobno obecność jawnego wpisu w bazie w zakresie domyślnym.
Informacje techniczne
Nazwa modułu: Kowal_AsyncSalesEmail.
Pakiet Composer: kowal/module-async-sales-email.
Typ pakietu: magento2-module.
Wymaganie PHP w composer.json: >=8.1 <8.6.
Zależności Magento: Framework, Sales, Store, Cron i Config, w wersjach określonych w composer.json.
Brak zależności od Kowal_Base, pakietu newsletterowego i konkretnego dostawcy SMTP.
Deklaracje Composer nie stanowią potwierdzenia przetestowania wszystkich kombinacji Magento i PHP. Zgodność z konkretnym sklepem, jego transportem pocztowym oraz rozszerzeniami checkoutu wymaga weryfikacji na środowisku testowym.
Sprawdź wysyłkę potwierdzeń w swoim sklepie
Uruchom raport diagnostyczny i sprawdź konfigurację, oczekujące dokumenty oraz działanie zadań cron. Przed wdrożeniem zweryfikuj zgodność modułu na środowisku testowym.
Napisz opinię
Pytania i odpowiedzi
Pytanie
Czy Magento nie ma już tej funkcji?
Odpowiedź
Tak. Magento ma natywną wysyłkę asynchroniczną e-maili sprzedażowych. Moduł dostarcza jej domyślne włączenie w powtarzalnym pakiecie oraz diagnostykę ustawień, oczekujących dokumentów i zadań cron. Jawne nadpisanie konfiguracji może pozostawić ten tryb wyłączony.
Pytanie
Czy moduł naprawia błędy płatności i 503?
Odpowiedź
Moduł ogranicza wpływ oczekiwania na wysyłkę standardowego potwierdzenia na obsługę zakupu. Błędy płatności i 503 mogą mieć wiele przyczyn, dlatego wymagają osobnej diagnozy. Rozwiązanie nie jest integracją płatniczą i nie gwarantuje usunięcia tych błędów.
Pytanie
Co się stanie, gdy SMTP lub cron przestanie działać?
Odpowiedź
Przy aktywnej natywnej wysyłce asynchronicznej standardowe żądanie zakupu nie czeka na transport potwierdzenia. Awaria SMTP lub crona może jednak opóźnić albo uniemożliwić wysyłkę wiadomości. Komenda diagnostyczna pomaga wykryć zaległości i problemy z zadaniami; dalsza obsługa wysyłki i ponowień zależy od mechanizmu danej wersji Magento. Moduł nie naprawia tych awarii automatycznie.
Pytanie
Czy klient otrzyma potwierdzenie od razu po zakupie?
Odpowiedź
Potwierdzenia wysyłają zadania działające w tle, więc wiadomość może dotrzeć chwilę po zakupie. Czas zależy od działania crona, liczby oczekujących dokumentów i transportu pocztowego. Moduł nie gwarantuje czasu dostarczenia ani trafienia wiadomości do skrzynki odbiorcy.
Pytanie
Jakie wiadomości obejmuje moduł i jak sprawdzić ich stan?
Odpowiedź
Moduł obejmuje natywne powiadomienia o zamówieniach, fakturach, wysyłkach i korektach. Polecenie bin/magento kowal:async-sales-email:status pokazuje konfigurację, liczbę oczekujących dokumentów, wiek najstarszego z nich i stan zadań cron. Wiek liczony jest od utworzenia dokumentu, a nie od momentu zlecenia e-maila. Reset hasła, formularze, newslettery i wiadomości własnych rozszerzeń wymagają osobnej weryfikacji.
