Najskuteczniejsze Rozwiązania dla Woocommerce
Instalacja, konfiguracja, klucze licencyjne, API i changelog.
Napisane po polsku, jasne i krok po kroku.
Od zakupu do działającej automatyzacji w mniej niż 5 minut.
Jeśli dobrze znasz WordPressa, całość zajmie Ci 3 minuty: Pobierz ZIP ze sklepu → zainstaluj w WP Admin → wpisz klucz aktywacyjny → skonfiguruj parametry wybranej integracji.
Wejdź na stronę Sklepu, wybierz wtyczkę i sfinalizuj płatność. Faktura VAT trafi na Twojego maila natychmiast po zaksięgowaniu.
Klucz licencyjny znajduje się w wiadomości e-mail oraz w Panelu Klienta. Z tego samego miejsca pobierasz plik instalacyjny .zip.
Zaloguj się do kokpitu swojej strony. Przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer. Wybierz plik ZIP, zainstaluj i aktywuj.
Przejdź do zakładki ustawień nowej wtyczki w lewym menu. W pole Klucz licencyjny wklej kod WPSELL-XXXX-XXXX-XXXX i kliknij Aktywuj licencję.
Teraz wystarczy przejść do szczegółowej konfiguracji (np. podania klucza API z MailerLite lub zalogowania się do Allegro). W razie problemów — otwórz ticket w zakładce Support.
Czy ta strona była pomocna?
Upewnij się, że Twój serwer jest gotowy do obsługi wtyczek WPsell.
| Oprogramowanie | Minimalna wersja | Zalecana | Opis |
|---|---|---|---|
| WordPress | 5.8 | 6.4+ | Wymagane działające środowisko WP. |
| PHP | 7.4 | 8.1+ | Język programowania na serwerze. |
| WooCommerce | 6.0 | 8.x | Wymagane tylko dla wtyczek opartych o sprzedaż (np. Allegro). |
| MySQL / MariaDB | 5.7 / 10.2 | 8.0+ | Silnik bazy danych. |
| cURL | Aktywne | — | Niezbędne do wykonywania żądań REST API (np. do MailerLite). |
| Certyfikat SSL | HTTPS | — | Protokół szyfrowany wymagany do bezpiecznej komunikacji z API. |
Nasze wtyczki wciąż wspierają PHP 7.4, jednak jest to wersja przestarzała i nie otrzymuje już łatek bezpieczeństwa od twórców języka. Wsparcie dla PHP 7.x zostanie definitywnie zakończone w głównej wersji 3.0 naszych produktów.
Czy ta strona była pomocna?
Standardowa instalacja lub wdrożenie dla deweloperów (WP-CLI).
Jest to najprostszy sposób, nie wymagający dostępu do plików serwera.
.zip pobrany ze sklepu WPsell.Opcja dla użytkowników zaawansowanych, przydatna gdy serwer blokuje wgrywanie dużych plików przez panel.
.zip u siebie na komputerze (powstanie folder z nazwą wtyczki)./wp-content/plugins/ na swoim serwerze.# Instalacja i aktywacja w jednym poleceniu za pomocą narzędzia WP-CLI wp plugin install /sciezka/do/pliku/wpsell-plugin.zip --activate
Czy ta strona była pomocna?
Aktywacja, korzyści i zasady działania kluczy do wtyczek.
Nasze oprogramowanie korzysta z dedykowanego, wysoce bezpiecznego serwera licencyjnego. Proces aktywacji polega na powiązaniu Twojego klucza z konkretną domeną internetową.
Wtyczka funkcjonuje na licencji oprogramowania, a nie subskrypcji usługi (SaaS). Oznacza to, że po wygaśnięciu klucza (zazwyczaj po roku) wtyczka nadal będzie w pełni działać. Zostanie jedynie odcięty dostęp do nowych aktualizacji oraz wsparcia technicznego.
Czy ta strona była pomocna?
Przepisywanie licencji na inne strony (np. przenosiny z testowej na produkcyjną).
Jedna licencja przypisywana jest do jednej głównej domeny produkcyjnej oraz jednego środowiska stagingowego/testowego (np. staging.twojastrona.pl, localhost lub końcówki .local, .test).
Jeśli zmieniasz adres URL strony (rebranding) lub po prostu chcesz przekazać wtyczkę na inny projekt, możesz to zrobić samodzielnie, bez kontaktu z nami:
Ze względów bezpieczeństwa częstotliwość odpinania licencji jest limitowana. Jeśli nadużyjesz funkcji przepinania klucza między dziesiątkami domen w krótkim czasie, system automatycznie zablokuje klucz do czasu wyjaśnienia sprawy z supportem.
Czy ta strona była pomocna?
Inteligentna synchronizacja kursantów z popularnym systemem mailingowym.
Wtyczka integruje platformę kursową Learnly LMS (lub bezpośrednio produkty WooCommerce) z systemem MailerLite z użyciem najnowszego REST API v2.
Przejdź do zakładki Konfiguracja API, aby dowiedzieć się, skąd wziąć niezbędny token dostępowy.
Parowanie WordPressa z kontem MailerLite za pomocą Tokenu autoryzacyjnego.
Sklep WP), a następnie Skopiuj ciąg znaków. Ważne: token wyświetli się tylko raz!Nasza wtyczka opiera się wyłącznie na nowym systemie MailerLite (wydanym w 2022 r.). Jeśli posiadasz stare konto (tzw. MailerLite Classic) z zielonym logo w panelu, zalecamy darmową migrację konta na nową platformę. Stare klucze API nie są już wspierane.
Przejdź do kokpitu WordPressa → Ustawienia Wtyczki. Wklej skopiowany token w pole API Key (v2) i zapisz zmiany. Następnie kliknij przycisk Testuj Połączenie.
Zostanie wykonany próbny ping do serwerów MailerLite. Jeśli połączenie jest poprawne, zobaczysz zielony komunikat o sukcesie wraz z nazwą Twojego konta w ML.
Przekazywanie dodatkowych informacji o zamówieniu do bazy subskrybentów.
Imię i e-mail to często za mało do skutecznej segmentacji. Wtyczka pozwala przekazać do MailerLite dedykowane zmienne prosto z obiektu zamówienia WooCommerce/Learnly.
W panelu ustawień wtyczki znajdziesz dynamiczną tabelę, w której lewa kolumna reprezentuje Pole z zamówienia (WP), a prawa Pole Custom Field w MailerLite.
| Źródło (WordPress) | Odbiorca (MailerLite Field) | Komentarz |
|---|---|---|
billing_first_name | name | Wypełnia pole systemowe imienia. |
billing_phone | phone | Format text/number. |
course_name | last_course_bought | Wymaga ręcznego stworzenia pola typu Text w ustawieniach MailerLite. |
order_total | lifetime_value | Idealne do segmentacji VIP. |
Zanim zmapujesz nowe pole we wtyczce, upewnij się, że utworzyłeś je najpierw w panelu MailerLite (w sekcji Subscribers → Custom Fields).
Nasłuchiwanie na zmiany pochodzące od strony MailerLite.
Czasami informacja musi popłynąć w drugą stronę. Co jeśli subskrybent kliknie "Unsubscribe" (Wypisz się) w wiadomości e-mail? Chcesz o tym wiedzieć w WordPressie.
Wtyczka tworzy na Twojej stronie otwarty, bezpieczny endpoint, na który MailerLite może wysyłać tzw. Webhooki.
https://wpsell.pl/wp-json/wpsell/v1/mailerlite-webhook
subscriber.unsubscribed, subscriber.bounced).Zaawansowany mechanizm zarządzania sprzedażą wielokanałową.
Wtyczka WPsell WooCommerce ↔ Allegro to kombajn integrujący bazę produktów i zamówień na linii Twój sklep – platforma handlowa. Używa ona zaktualizowanego środowiska Allegro REST API v2.
Integracja z Allegro jest w 100% zoptymalizowana pod nową, wysokowydajną architekturę przechowywania zamówień WooCommerce. Nie używa starych zapytań WP_Post.
Autoryzacja sklepu za pomocą Device Flow.
Połączenie WordPressa z systemem Allegro odbywa się przez bezpieczny system tokenów. Nie musisz ręcznie tworzyć i zatwierdzać aplikacji deweloperskiej w systemie Allegro — nasza wtyczka pośredniczy w tym procesie w Twoim imieniu.
Token dostępowy z Allegro ważny jest tylko przez kilka godzin. Nie musisz się jednak tym martwić. Wtyczka zapisuje bezpiecznie tzw. refresh_token i automatycznie w tle, przy pomocy systemu WP Cron, odnawia dostęp zanim ten wygaśnie.
Zarządzanie ceną, stanem i zamówieniami.
Synchronizacja została rozbita na mniejsze moduły (agenty), z których każdy jest odpowiedzialny za konkretną część infrastruktury sklepu.
Kiedy modyfikujesz produkt w zakładce Dane produktu i zapiszesz go, wyzwalany jest natywny hook woocommerce_update_product. Wtyczka sprawdza, czy dany produkt posiada wpisane ID Powiązanej Oferty Allegro (zakładka Allegro w karcie produktu). Jeśli tak — przez API wysyła żądanie modyfikacji aukcji PUT /offers/{offerId}.
Odbywa się cyklicznie co 10, 15 lub 30 minut (zależnie od Twoich ustawień w panelu wtyczki) dzięki usłudze WP Cron. Wtyczka uderza na endpoint GET /order/checkout-forms, pobiera nowe zamówienia i transformuje je do struktury zamówienia WC_Order wewnątrz WooCommerce. Pola takie jak paczkomat czy metoda dostawy zapisywane są w metadanych zamówienia.
Analiza błędów wymiany danych z platformą.
Każde odpytanie API Allegro (udane, lub zakończone statusem 4xx/5xx) jest logowane w natywnym menedżerze logów WooCommerce (WooCommerce → Status → Logi).
| Kod Błędu | Przyczyna | Rozwiązanie |
|---|---|---|
401 Unauthorized | Token dostępu nie odświeżył się prawidłowo. | Przejdź do zakładki Autoryzacja, odłącz konto i zautoryzuj je ponownie. |
422 Too Many Requests | Przekroczono limit nałożony na aplikację. | Wtyczka automatycznie zatrzyma operację, odczeka wyznaczony czas podany w nagłówku i wznowi synchronizację asynchronicznie. |
404 Offer Not Found | Próba aktualizacji aukcji, która została przeniesiona do archiwum w serwisie Allegro. | Usuń nieaktualne ID aukcji z karty produktu w WooCommerce. |
Innowacyjna, własna platforma do tworzenia i sprzedaży kursów online.
Learnly.pl to nasz oddzielny, flagowy produkt — system LMS (Learning Management System) oparty w 100% o natywne środowisko WordPressa (Custom Post Types). Dokumentacja modułu zarządzania lekcjami znajduje się wewnątrz samej instalacji Learnly.
Nasze wtyczki synchronizujące (takie jak opisana wyżej WPsell → MailerLite) posiadają pełne, natywne wsparcie dla struktury danych Learnly (odczytują zakup dostępu i mapują identyfikatory kursów).
Jeśli jesteś zainteresowany uruchomieniem własnej platformy VOD z lekcjami, wejdź na naszą oficjalną wizytówkę produktu pod adresem Learnly.pl.
Bezpośrednia, programistyczna kontrola nad synchronizacją danych.
Każda z naszych wtyczek instaluje niestandardowe endpointy REST pod bazowym adresem:
https://wpsell.pl/wp-json/wpsell/v1/
| Metoda | Ścieżka | Wymaga Autoryzacji? | Zastosowanie |
|---|---|---|---|
GET | /status | Nie | Zwraca status działania skryptów i bazowy uptime (Ping test). |
POST | /sync/trigger | Tak (Bearer Token) | Wymusza wywołanie funkcji synchronizacji bez czekania na Crona. Przydatne dla CI/CD. |
GET | /logs/errors | Tak (Bearer Token) | Zwraca 50 ostatnich błędów w formacie JSON do parsowania np. przez DataDog. |
curl -X POST https://twojadomena.pl/wp-json/wpsell/v1/sync/trigger \ -H "Authorization: Bearer TWOJ_TOKEN_Z_USTAWIEN_WTYCZKI" \ -H "Content-Type: application/json" \ -d '{"module": "allegro", "product_id": 451}'
Modyfikuj dane "w locie" bez edytowania plików źródłowych wtyczki.
Środowisko WP Sell stworzone jest zgodnie ze sztuką WordPressa. Dostarczamy kilkanaście Action Hooks oraz Filters, dzięki którym dopiszesz własne integracje do naszego kodu za pośrednictwem pliku functions.php swojego motywu.
Jeśli mapowanie pól z panelu CMS to za mało, możesz dokleić własną logikę biznesową (np. dodanie pola na podstawie statusu VIP użytkownika) zanim paczka z danymi poleci do API MailerLite.
add_filter('wpsell_mailerlite_subscriber_data', function($payload, $order) { // Jeśli łączna wartość tego zamówienia przekracza 1000 if ($order->get_total() > 1000) { $payload['fields']['is_vip'] = true; } return $payload; }, 10, 2);
add_action('wpsell_allegro_offer_updated', function($product_id, $allegro_offer_id) { // Zapisz do własnego dziennika zdarzeń my_custom_logger_func("Zaktualizowano aukcję Allegro: " . $allegro_offer_id); }, 10, 2);
Zbiór najczęstszych pytań i szybkich odpowiedzi przed kontaktem z obsługą.
Nie. Jeżeli nie przedłużysz dostępu, oprogramowanie nie zostanie zablokowane i nie usunie zgromadzonych danych. Zablokowany zostanie natomiast dostęp do aktualizacji (co z czasem może zrodzić konflikty ze zmieniającym się WordPressem) oraz pomocy technicznej.
Klucz licencyjny jest przywiązany do konkretnej nazwy domeny. W przypadku migracji z localhost lub zmiany domeny docelowej musisz zalogować się do swojego Panelu Klienta i użyć darmowej opcji „Odłącz domenę”. Wówczas klucz będzie gotowy do ponownej aktywacji pod nowym adresem WWW.
Dla klientów planu Enterprise i właścicieli pakietów Custom Development udostępniamy paczki bezpośrednio z naszych prywatnych środowisk produkcyjnych CI/CD w celach zaawansowanego wdrożenia i code-review.
Co zrobić gdy integracja "nie chce działać".
Jeśli API zewnętrze odpowiada i raportuje status OK w teście we wtyczce, a webhooki nie wpadają na Twoją stronę — upewnij się, że używana przez Ciebie wtyczka z gatunku Security (np. WordFence, iThemes Security) nie blokuje przychodzących pakietów POST do endpointów /wp-json/wpsell/.
Mechanizmy cykliczne polegają na wirtualnych zadaniach Cron wbudowanych w WordPress. Jeśli ruch na Twojej witrynie jest znikomy, wirtualny Cron nie ma okazji się "wyzwolić".
Rozwiązanie: Wyłącz wirtualnego Crona w pliku wp-config.php (define('DISABLE_WP_CRON', true);) i skonfiguruj prawdziwego sprzętowego Crona z poziomu panelu cPanel / DirectAdmin / HestiaCP na Twoim hostingu (wywołującego wp-cron.php co np. 5 minut).
Historia rozwoju oprogramowania.
.pot.