Collegare Shopify in sicurezza

Questa guida descrive Fy2Press 1.0.0. Le schermate possono cambiare nelle versioni successive, quindi controlla la versione indicata nella schermata Plugin prima di seguirla.

Risultato atteso

Il tuo negozio Shopify è collegato con il suo indirizzo e un token pubblico Storefront API, il test di connessione riesce e Fy2Press non mostra più il negozio come Disconnesso.

Crea un token pubblico Storefront API nel canale Headless di Shopify, inseriscilo con l’indirizzo del negozio e prova la connessione.

Prima di iniziare

• Il permesso di gestire i canali di vendita nell’amministrazione Shopify del negozio.
• Fy2Press installato, con la sua schermata Home aperta.
• L’indirizzo myshopify.com del negozio, ad esempio example-store.myshopify.com.
• Un hosting WordPress che consente richieste HTTPS in uscita verso Shopify.

Prima di iniziare, prevedi un modo per tornare indietro: un backup o una copia di staging, il prodotto Shopify con cui farai il confronto e la pagina WordPress che deve mostrare il risultato. Comincia con un piccolo test che puoi ripetere.

Cosa copre questa guida

FREE collega un solo negozio Shopify. Il campo richiede un token pubblico Storefront API: un token privato o un token dell’API Admin non può sostituirlo. Un test riuscito conferma l’accesso al catalogo; non viene ancora sincronizzato nulla. Il tutorial di Shopify prosegue con un token privato per il codice lato server, che non è il valore usato da Fy2Press.

Tieni presente chi fa cosa: Shopify gestisce prodotti, inventario, ordini, pagamenti e checkout; Fy2Press porta il catalogo in WordPress e lo mostra; WordPress ospita le tue pagine e i tuoi contenuti editoriali. Nulla in questa guida sposta ordini, clienti o pagamenti in WordPress.

Passaggi

1. In Shopify, installa il canale di vendita Headless dallo Shopify App Store se non è ancora presente, poi aprilo.
2. Scegli Create storefront, oppure apri lo storefront che usi già per WordPress, poi apri le sue impostazioni Storefront API.
3. Copia il token pubblico Storefront API. Insieme al titolare del negozio, attiva solo questi permessi Storefront API: prodotti e collezioni (unauthenticated_read_product_listings), tag dei prodotti (unauthenticated_read_product_tags), inventario dei prodotti (unauthenticated_read_product_inventory) e lettura e modifica del carrello (unauthenticated_read_checkouts, unauthenticated_write_checkouts). Lascia disattivati i permessi su clienti, contenuti e metaoggetti: Fy2Press non legge dati di clienti o ordini.
4. In WordPress, apri Fy2Press → Impostazioni di connessione. In URL del negozio, digita solo la parte prima di .myshopify.com, poi incolla il token in Token pubblico Storefront API.
5. Seleziona Test connessione, conferma che si tratta del negozio giusto, poi seleziona Salva impostazioni.

Controlla il risultato prima di rendere pubblica una pagina. Un messaggio di successo è un buon segno, ma anche la pagina pubblica e il percorso d’acquisto su Shopify devono corrispondere.

Controlla il risultato

• Stato connessione non indica più Disconnesso dopo il test.
• La schermata Home non ti chiede più di collegare Shopify.
• Il token resta nascosto nella schermata delle impostazioni, a meno che tu non selezioni Mostra, e non compare mai nelle pagine pubbliche.

Controlla il risultato dove lo vedranno i visitatori: apri la pagina pubblica di WordPress, non solo la schermata di Fy2Press, e confronta un prodotto rappresentativo con Shopify, compresi prezzo, disponibilità, varianti e collezione. Ripeti una volta una piccola modifica per confermare che il comportamento è stabile.

Problemi frequenti

• Unauthorized: il token non è il token pubblico Storefront, appartiene a un altro negozio o è stato revocato.
• Store not found: digita solo il sottodominio myshopify.com, senza https://, senza percorso e senza il tuo dominio personalizzato.
• Errore di rete: chiedi al tuo provider di hosting se WordPress può effettuare richieste HTTPS in uscita verso Shopify e invia il messaggio di errore, mai il token.

Quando succede qualcosa di inatteso, interrompi le operazioni di grandi dimensioni e riprova con un solo prodotto e una sola pagina. Conserva il messaggio di errore esatto prima di modificare le impostazioni o svuotare le cache.

Risoluzione dei problemi

1. Conferma la versione e l’edizione del plugin (FREE o PRO).
2. Riproduci il problema con un solo prodotto di prova.
3. Stabilisci se il problema viene da Shopify, da Fy2Press o dal tuo tema WordPress.
4. Confronta il risultato con ciò che include la tua edizione, come descritto nella guida alle edizioni.
5. Ripristina la configurazione di prova, riprova una volta e annota se il risultato si ripete.

Sicurezza e dati

Il token pubblico è pensato per le richieste dello storefront, ma tienilo fuori da screenshot, messaggi all’assistenza e documenti condivisi. Non inserire mai in Fy2Press un token Storefront privato o un token dell’API Admin.

Se chiedi aiuto, annota la versione del plugin, le versioni di WordPress e PHP, il tuo tema o page builder, l’indirizzo della pagina e i passaggi che hai seguito. Usa prodotti di prova e, prima di condividere gli screenshot, rimuovi token, dati dei clienti, dettagli degli ordini e indirizzi privati.

Effetto sui motori di ricerca

Collegare un negozio non crea alcuna pagina pubblica. Prima di sincronizzare, decidi in Google e SEO se l’indirizzo principale dei prodotti deve stare su WordPress o su Shopify.

Informazioni per l’assistenza

Se chiedi aiuto, annota la versione del plugin, le versioni di WordPress e PHP, il tuo tema o page builder, l’indirizzo della pagina e i passaggi che hai seguito. Usa prodotti di prova e, prima di condividere gli screenshot, rimuovi token, dati dei clienti, dettagli degli ordini e indirizzi privati.

Guide correlate

• Installazione
• Pubblicare con WordPress
• Google e SEO
• Sicurezza e dati

Versione e disponibilità

Documentazione di Fy2Press 1.0.0. Il plugin gratuito è disponibile su WordPress.org. PRO è venduto separatamente tramite Freemius, il nostro fornitore di licenze e pagamenti.