# Usare Footnote su una vetrina Catalyst
> Configura Footnote su una vetrina Catalyst: le versioni compatibili, cosa deve mantenere il tuo sviluppatore e cosa controllare se manca un’etichetta.
Ultimo aggiornamento: 2026-10-20
Le etichette Footnote funzionano su Catalyst, la vetrina BigCommerce basata
su Next.js, dalla versione 1.4. Il supporto per Catalyst è in beta.
Abbiamo testato lo script delle etichette su Catalyst 1.12 standard, ma non
ancora sulla versione di Catalyst personalizzata da un negozio, quindi se
qualcosa in questa pagina non corrisponde a ciò che vedi, faccelo sapere.
Catalyst è codice che appartiene al tuo team, quindi gran parte di questa
pagina è per chi se ne occupa. Mandagli il link.
## Controlla la tua versione di Catalyst
Le etichette richiedono Catalyst core 1.4 o successivo. Catalyst carica gli
script di Script Manager tramite il suo gestore del consenso ai cookie
dalla versione 1.3, e la 1.4 ha aggiunto il posizionamento nell’intestazione
e nel corpo della pagina su cui si basa lo script di Footnote. La versione
si trova in `core/package.json`, sotto il nome `@bigcommerce/catalyst-core`.
Un aggiornamento di Catalyst rilasciato da BigCommerce arriva alla tua
vetrina solo quando il tuo sviluppatore lo unisce alla tua copia, quindi
una vetrina più vecchia resta sulla sua versione finché qualcuno non la
aggiorna.
## Mantieni il gestore del consenso nel layout principale
Catalyst carica gli script di Script Manager tramite il componente
`` in `core/app/[locale]/layout.tsx`. Se viene rimosso o
sostituito, lo script di Footnote non si carica mai e non compare nessuna
etichetta. Footnote non può accorgersene da BigCommerce, quindi
Impostazioni continua a indicare la vetrina come coperta.
## Lascia lo script nella categoria «Essential»
Footnote aggiunge uno script a Script Manager, chiamato «Footnote AI image
labels», con la categoria di consenso «Essential» (essenziale). Il banner
dei cookie di Catalyst tratta gli script «Essential» come necessari, quindi
lo script si carica prima che il cliente scelga e anche dopo che ha
rifiutato i cookie. Non imposta cookie e non raccoglie nulla sui clienti.
Se qualcuno cambia la categoria in «Functional», «Analytics» o
«Targeting», i clienti che rifiutano i cookie non vedono più le etichette.
Riportala a «Essential» in Script Manager.
## Tieni le immagini prodotto sulla CDN di BigCommerce
Footnote trova un’immagine etichettata tramite il suo indirizzo sulla CDN
di BigCommerce, che contiene i numeri del prodotto e dell’immagine, ad
esempio `cdn11.bigcommerce.com/s-abc123/images/stencil/384w/products/157/551/`.
Catalyst standard mostra le immagini prodotto direttamente da
quell’indirizzo, quindi funziona senza modifiche. Funzionano anche le
immagini che passano dall’ottimizzazione delle immagini di Next.js
(`/_next/image?url=...`), perché Footnote legge l’indirizzo originale al
loro interno.
Le etichette spariscono quando l’indirizzo di un’immagine non contiene più
il percorso BigCommerce. Succede con un loader di immagini personalizzato
che riscrive l’indirizzo, con un proxy o un altro servizio di immagini
davanti alla CDN, o con immagini inserite tramite Makeswift.
## Consenti Footnote in una Content Security Policy personalizzata
Catalyst standard non limita le origini da cui si caricano gli script. Se
il tuo sviluppatore ha aggiunto regole `script-src` o `connect-src`,
consenti `https://footnote.pouchapps.com` in entrambe. Lo script delle
etichette si carica da lì e da lì recupera le impostazioni delle tue
etichette.
## Prevedi fino a un’ora per le modifiche
Catalyst tiene in cache l’elenco degli script di Script Manager fino a
un’ora. Dopo l’installazione di Footnote, o dopo qualsiasi modifica alle
tue etichette, la vetrina può impiegare tutto quel tempo per aggiornarsi.
Su Stencil le stesse modifiche compaiono entro circa un minuto.
Uno sviluppatore può far comparire le modifiche prima in due modi:
- **Ripubblicare la vetrina.** Un nuovo deploy recupera di nuovo l’elenco
degli script. È la soluzione più semplice dopo aver installato Footnote.
- **Abbassare `DEFAULT_REVALIDATE_TARGET`.** Il valore è in secondi e per
impostazione predefinita è 3600. Stabilisce per quanto tempo Catalyst
tiene in cache gran parte dei suoi dati BigCommerce, non solo gli
script, quindi un numero più basso significa più richieste a
BigCommerce. Abbassalo per i test invece di lasciarlo basso.
## Controlla che le etichette compaiano
1. In Footnote, apri Impostazioni e controlla che la tua vetrina Catalyst
sia indicata come coperta. Essentials copre solo la tua vetrina
predefinita. Pro copre tutte le vetrine.
2. Contrassegna un’immagine come Generata con IA e attiva «Mostra
etichette» in Impostazioni.
3. Aspetta fino a un’ora, o chiedi al tuo sviluppatore di ripubblicare.
4. Apri quella pagina prodotto in una finestra di navigazione privata. Se
compare un banner dei cookie, rifiuta. L’etichetta dovrebbe trovarsi
nell’angolo che hai scelto nella scheda Badge. Su Catalyst compare un
attimo dopo la pagina, quando la pagina ha finito di caricare i suoi
script.
Per controllare dal browser, apri la console per sviluppatori su una
qualsiasi pagina della vetrina ed esegui
`document.documentElement.dataset.footnote`. Se restituisce `"1"`, lo
script di Footnote è in esecuzione lì.
## Risolvi un’etichetta mancante
**Se il controllo nella console non restituisce `"1"`**, la vetrina non sta
eseguendo lo script di Footnote. Controlla questi punti nell’ordine:
1. Aspetta che passi l’ora, o ripubblica.
2. Impostazioni indica la vetrina come coperta.
3. Catalyst core è alla versione 1.4 o successiva.
4. `` è ancora in `core/app/[locale]/layout.tsx`.
5. Lo script è impostato su «Essential» in Script Manager.
6. Qualsiasi Content Security Policy personalizzata consente
`https://footnote.pouchapps.com`.
**Se restituisce `"1"` ma l’immagine non ha un’etichetta**, lo script è in
esecuzione ma non ha riconosciuto l’immagine:
- Controlla che in Footnote l’immagine sia contrassegnata come Generata con
IA o Modificata con IA.
- Fai clic con il tasto destro sull’immagine, copia il suo indirizzo e
controlla che contenga `/products/` seguito da due numeri. Se non lo
contiene, l’immagine non arriva dalla CDN di BigCommerce in una forma che
Footnote possa riconoscere.
- Nella scheda Badge, controlla che «Categorie e risultati di ricerca» sia
attivo. Le pagine Catalyst non hanno alcun indicatore che dica a
Footnote che una pagina è una pagina prodotto, quindi quell’opzione copre
anche le pagine prodotto di Catalyst.
Se sei ancora bloccato, scrivi a [footnote@pouchapps.com](mailto:footnote@pouchapps.com) indicando
l’indirizzo della tua vetrina, una pagina prodotto che dovrebbe mostrare
un’etichetta, la tua versione di Catalyst e il risultato del controllo
nella console. La [pagina di assistenza](https://pouchapps.com/footnote/it/support/) elenca i
motivi per cui un’etichetta può mancare su qualsiasi vetrina.
Footnote ti aiuta a etichettare le immagini. Non stabilisce quali immagini la legge ti impone di etichettare e non costituisce consulenza legale.