Dokumentacja Wtyczki WooCommerce – MailerLite

WooCommerce → MailerLite Groups — Dokumentacja
Dokumentacja

WooCommerce → MailerLite Groups

Automatycznie dodaje klientów do grup MailerLite po opłaceniu zamówienia w Twoim sklepie WooCommerce.

1 Wymagania techniczne
  • WordPress 6.0 lub nowszy
  • WooCommerce 7.0 lub nowszy
  • PHP 8.0 lub nowszy
  • Konto MailerLite z aktywnym kluczem API
  • Aktywna licencja wtyczki (jednorazowa lub roczna)
⚠️ Wtyczka NIE jest kompatybilna z darmowym planem MailerLite Classic. Wymaga konta w nowej wersji MailerLite (connect.mailerlite.com).
2 Instalacja wtyczki
1
Pobierz plik wtyczki

Po zakupie otrzymasz na e-mail plik woo-mailerlite-groups.zip oraz klucz licencyjny.

2
Wgraj do WordPressa

Przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę, wybierz pobrany plik ZIP i kliknij Zainstaluj teraz.

3
Aktywuj wtyczkę

Po instalacji kliknij Aktywuj wtyczkę. W menu WooCommerce pojawi się pozycja MailerLite Groups.

4
Aktywuj licencję

Wpisz klucz licencyjny z e-maila w sekcji Licencja w ustawieniach wtyczki (patrz punkt 3).

💡 Instalację można też przeprowadzić przez FTP — wypakuj ZIP i wgraj folder woo-mailerlite-groups do katalogu /wp-content/plugins/.
3 Aktywacja licencji
1
Otwórz ustawienia wtyczki

Przejdź do WooCommerce → MailerLite Groups. W prawej kolumnie znajdziesz kartę Licencja.

2
Wpisz klucz licencyjny

Skopiuj klucz w formacie WMLA-XXXXX-XXXXX-XXXXX-XXXXX z e-maila po zakupie i wklej go w pole.

3
Kliknij „Aktywuj licencję”

Wtyczka połączy się z serwerem i zatwierdzi klucz dla Twojej domeny. Aktywacja trwa kilka sekund.

ℹ️ 1 klucz = 1 domena. Klucz można aktywować tylko na jednej stronie. Jeśli przenosisz stronę na nową domenę, najpierw dezaktywuj licencję na starej (przycisk Dezaktywuj w ustawieniach).
⚠️ Licencja roczna wygasa po 12 miesiącach. Przed wygaśnięciem otrzymasz e-mail z przypomnieniem. Po wygaśnięciu wtyczka nadal działa, ale nie otrzymasz aktualizacji ani wsparcia technicznego do momentu odnowienia.
4 Połączenie z MailerLite

Wtyczka łączy się z MailerLite przez klucz API. Wykonaj poniższe kroki, aby go uzyskać:

1
Zaloguj się do MailerLite

Otwórz app.mailerlite.com i zaloguj się na swoje konto.

2
Przejdź do Integracji

Kliknij swoje imię / avatar w prawym górnym rogu → IntegracjeAPI.

3
Skopiuj klucz API

Kliknij Wygeneruj nowy token (lub skopiuj istniejący). Klucz zaczyna się od długiego ciągu znaków.

4
Wklej klucz w wtyczce

Przejdź do WooCommerce → MailerLite Groups, wklej klucz w polu Klucz API i kliknij Testuj połączenie.

5
Pobierz grupy

Po pozytywnym teście kliknij Pobierz grupy z MailerLite. Wtyczka załaduje listę Twoich grup, którą będziesz mógł przypisywać do produktów.

💡 Grupy są przechowywane lokalnie (cache). Po dodaniu nowej grupy w MailerLite należy kliknąć Pobierz grupy ponownie, aby pojawiła się na liście.
5 Konfiguracja mapowań

Mapowanie to powiązanie: produkt WooCommerce → grupa MailerLite. Gdy klient kupi dany produkt, zostanie automatycznie dodany do wskazanej grupy.

