Queste guide descrivono Toimii dopo il lancio. Il pannello e la fatturazione non sono ancora disponibili — Toimii sarà disponibile nel 2026.

Come incorporare un modulo di contatto su Shopify con Custom Liquid

Una sezione Custom Liquid in qualsiasi tema. Nessuna app da installare, nessuna conoscenza di Liquid richiesta — basta incollare le due righe.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-contact></toimii-contact>

Funziona davvero?

Sì — su tutti i temi Shopify che supportano Online Store 2.0 (Dawn e qualsiasi tema moderno). La sezione Custom Liquid è integrata in Shopify; nessuna app da installare, nessuna modifica al codice del tema richiesta per la maggior parte delle pagine.

Passo dopo passo

Apri l'editor del tema

Dal pannello amministratore di Shopify, vai su Negozio online → Temi → Personalizza sul tema che vuoi modificare.

Aggiungi una sezione Custom Liquid

Scegli la pagina in cui deve apparire il modulo (una Pagina, la pagina Contatti o qualsiasi template di pagina). Clicca su Aggiungi sezione e scegli Custom Liquid.

Incolla il codice di incorporamento

Incolla le due righe dal tuo pannello Toimii nel campo Liquid. Liquid passa l'HTML grezzo invariato, quindi il tag script e l'elemento personalizzato funzionano così come sono.

Salva il tema

Salva nell'editor del tema. Il modulo è attivo sullo storefront immediatamente.

Testa sullo storefront live

Apri la pagina live (non l'anteprima) e invia un messaggio di prova per confermare che funzioni dall'inizio alla fine. Se qualcosa non va, consulta le trappole comuni qui sotto.

Trappole comuni

Le modifiche dirette a theme.liquid vengono sovrascritte all'aggiornamento del tema. Usa la sezione Custom Liquid nell'editor del tema (salvata per pagina) oppure duplica il tema prima di modificare i file principali.
Custom Liquid nelle pagine di checkout richiede Shopify Plus. Con i piani standard, incorpora su pagine di contatti, FAQ o prodotti.
Alcuni temi hanno un CSP integrato che blocca gli script di terze parti. Se il modulo non viene renderizzato, autorizza cdn.toimii.io e api.toimii.io in script-src / connect-src.
L'anteprima dell'editor del tema a volte carica le sezioni in modo lazy, il che può compromettere il primo rendering degli elementi personalizzati. Verifica sull'URL live dello storefront (o usa il pulsante "Visualizza") — l'anteprima non è la fonte di verità.
Se inserisci il modulo in un blocco Liquid {% if %}, lo script si carica comunque su ogni pagina. Per risparmiare byte, condiziona anche il tag script con la stessa condizione.

Domande frequenti

Ho bisogno di un'app Shopify dall'App Store?

No. Custom Liquid è una sezione tema integrata in Shopify — tutti i temi da Dawn in poi la supportano. Gli app store sono pieni di app "modulo di contatto"; non ne hai bisogno per Toimii.

Posso incorporarlo nella pagina di checkout?

Non con i piani standard. Custom Liquid nelle pagine di checkout richiede Shopify Plus. Con i piani non-Plus, incorpora il modulo su una pagina di contatti, FAQ o sullo stato dell'ordine post-acquisto.

Gli aggiornamenti del tema sovrascrivono il mio codice di incorporamento?

Sì — le modifiche dirette ai file del tema (theme.liquid, sections/*.liquid) vengono sovrascritte quando aggiorni o ripristini il tema. Due opzioni più sicure: usa una sezione tema + blocco Custom Liquid (salvato per pagina nell'editor del tema), oppure duplica il tema prima di modificarlo.

Il mio store ha un Content-Security-Policy — blocca Toimii?

Alcuni store hanno un Content-Security-Policy rigido tramite impostazioni del tema o app come i temi Online Store 2.0 di Shopify con intestazioni CSP. Se il modulo non viene renderizzato, autorizza in script-src: cdn.toimii.io e api.toimii.io.

Funzionerà su un sito Storefront API personalizzato (Hydrogen, Next.js)?

Sì. Usa App Bridge per renderizzare un contenitore HTML, poi inietta il tag script e l'elemento personalizzato al suo interno. Stesso approccio: due righe di codice, l'elemento personalizzato fa il resto.

Stai incorporando su una piattaforma diversa?

Le stesse due righe di codice, spiegate per ogni piattaforma.

WordPress

Blocco HTML personalizzato, Block Editor o Classico. Nessuna installazione di plugin. Una cosa da sapere — il tuo ruolo utente deve avere la capacità unfiltered_html.

Leggi la guida completa

Squarespace

Inserisci un Blocco Codice su qualsiasi pagina. Richiede il piano Core (rinominato nel 2025 da Business) o superiore.

Leggi la guida completa

Webflow

L'elemento Code Embed può contenere fino a 50.000 caratteri. Il codice personalizzato richiede il piano Basic o superiore. Pubblica per vedere il risultato.

Leggi la guida completa

Wix

Wix esegue il widget Embed in un iframe sandbox, quindi usiamo un metodo diviso — script in Impostazioni → Codice personalizzato, tag tramite Incorpora un widget. Guida onesta.

Leggi la guida completa

Siti statici

Astro, Hugo, 11ty, Jekyll — le stesse due righe nel template del layout. Le build rimangono veloci.

Leggi la guida completa

HTML / Personalizzato

Basta una pagina HTML semplice. Aprila in un editor di testo, incolla, salva, carica. Tre passi e sei online.

Leggi la guida completa

React / Vue / Angular

Usa l'elemento personalizzato direttamente in JSX, nei template Vue o nei componenti Angular. Nessun componente wrapper, nessun pacchetto aggiuntivo.

Leggi la guida completa

Pronto a provare?

30 giorni di prova gratuita. Nessuna carta di credito. Pronto in pochi minuti.

Nessuna carta di credito. Pronto in 2 minuti.