Przejdź do głównej treści
Edytor kodu daje Ci pełną kontrolę nad szablonem. Szablony to HTML i CSS z Liquid, tym samym językiem szablonów, którego używa Shopify: {{ order_name }} wyświetla nazwę zamówienia, a {% for line_item in line_items %} powtarza się dla każdej pozycji. Zmienne zamówienia w Foliant odpowiadają zmiennym z Shopify Order Printer, więc napisane dla niego szablony zwykle działają bez zmian. Edytor kodu jest dostępny w każdym planie.

Otwórz edytor kodu

Otwórz szablon w edytorze i kliknij kartę Kod. Szablony kodowe otwierają się od razu tutaj. W przypadku szablonu wizualnego najpierw widzisz skompilowany kod. Kliknij Edytuj kod, aby go zmienić. Zobacz Przełączanie między trybem wizualnym a kodem. Lewy panel ma trzy karty: Prawy panel to podgląd na żywo. Odświeża się chwilę po tym, jak przestaniesz pisać.

Wstaw pole

  1. Ustaw kursor tam, gdzie ma się znaleźć pole.
  2. Kliknij Wstaw pole.
  3. Wyszukaj pole (na przykład „tracking” lub „SKU”) w polu Szukaj pól i kliknij je.
Foliant wstawi jego kod Liquid w miejscu kursora, na przykład {{ shipping_address.city }}. Pola pozycji, takie jak {{ line_item.sku }}, działają tylko wewnątrz pętli pozycji. Aby wstawić samą pętlę, wybierz Pozycje zamówienia.

Przeszukaj kod

Kliknij przycisk wyszukiwania obok Wstaw pole (lub naciśnij ⌘F / Ctrl+F w kodzie), aby znaleźć tekst w szablonie.

Błędy w kodzie

Edytor sprawdza Twój kod podczas pisania i oznacza problemy na marginesie:
  • Błędy blokują zapisywanie i wstrzymują podgląd. Niezamknięte {{ lub {% to błąd. Błędy są wymienione w banerze Błędy w kodzie nad edytorem, każdy z przyciskiem Przejdź do wiersza.
  • Ostrzeżenia wskazują rzeczy, które mogą być nieprawidłowe, ale nie blokują zapisywania, na przykład nieznany filtr, tag lub obiekt Liquid, nieznany tag HTML lub właściwość CSS albo niezamknięty tag HTML.
Podczas zapisywania Foliant również sprawdza szablon: kod Liquid musi być czytelny, tagi HTML muszą być zrównoważone, a osadzony SVG może zawierać tylko elementy rysunkowe. Jeśli coś jest nie tak, zapis się nie powiedzie, a baner Nie udało się zaktualizować wyświetli do pięciu problemów, z numerami wierszy, jeśli są znane. Jeśli szablon się zapisze, ale nie da się wyświetlić podglądu, baner pokaże komunikat Liquid i wiersz, jeśli jest znany.

Pisz dobre szablony

  • Kwoty są podawane w groszach (centach): zawsze wyświetlaj je z filtrem kwot, na przykład {{ total_price | money }}. Zobacz Kwoty i waluty w szablonach.
  • Używaj | escape dla tekstu wpisanego przez klientów, takiego jak uwagi i adresy: {{ note | escape }}.
  • Używaj {{ 'subtotal' | t }} dla tekstów, które mają być w języku dokumentu. Zobacz Daty, języki i tłumaczenia.
  • Do VAT używaj wbudowanych fragmentów Foliant: {% include 'vat_breakdown' %} wyświetla tabelę rozbicia VAT, a {% include 'legal_notes' %} adnotacje prawne (odwrotne obciążenie, eksport, IOSS…).

Warto wiedzieć

  • Jeśli szablon numerowany (faktura, faktura korygująca lub oferta) nigdzie nie wyświetla document_number, Foliant doda na końcu dokumentu mały wiersz z numerem. Zobacz Numery dokumentów w szablonach.
  • Numery stron i powtarzane nagłówki tabel dla szablonów kodowych ustawisz na stronie ustawień szablonu, w sekcji Układ strony.
  • Aby przenieść szablon z Shopify Order Printer lub Order Printer Pro, użyj opcji Importuj szablon na stronie Szablony. Zobacz Importowanie szablonu z Order Printer.

Powiązane artykuły