Jak dodać mapowanie?

  1. Kliknij przycisk + Dodaj mapowanie.
  2. W kolumnie Produkt WooCommerce wyszukaj i wybierz produkt.
  3. W kolumnie Grupa MailerLite wybierz grupę z listy.
  4. W kolumnie Wyzwalacz wybierz status zamówienia, przy którym nastąpi zapis.
  5. Kliknij Zapisz ustawienia.
Kolumna Opis
Produkt WooCommerce Produkt lub wariant, po zakupie którego klient trafi do grupy. Wyszukiwarka obsługuje produkty proste i z wariantami.
Grupa MailerLite Grupa w MailerLite, do której zostanie dodany subskrybent. W nawiasie widoczna jest aktualna liczba członków.
Wyzwalacz Status zamówienia WooCommerce, który uruchamia zapis. Domyślnie: Zrealizowane.
ID Identyfikator produktu w WooCommerce (tylko informacyjnie).
ℹ️ Jeden produkt może mieć kilka mapowań — np. do różnych grup MailerLite lub z różnymi wyzwalaczami. Wystarczy dodać kolejne wiersze z tym samym produktem.

Wyszukiwanie i filtrowanie

Nad tabelą mapowań znajduje się wiersz filtrów. Wpisując tekst w odpowiedniej kolumnie możesz szybko znaleźć interesujące mapowanie. Filtry działają w czasie rzeczywistym i można je łączyć.

6 Wyzwalacze

Wyzwalacz określa, przy jakim statusie zamówienia WooCommerce klient zostanie dodany do grupy MailerLite.

Wyzwalacz Kiedy jest aktywowany? Rekomendowany dla
Oczekujące na płatność Zamówienie złożone, płatność jeszcze nie dotarła. Lead magnet, darmowe produkty
W realizacji Płatność potwierdzona, zamówienie w trakcie realizacji. Produkty fizyczne (szybkie potwierdzenie)
Zrealizowane Zamówienie w pełni zrealizowane i dostarczone. Zalecane dla większości przypadków
Wstrzymane Zamówienie oczekuje na ręczne potwierdzenie płatności. Płatność przelewem / COD
Anulowane Zamówienie zostało anulowane. Segmentacja klientów którzy zrezygnowali
Zwrot Zamówienie zostało zwrócone. Kampanie win-back
Nieudane Płatność nie powiodła się. Ratowanie porzuconych koszyków
7 Automatyczne zamknięcie zamówień wirtualnych

WooCommerce domyślnie nie oznacza zamówień jako Zrealizowane automatycznie. Ta funkcja pozwala skrócić ten proces dla produktów cyfrowych.

Opcja Działanie
Nie zmieniaj statusu Funkcja wyłączona — WooCommerce działa domyślnie.
Tylko wirtualne produkty Automatycznie zamknij zamówienie, jeśli wszystkie produkty są wirtualne lub do pobrania.
Przynajmniej jeden wirtualny Automatycznie zamknij, jeśli zamówienie zawiera co najmniej jeden produkt wirtualny.
Wszystkie zamówienia Automatycznie zamknij każde zamówienie po opłaceniu.
💡 Dla sklepów sprzedających wyłącznie kursy online lub e-booki zalecana jest opcja Tylko wirtualne produkty — klient natychmiast po zapłacie trafia do grupy MailerLite.
8 Logi aktywności

Wtyczka zapisuje historię wszystkich operacji w pliku wp-content/wml-log.txt. Ostatnie 20 wpisów widoczne jest bezpośrednio w panelu ustawień.

Jak czytać logi?

[2026-03-15 10:22:01] Order #42: OK – dodano do zakup_kurs (abc123)
[2026-03-15 09:15:44] Order #41 [completed]: jan@example.com -> „zakup_ebook”
[2026-03-15 08:05:12] Order #40: BLAD – Unauthorized (401)
[2026-03-15 07:00:00] Order #39 [completed]: produkt #55 – brak mapowania.
OK — klient został poprawnie dodany do grupy.
⚠️ BLAD — błąd połączenia z MailerLite (sprawdź klucz API).

