Skip to content
polar-commerce
← Wiedza

Rich Text Liquid Filter na Shopify — poradnik

Jak używać Rich Text Liquid Filter na Shopify. Formatowanie treści w metafields i sekcjach motywu.

Mateusz Śnieżek, Shopify Expert

Rich Text to typ danych w Shopify metafields, który pozwala przechowywać sformatowaną treść (nagłówki, listy, bold, italic, linki). Liquid filter `| metafield_tag` lub nowsze podejście `richtext` renderuje tę treść w motywie.

Czym jest Rich Text metafield?

Rich Text metafield przechowuje treść w formacie JSON, obsługując:

  • Nagłówki (H1-H6)
  • Paragrafy
  • Listy (numerowane i punktowane)
  • Bold i italic
  • Linki
  • Nie obsługuje: obrazów, tabel, embedów (do tego użyj HTML metafield)

    • Tworzenie Rich Text metafield

    W Shopify Admin

  • Settings → Custom data → Products (lub inny obiekt)
  • Add definition
  • Nazwa: np. "Szczegółowy opis"
  • Typ: Rich text
  • Zapisz

    • Edycja wartości

    Przy edycji produktu w sekcji Metafields pojawi się edytor WYSIWYG:

  • Nagłówki
  • Bold/italic
  • Listy
  • Linki

    • Wyświetlanie Rich Text w motywie

    Metoda 1: Dynamic sources (bez kodu)

    W edytorze motywu (Customize):

  • Dodaj sekcję "Rich text" lub "Custom Liquid"
  • Kliknij "Connect dynamic source"
  • Wybierz swój Rich Text metafield
  • Treść renderuje się automatycznie

    • Metoda 2: Liquid code

    W pliku sekcji/snippetu:

    {{ product.metafields.custom.detailed_description | metafield_tag }}

    Lub w nowszych wersjach:

    {{ product.metafields.custom.detailed_description.value }}

    Stylowanie Rich Text

    Rich Text renderuje standardowe tagi HTML (h2, h3, p, ul, ol, strong, em, a). Styluj je w CSS motywu:

    .metafield-rich-text h2 { font-size: 1.5em; margin-top: 1.5em; }
.metafield-rich-text ul { list-style: disc; padding-left: 1.5em; }
.metafield-rich-text a { color: var(--color-link); text-decoration: underline; }

    Zastosowania praktyczne

    1. Szczegółowy opis produktu

    Główny opis w standardowym polu, szczegóły (skład, instrukcje, FAQ) w Rich Text metafield. Wyświetl w zakładce lub accordion.

    2. Treści per kolekcja

    Rich Text metafield na kolekcji — opis SEO pod listą produktów.

    3. Dodatkowe informacje

  • Polityka zwrotów per produkt
  • Instrukcja użytkowania
  • Historia produktu / storytelling
  • Informacje o certyfikatach

    • Rich Text vs HTML metafield

    CechaRich TextHTML (single-line/multi-line)
    Edytor WYSIWYGTakNie (raw HTML)
    BezpieczeństwoSanitizedWymaga sanityzacji
    ElastycznośćOgraniczonaPełna
    ObrazyNieTak
    TabeleNieTak

    Użyj Rich Text dla bezpiecznej, prostej treści. HTML metafield dla zaawansowanych layoutów.

    Liquid filtry do tekstu

    Oprócz Rich Text, przydatne filtry Liquid do treści:

  • `| truncate: 200` — skraca tekst
  • `| strip_html` — usuwa tagi HTML
  • `| newline_to_br` — zamienia newline na `
    `
  • `| escape` — escapuje znaki specjalne
  • `| url_encode` — encoduje URL

    • Więcej o Liquid na Shopify.

    Podsumowanie

    Rich Text Liquid Filter to prosty sposób na dodanie sformatowanej treści do produktów i kolekcji na Shopify. Łatwy w użyciu dla marketerów, nie wymaga kodowania. Potrzebujesz zaawansowanych customizacji? Sprawdź nasze usługi.