Dokumentacja X4Cards

Dowiedz się, jak skonfigurować wtyczkę, shortcody i integracje krok po kroku.

Instrukcja X4Cards — od konfiguracji do publikacji

Poniżej znajdziesz proces pracy z X4Cards po aktywacji wtyczki: konfiguracja sklepów, generator shortcode, ustawienia JSON, logi, cache, self-test i presety. Zrzuty ekranu są ułożone chronologicznie, zgodnie z typowym przepływem pracy.

1. Sklepy — konfiguracja integracji

Zacznij od zakładki Sklepy: wklej typowy link do produktu, pozwól X4Cards wykryć domenę i przypisz właściwego operatora (BuyBox / WebePartners / Amazon). W tym miejscu możesz też mapować aliasy domen oraz edytować ustawienia operatorów.

Wejdź: Panel → X4 Karty → Sklepy.
Wklej adres produktu i kliknij Wykryj.
Sprawdź przypisanie domeny do operatora i zapisz.

Panel Sklepy w X4Cards – konfiguracja domen i operatorów

Rys. 1. Sklepy — wykrywanie sklepu z deeplinku i konfiguracja domen.

2. Generator shortcode — tworzenie kart

W zakładce Generator wklejasz URL-e produktów (po jednym w linii), ustawiasz kolumny, odstęp, cache, kolory i generujesz shortcode do wklejenia we wpisie lub stronie.

Wejdź: Panel → X4 Karty → Generator.
Wklej listę linków i wybierz preset (np. horizontal / compact / tiktok).
Kliknij Generuj i skopiuj shortcode do edytora WP.

X4Cards – Generator shortcodów dla produktów

Rys. 2. Generator — parametry układu i wyglądu kart oraz wynikowy shortcode.

3. Ustawienia JSON — operatorzy i domeny

Panel Ustawienia (JSON) pozwala definiować szablony linków partnerskich (template), parametry identyfikatorów (np. sid, subid) i mapowanie domen → operator. To właśnie z tego pliku korzysta wtyczka przy budowie docelowych URL-i.

Ustawienia JSON w X4Cards – definicja operatorów i mapowanie domen

Rys. 3. Ustawienia JSON — definicje operatorów i domen.

💡 Wskazówka: po większych zmianach w JSON zalecane jest unieważnienie cache (patrz sekcja 5).

4. Logi — wgląd w ruch i kliknięcia

Zakładka Logi rejestruje kliknięcia: czas, host, URL źródłowy i docelowy, podstawowe informacje o przeglądarce i maskowany adres IP. Przydaje się do kontroli jakości i debugowania.

Logi w X4Cards – rejestr kliknięć i przekierowań

Rys. 4. Logi — rejestr ruchu i zdarzeń kliknięcia.

5. Cache — odświeżanie i czyszczenie

W panelu Cache unieważnisz pamięć podręczną (transients) i wyczyścisz miniatury w /uploads/x4cards/. Używaj po większych zmianach w ustawieniach lub JSON.

Wejdź: X4 Karty → Cache.
Kliknij Wyczyść cache globalnie lub skorzystaj z opcji czyszczenia miniatur.
Zweryfikuj efekt na stronie z kartami (twarde odświeżenie przeglądarki).

Panel Cache w X4Cards – unieważnianie cache i czyszczenie miniatur

Rys. 5. Cache — podbicie wersji cache i polityka czyszczenia miniatur.

6. Self-test — diagnostyka środowiska

Self-test sprawdza wersje systemowe (WP/PHP), uprawnienia do uploads oraz liczby zdefiniowanych operatorów i domen. Przydatne przy pierwszym uruchomieniu i audycie.

Self-test X4Cards – status środowiska i uprawnień

Rys. 6. Self-test — szybka diagnostyka ustawień.

7. Shortcody (presety) — zapisz i używaj ponownie

Twórz i zapisuj presety (kolumny, odstępy, kolory, cache, miniatury, ceny) i używaj ich w różnych wpisach. To najprostszy sposób na spójne karty w całym serwisie.

Shortcody X4Cards – tworzenie i zapis presetów

Rys. 7. Shortcody — zapis i ponowne wykorzystanie konfiguracji.

8. Widok mobilny — collage 1

Panel administracyjny i zakładka Sklepy/Generator w widoku na smartfonie. Jeden pionowy obraz łączy 3 zrzuty.

X4Cards na telefonie – Sklepy i Generator (collage 1)

Rys. 8. Mobile — responsywny układ panelu X4Cards.

9. Widok mobilny — collage 2

Logi, Self-test i Shortcody w wersji mobilnej — ciąg dalszy pracy z telefonem.

X4Cards na telefonie – Logi, Self-test i Shortcody (collage 2)

Rys. 9. Mobile — pełna responsywność kluczowych zakładek.

ℹ️ Uwaga organizacyjna: czas trwania abonamentu jest liczony od momentu przypisania identyfikatora do adresu e-mail i telefonu po potwierdzeniu danych. W przypadku zmian operatorów/domen pamiętaj o unieważnieniu cache (sekcja 5).