ℹ️ Jeśli chcesz wyłączyć zapis logów (np. ze względu na miejsce na dysku), odznacz opcję Zapisuj logi aktywności w ustawieniach wtyczki.
9 Rodzaje licencji
Funkcja Licencja jednorazowa Licencja roczna
Pełna funkcjonalność wtyczki
Aktywacja na 1 domenie
Czas trwania Bezterminowa 12 miesięcy
Aktualizacje wtyczki
Wsparcie techniczne (e-mail)
Priorytetowa pomoc
⚠️ Licencja jednorazowa NIE obejmuje aktualizacji po zmianie API MailerLite lub WooCommerce. W razie niezgodności po aktualizacji zewnętrznych systemów odpowiedzialność spoczywa na użytkowniku. Zalecamy licencję roczną dla aktywnie rozwijanych sklepów.
10 Najczęstsze pytania
Klient kupił produkt, ale nie trafił do grupy MailerLite. Co sprawdzić?

Sprawdź kolejno:

  1. Czy klucz API jest prawidłowy? (przycisk Testuj połączenie)
  2. Czy istnieje mapowanie dla tego produktu z odpowiednim wyzwalaczem?
  3. Czy zamówienie osiągnęło wymagany status (np. Zrealizowane)?
  4. Czy adres e-mail klienta jest poprawny?
  5. Sprawdź logi aktywności — pojawi się tam konkretny błąd.
Czy mogę przypisać jeden produkt do kilku grup jednocześnie?

Tak. Dodaj kilka wierszy mapowań z tym samym produktem, ale różnymi grupami MailerLite. Wszystkie mapowania zostaną wykonane przy realizacji zamówienia.

Czy wtyczka działa z produktami z wariantami (Variable Product)?

Tak. Możesz mapować zarówno produkt główny (wtedy każdy wariant będzie wyzwalał zapis), jak i konkretny wariant (np. tylko rozmiar L kursu). W wyszukiwarce produktów warianty są oznaczone symbolem ⚡.

Przenoszę stronę na nową domenę. Co zrobić z licencją?

Przed migracją przejdź do WooCommerce → MailerLite Groups → Licencja i kliknij Dezaktywuj. Klucz zostanie zwolniony i będzie można go aktywować na nowej domenie.

Co się stanie po wygaśnięciu licencji rocznej?

Wtyczka nadal działa — klienci nadal trafiają do grup MailerLite. Tracisz jedynie dostęp do aktualizacji i wsparcia technicznego. Aby je przywrócić, odnów licencję i aktywuj nowy klucz w ustawieniach.

Czy klient może trafić do grupy dwukrotnie przy jednym zamówieniu?

Nie. MailerLite automatycznie ignoruje duplikaty — jeśli adres e-mail już istnieje w grupie, nie zostanie dodany ponownie. Status istniejącego subskrybenta pozostanie bez zmian.

Nie widzę moich grup w liście. Co zrobić?

Kliknij przycisk Pobierz grupy z MailerLite w ustawieniach wtyczki. Jeśli nadal nie pojawiają się grupy, sprawdź czy klucz API jest aktualny i czy w koncie MailerLite istnieją jakiekolwiek grupy odbiorców.

Gdzie znajdę klucz API MailerLite?

Zaloguj się na app.mailerlite.com → kliknij avatar w prawym górnym rogu → IntegracjeDeveloper API. Skopiuj istniejący token lub wygeneruj nowy.

11 Wsparcie techniczne

📧 E-mail (licencja roczna)

Posiadacze licencji rocznej mają dostęp do wsparcia e-mail. Czas odpowiedzi: do 48h w dni robocze.

kontakt@ollimport.pl

📖 Ta dokumentacja

Przed wysłaniem wiadomości sprawdź sekcję FAQ — odpowiedź na Twoje pytanie prawdopodobnie już tu jest.

ℹ️ Przy zgłaszaniu błędu dołącz zawartość logów z pliku wp-content/wml-log.txt oraz informację o wersji WordPress, WooCommerce i PHP — znacznie przyspieszy to rozwiązanie problemu.