FAQ — pytania i odpowiedzi

Pytania, które najczęściej pojawiają się od użytkowników wtyczki — z konkretnymi rozwiązaniami.

1. Problemy techniczne

Mój CSS nie działa — co robię źle?

Trzy częste przyczyny:

  • Specyficzność — strona ma swoje style. Użyj !important albo bardziej specyficznych selektorów.
  • Dynamiczne klasy — frameworki generują .css-1abcd które się zmieniają między wersjami. Celuj w stabilne atrybuty (np. [data-testid="..."]).
  • Shadow DOM — niektóre elementy są w Shadow DOM i CSS spoza nie ma do nich dostępu. Trzeba JS.
Mój JavaScript nie wykonał się
  • Sprawdź czy strona pasuje do wzorca URL — pływający przycisk powinien być widoczny.
  • JS odpala się raz na życie strony — przeładuj (F5) po zmianie kodu.
  • Otwórz konsolę DevTools — błędy są logowane z prefiksem [JustZix].
  • Reguła musi być Włączona (sam status „Aktywny" nie wystarczy — sprawdź toggle).
Pływający przycisk się nie pojawia
  • URL nie pasuje do żadnego wzorca katalogu.
  • Przycisk został wcześniej ukryty na tej stronie — w popupie kliknij Przywróć.
  • Wtyczka jest globalnie wyłączona — toggle w popupie.
Po update wtyczki straciłem dane

Wtyczka ma stały klucz w manifeście — kolejne update'y zachowują dane. Jeśli zniknęły:

  • Aktualizuj zawsze nadpisując ten sam folder, nigdy przez „Usuń" + „Zainstaluj ponownie".
  • W chrome://extensions/ użyj odświeżenia, nie „Usuń" + „Dodaj".
  • Regularnie eksportuj ustawienia jako backup (Ustawienia → Eksport).
Konflikt z Content Security Policy (CSP) strony

JustZix używa chrome.scripting.executeScript by ominąć CSP — działa w 99% przypadków. Jeśli widzisz błędy CSP w konsoli, sprawdź czy odpalany skrypt to faktycznie Twój czy strony. CSP może też blokować inline event handlery w elementach HTML, które tworzysz z JS — używaj addEventListener.

2. Synchronizacja i udostępnianie

Czy synchronizacja jest obowiązkowa? Czy mogę używać wtyczki bez konta?

Synchronizacja jest w pełni opcjonalna. Bez konta wtyczka działa wyłącznie lokalnie w Twojej przeglądarce — żadne dane nie opuszczają Twojego komputera. Sync uruchamia się tylko jeśli sam to włączysz i wygenerujesz klucz synchronizacji.

Jak działa klucz synchronizacji?

To 25-znakowy klucz (SYNC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX) generowany lokalnie w Twojej przeglądarce przy użyciu kryptograficznej losowości. Backend nigdy nie widzi go w jawnej postaci — tylko jego SHA-256 hash. Aby zalogować się na drugim urządzeniu, wklej ten sam klucz.

Zgubiłeś go? Jeśli wcześniej dodałeś email, możesz go odzyskać przez Ustawienia → Odzyskaj klucz. Email odzyskiwania zawiera jednorazowy link wystawiający nowy klucz (stary przestaje działać).

Jak długo żyją udostępnione linki (shares)?

Wybierasz: 1h / 6h / 12h / 24h (domyślnie) / 48h. Po wygaśnięciu link zwraca 404 i dane zostają usunięte z backendu. Możesz też odwołać link wcześniej z panelu „Moje share".

Czy link share to sekret?

Token jest publicznym sekretem — każdy z linkiem pobierze zawartość. Nie wysyłaj na publicznych kanałach jeśli treść jest wrażliwa. Dla wrażliwych zestawów wybieraj krótszy TTL.

3. Prywatność i bezpieczeństwo

Jakie dane zbiera wtyczka?

Bez konta: nic nie opuszcza Twojej przeglądarki.

Z kontem (włączona synchronizacja): przechowujemy hash SHA-256 Twojego klucza synchronizacji, Twoje reguły CSS/JS i ich metadane, info o sesji urządzenia (UUID, IP, User-Agent), oraz opcjonalnie email jeśli go podasz. Pełna polityka prywatności →

Czy czytacie strony, które odwiedzam?

Nie. Wtyczka czyta jedynie to do których stron pasują Twoje reguły (matching wzorca URL) — i robi to w Twojej przeglądarce, nie na naszym serwerze. Historia przeglądania nigdy nigdzie nie trafia.

Czy są cookies lub trackery?

Strona justzix.com używa Google Analytics 4 wyłącznie po Twojej wyraźnej zgodzie (banner cookies u dołu strony). Bez zgody — żadne cookies analityczne nie są ustawiane, tag Google nawet się nie pobiera. Nie używamy Facebook Pixela, Hotjara ani innych trackerów firm trzecich.

Sama wtyczka nie zbiera żadnej telemetrii — ani historii przeglądania, ani statystyk użytkowania. Łączy się z naszym backendem wyłącznie kiedy sam włączysz synchronizację lub udostępnianie.

Czy mogę usunąć wszystkie swoje dane?

Tak, natychmiast. We wtyczce: Ustawienia → Konto → Usuń konto. Backend kaskadowo usuwa wszystko: sesje, reguły, backupy, share — bezpowrotnie. Albo napisz do support@justzix.com.

4. Cena i licencjonowanie

Czy JustZix jest darmowy?

Tak, w pełni darmowy. Brak płatnych planów, brak premium, brak limitów czasowych. Backend ma rozsądne limity użycia chroniące przed nadużyciem (sync rate, max rozmiar share, etc.), ale komfortowo pokrywają normalne użycie.

Czy w przyszłości będzie płatny plan?

Brak konkretnych planów. Jeśli kiedyś wprowadzimy płatne funkcje (np. konta zespołowe, dłuższy TTL share), istniejący darmowy tier zostanie darmowy dla obecnej funkcjonalności. O zmianach poinformujemy z dużym wyprzedzeniem przez aktualizacje Polityki prywatności i Regulaminu.

Czy kod źródłowy jest otwarty?

Aktualnie nie. Możemy otworzyć część kodu po publikacji wtyczki w Chrome Web Store i stabilizacji. Backend razem z wtyczką jest w monorepo na github.com/0beavis0/justzix (na razie prywatne).

5. Instalacja i aktualizacje

Kiedy wtyczka będzie dostępna w Chrome Web Store?

Wkrótce — finalizujemy publikację w Chrome Web Store. Wtyczka jest w pełni funkcjonalna i aktywnie rozwijana (ostatnio: przebudowany Output Console z zakładkami Network i DataLayer oraz interfejs w 8 językach). Do tego czasu można poprosić o early-access ZIP do instalacji w trybie deweloperskim: napisz na support@justzix.com.

Czy działa na Firefoksie, Edge i innych przeglądarkach?

Tak. JustZix ma teraz dedykowane buildy dla Chrome, Firefoksa, Edge i Opery — pobierzesz każdy z nich ze strony pobierania. Pozostałe przeglądarki oparte na Chromium (Brave, Vivaldi) działają z buildem dla Chrome, ale nie są oficjalnie testowane.

Jak działają aktualizacje?

Z Chrome Web Store: automatyczne, w tle, dane zostają.

Tryb deweloperski (early access): pobierz nowy ZIP, nadpisz ten sam folder, kliknij ikonę odświeżenia w chrome://extensions/. Klucz wtyczki w manifeście jest stały, więc ID rozszerzenia nie zmienia się między aktualizacjami.

Nie znalazłeś odpowiedzi? Napisz na support@justzix.com.