FAQ — domande e risposte

Le domande più frequenti degli utenti dell'estensione — con risposte concrete.

1. Problemi tecnici

Il mio CSS non fa nulla — cosa sto sbagliando?

Tre cause comuni:

  • Specificità — il sito ha già i propri stili. Usa !important o selettori più specifici.
  • Nomi di classe dinamici — i framework generano .css-1abcd che cambiano tra le versioni. Mira invece ad attributi stabili (es. [data-testid="..."]).
  • Shadow DOM — alcuni elementi vivono in shadow root e il CSS esterno non può raggiungerli. Per quelli serve JS.
Il mio JavaScript non è stato eseguito
  • Controlla che il pattern URL corrisponda — il pulsante flottante dovrebbe essere visibile sulla pagina.
  • Il JS viene eseguito una volta per caricamento pagina — ricarica la pagina (F5) dopo una modifica.
  • Apri la console DevTools — gli errori sono registrati con il prefisso [JustZix].
  • La regola deve essere abilitata (solo «Attivo» non basta — controlla l'interruttore).
Il pulsante flottante non appare
  • L'URL non corrisponde a nessun pattern di cartella.
  • Il pulsante è stato nascosto in precedenza su questa pagina — apri il popup e clicca Ripristina.
  • L'estensione è disattivata globalmente — attivala nel popup.
Ho perso i miei dati dopo l'aggiornamento dell'estensione

L'estensione ha una chiave di manifest stabile — gli aggiornamenti preservano i dati. Se qualcosa è scomparso:

  • Aggiorna sempre sovrascrivendo la stessa cartella, non disinstallando e reinstallando.
  • In chrome://extensions/, usa il pulsante di aggiornamento — mai «Rimuovi» + «Aggiungi».
  • Esporta regolarmente le tue impostazioni come backup (Impostazioni → Export).
Conflitto con la Content Security Policy (CSP) del sito

JustZix usa chrome.scripting.executeScript per aggirare la CSP — funziona nel 99% dei casi. Se vedi errori CSP nella console, controlla se lo script interessato è davvero il tuo o quello della pagina. La CSP può anche bloccare i gestori di eventi inline negli elementi HTML che crei da JS — usa invece addEventListener.

2. Sincronizzazione e condivisioni

La sincronizzazione è obbligatoria? Posso usare l'estensione senza account?

La sincronizzazione è completamente facoltativa. Senza account, l'estensione funziona solo localmente nel tuo browser — nessun dato lascia la tua macchina. La sincronizzazione si attiva solo se la abiliti esplicitamente e generi una chiave di sincronizzazione.

Come funziona la chiave di sincronizzazione?

È una chiave di 25 caratteri (SYNC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX) generata localmente nel tuo browser con casualità crittografica. Il backend non la vede mai in chiaro — solo il suo hash SHA-256. Per accedere su un secondo dispositivo, incolla la stessa chiave.

Persa? Se in precedenza hai aggiunto un'e-mail, puoi recuperarla tramite Impostazioni → Recupera chiave. L'e-mail di recupero contiene un link monouso che emette una nuova chiave (la vecchia smette di funzionare).

Quanto durano i link condivisi?

Scegli tu: 1h / 6h / 12h / 24h (predefinito) / 48h. Dopo la scadenza, il link restituisce 404 e i dati vengono eliminati dal backend. Puoi anche revocare un link prima dal pannello «Le mie condivisioni».

Il link di condivisione è un segreto?

Il token è un segreto pubblico — chiunque abbia il link può scaricare il contenuto. Non pubblicarlo su canali pubblici se il contenuto è sensibile. Usa un TTL più breve per i set sensibili.

3. Privacy e sicurezza

Quali dati raccoglie l'estensione?

Senza account: nulla lascia il tuo browser.

Con account (sincronizzazione attiva): memorizziamo l'hash SHA-256 della tua chiave di sincronizzazione, le tue regole CSS/JS e i metadati, le info di sessione del dispositivo (UUID, IP, User-Agent) e opzionalmente un'e-mail se ne fornisci una. Informativa sulla privacy completa →

Leggete quali siti visito?

No. L'estensione legge solo a quali pagine si applicano le tue regole (corrispondenza del pattern URL) — e ciò avviene nel tuo browser, non sul nostro server. La cronologia di navigazione non viene mai inviata da nessuna parte.

Ci sono cookie o tracker?

Il sito justzix.com usa Google Analytics 4 solo con il tuo consenso esplicito (tramite il banner cookie). Senza consenso — non viene impostato alcun cookie analitico, nessun tag Google viene nemmeno caricato dalle nostre pagine. Nessun Facebook Pixel, Hotjar o altri tracker di terze parti, mai.

L'estensione stessa non raccoglie alcuna telemetria, nessuna cronologia di navigazione, nessuna analitica d'uso — comunica con il nostro backend solo per sync/condivisione quando abiliti esplicitamente quelle funzioni.

Posso eliminare tutti i miei dati?

Sì, istantaneamente. Nell'estensione: Impostazioni → Account → Elimina account. Il backend elimina a cascata: sessioni, regole, backup, condivisioni — tutto cancellato, irreversibile. Oppure scrivi a support@justzix.com.

4. Prezzi e licenze

JustZix è gratuito?

Sì, completamente gratuito. Nessun piano a pagamento, nessuna funzione premium, nessun limite di tempo. Il backend ha limiti d'uso ragionevoli per prevenire abusi (rate di sync, dimensione max di condivisione, ecc.) ma coprono comodamente l'uso normale.

Ci sarà un piano a pagamento in futuro?

Nessun piano definito. Se mai introdurremo funzioni a pagamento (es. account di team, TTL di condivisione più lungo), il livello gratuito esistente resterà gratuito per le funzionalità attuali. Annunceremo i cambiamenti con largo anticipo tramite gli aggiornamenti dell'Informativa sulla privacy e dei Termini di servizio.

Il codice sorgente è aperto?

Attualmente no. Potremmo rendere open source alcune parti dopo la pubblicazione dell'estensione nel Chrome Web Store e la sua stabilizzazione. Il backend è in un monorepo con l'estensione su github.com/0beavis0/justzix (al momento privato).

5. Installazione e aggiornamenti

Quando sarà disponibile l'estensione nel Chrome Web Store?

Presto — stiamo finalizzando la pubblicazione nel Chrome Web Store. L'estensione è pienamente funzionale e sviluppata attivamente (di recente: una Output Console ricostruita con le schede Network e DataLayer e un'interfaccia in 8 lingue). Fino ad allora, puoi richiedere uno ZIP early-access per l'installazione in modalità sviluppatore: scrivi a support@justzix.com.

Funziona su Firefox, Edge e altri browser?

Sì. JustZix ora ha build dedicati per Chrome, Firefox, Edge e Opera — li trovi tutti nella pagina di download. Gli altri browser basati su Chromium (Brave, Vivaldi) funzionano con il build per Chrome, ma non sono testati ufficialmente.

Come funzionano gli aggiornamenti?

Dal Chrome Web Store: automatici, in background, i tuoi dati persistono.

Modalità sviluppatore (early access): scarica il nuovo ZIP, sovrascrivi la stessa cartella, clicca l'icona di aggiornamento in chrome://extensions/. La chiave dell'estensione nel manifest è stabile, quindi l'ID dell'estensione non cambia tra gli aggiornamenti.

Non hai trovato la risposta? Scrivi a support@justzix.com.