Inizia a creare

Guida · 6 passaggi · circa 5 minuti

Come aggiungere una sezione personalizzata su Shopify

Una sezione personalizzata è un singolo file .liquid nel tuo tema. Per aggiungerne una non serve un'app: crea il file nell'editor del codice, incolla il codice e la sezione compare nell'editor del tema accanto a quelle del tema stesso. Ecco l'intero procedimento, poi le soluzioni ai tre problemi più comuni.

Cosa ti serve

  • Un negozio Shopify e il permesso di modificarne il tema (titolare del negozio o collaboratore con accesso ai Temi).
  • Il codice della sezione: un file .liquid che termina con un tag {% schema %}. Scrivilo tu, generalo con Klorr o prendine uno dal marketplace.
  • Un tema Online Store 2.0, se vuoi la sezione anche su pagine diverse dalla home page.

Passo dopo passo

  1. Prima di tutto, duplica il tema

    Nel pannello di controllo Shopify, vai su Negozio online → Temi. Accanto al tema attuale, apri il menu … e scegli Duplica. Lavora sulla copia, così il negozio online resta intatto finché non sei soddisfatto.

  2. Apri l'editor del codice

    Sulla copia, apri di nuovo il menu … e scegli Modifica codice. Le cartelle del tema — layout, sections, snippets, assets e le altre — sono elencate a sinistra.

  3. Crea il file della sezione

    Nella cartella sections, scegli Aggiungi una nuova sezione (nell'editor più recente, il + accanto alla cartella, poi Nuovo file). Dagli un nome che dica cosa fa, ad esempio countdown-banner. Shopify crea sections/countdown-banner.liquid con del codice di esempio.

  4. Incolla il codice e salva

    Seleziona tutto nel nuovo file, sostituiscilo con il codice della tua sezione — compreso il blocco {% schema %} alla fine — e fai clic su Salva. Se Shopify mostra un errore, trovi le soluzioni più sotto.

  5. Aggiungila nell'editor del tema

    Torna a Temi e fai clic su Personalizza sulla copia. Apri la pagina che vuoi — home, prodotto, collezione — e fai clic su Aggiungi sezione nella barra laterale sinistra. La tua sezione compare con il nome indicato nel suo schema.

  6. Configurala e pubblica

    Compila le impostazioni della sezione — testi, immagini, colori — trascinala al suo posto e fai clic su Salva. Quando l'anteprima ti convince, pubblica la copia dalla pagina Temi.

Una sezione completa da provare

Incollala in un nuovo file di sezione per vedere l'intero procedimento funzionare. È un titolo, una riga di testo e un pulsante, tutti modificabili dall'editor del tema.

sections/promo-banner.liquid
<div class="promo-{{ section.id }}">
  <h2>{{ section.settings.heading | escape }}</h2>
  <p>{{ section.settings.text | escape }}</p>
  {% if section.settings.button_label != blank %}
    <a href="{{ section.settings.button_link }}">{{ section.settings.button_label | escape }}</a>
  {% endif %}
</div>

{% style %}
  .promo-{{ section.id }} {
    padding: 48px 20px;
    text-align: center;
    background: {{ section.settings.background }};
  }
{% endstyle %}

{% schema %}
{
  "name": "Promo banner",
  "tag": "section",
  "settings": [
    { "type": "text", "id": "heading", "label": "Heading", "default": "Free shipping this week" },
    { "type": "text", "id": "text", "label": "Text", "default": "On every order over $50." },
    { "type": "text", "id": "button_label", "label": "Button label", "default": "Shop now" },
    { "type": "url", "id": "button_link", "label": "Button link" },
    { "type": "color", "id": "background", "label": "Background", "default": "#f1ecfb" }
  ],
  "presets": [{ "name": "Promo banner" }]
}
{% endschema %}

Generatore di schema →

Quando non funziona

La sezione non compare in Aggiungi sezione

Lo schema non ha preset. Aggiungi "presets": [{ "name": "Countdown banner" }] allo schema. Controlla anche enabled_on o disabled_on, che limitano dove la sezione può essere inserita; e su un tema vintage le sezioni si possono aggiungere solo alla home page.

Shopify non salva il file

L'errore indica il problema. "Invalid JSON in tag 'schema'" (JSON non valido) è una virgola finale di troppo, un apice singolo o una parentesi mancante. "Setting IDs must be unique" significa che due impostazioni condividono lo stesso ID. Il nostro generatore di schema gratuito controlla entrambi prima che tu incolli.

Le modifiche non si vedono nel negozio

Probabilmente stai guardando il tema pubblicato mentre modifichi la copia. Visualizza l'anteprima della copia dalla pagina Temi, oppure pubblicala quando è pronta.

Perché aggiungere una sezione senza app

  • Nessun canone mensile: la sezione fa parte del tuo tema, non di un abbonamento.
  • Niente di extra da caricare: lo script di un'app può girare su ogni pagina, il codice di una sezione solo dove c'è la sezione.
  • Resta anche quando le app se ne vanno: disinstallare un'app può lasciare buchi nelle pagine che ha costruito. Un file di sezione resta finché non lo elimini.

Domande frequenti

Posso aggiungere una sezione personalizzata su Shopify senza app?

Sì. Una sezione è un file .liquid nella cartella sections del tuo tema. Crealo da Negozio online → Temi → Modifica codice, incolla il codice e aggiungi la sezione dall'editor del tema. Nessuna app coinvolta.

La mia sezione personalizzata sopravvive a un aggiornamento del tema?

Aggiornare un tema a una nuova versione porta con sé ciò che hai impostato nell'editor del tema, ma non i file aggiunti nell'editor del codice. Conserva una copia del file della sezione e aggiungilo di nuovo al tema aggiornato.

Posso usare la stessa sezione su più pagine?

Sì: su un tema Online Store 2.0 puoi aggiungerla a qualsiasi template, e ogni copia ha le sue impostazioni, a meno che lo schema non limiti dove può essere inserita.

Come faccio a sapere se il mio tema è Online Store 2.0?

Apri l'editor del tema e vai su una pagina prodotto. Se lì puoi fare clic su Aggiungi sezione, il tema è 2.0. Se le sezioni si possono aggiungere solo alla home page, è un tema vintage.

Dove trovo il codice per una sezione personalizzata?

Scrivilo tu, scegline uno pronto sul marketplace di Klorr, oppure descrivi cosa vuoi e lascia che sia Klorr a scriverlo: Liquid, CSS, JavaScript e schema in un solo file.

Fatti scrivere l'intera sezione da Klorr

Descrivi la sezione che vuoi. Klorr scrive il Liquid, il CSS, lo schema e ogni impostazione dell'editor del tema: codice che vive nel tuo tema e resta tuo.