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
!importantalbo bardziej specyficznych selektorów. - Dynamiczne klasy — frameworki generują
.css-1abcdktó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.