Plugin do zarządzania mailami transakcyjnymi dla headless WooCommerce
Zaprojektowanie i wdrożenie pluginu WordPress/WooCommerce centralizującego zarządzanie mailami transakcyjnymi w architekturze headless. Rozwiązanie obejmuje edycję szablonów, podgląd, wysyłkę testową, przechwytywanie wysyłek produkcyjnych, mapowanie linków do frontendu oraz operacyjny dziennik zdarzeń emailowych.
Problem do rozwiązania
Standardowy system maili WooCommerce i WordPress nie jest dobrze dopasowany do sklepów headless, w których publiczna ścieżka klienta działa poza WordPressem. Problemem były linki prowadzące do backendu zamiast frontendu, rozproszone zarządzanie mailami WooCommerce i WordPress, brak spójności między podglądem a realną wysyłką oraz ryzyko rozjazdu wersji HTML i plain text. Projekt wymagał jednego miejsca konfiguracji, wspólnego renderera i kontrolowanego mapowania linków bez tworzenia osobnego systemu analitycznego ani rozbudowanej platformy mailingowej.
Projekt został zrealizowany jako dedykowany plugin WordPress dla środowiska WooCommerce działającego w modelu headless. Kluczową decyzją architektoniczną było potraktowanie maili transakcyjnych jako osobnego, spójnego systemu, a nie zbioru pojedynczych nadpisanych szablonów.
Plugin buduje runtime registry dostępnych maili, obsługuje źródła WooCommerce oraz wybrane maile WordPress core, a następnie przepuszcza podgląd, test send i real send przez wspólny renderer. Dzięki temu administrator widzi możliwie ten sam rezultat, który później trafia do klienta.
Osobna warstwa link resolvera odpowiada za mapowanie intencji, takich jak zamówienie, konto, reset hasła czy checkout, na adresy publicznego frontendu. To usuwa typowy problem sklepów headless, w których wiadomości transakcyjne domyślnie prowadzą użytkownika do backendowych ścieżek WordPressa lub WooCommerce.
Panel administracyjny został zaprojektowany jako jedno miejsce pracy: edycja szablonów, ustawienia globalne, preview, wysyłka testowa, diagnostyka, overview oraz log zdarzeń. Zakres świadomie ograniczono do operacyjnego zarządzania mailami, bez budowania osobnej platformy marketing automation, click/open trackingu czy systemu retry.
Potwierdzone rezultaty
- Centralizacja maili
- WooCommerce i maile kont WordPress w jednym panelu.
- Spójny rendering
- Preview, test send i real send używają tej samej logiki.
- Routing do frontendu
- Linki klientów prowadzą do frontendu headless, nie do backendu.
- Panel administracyjny
- Szablony, ustawienia, diagnostyka, overview i log w jednym miejscu.
- Edycja szablonów
- Treści, CTA, merge tagi, bloki, stopka i social links.
- HTML i plain text
- Obie wersje maila powstają z jednego źródła treści.
- Operational email log
- Rejestruje generowanie, transport, błędy i kontekst wysyłki.
- Bezpieczna konfiguracja
- Jeden model ustawień, sanitizacja i ograniczone dane w logach.
