Dostępne filtry

Spis treści

Tablice

W skład tych filtrów wchodzą:

First	Randomize
Last	Join
Skip	Map
Take	Size
Sort	Uniq
Reverse

Tekstowe

W skład tych filtrów wchodzą:

Format	Size
Append	Slice
Prepend	Split
Capitalize	StripHtml
Downcase	StripNewlines
Upcase	NewlineToBr
Remove	Truncate
RemoveFirst	TruncateWords
Replace	Times
ReplaceFirst

Liczbowe, Matematyczne

W skład tych filtrów wchodzą:

Plus	Normalize
Minus	Floor
Times	Ceil
DividedBy	Abs
Modulo	Round

Data i czas

W skład tych filtrów wchodzą:

Date

Cena

W skład tych filtrów wchodzą:

ToPrice

HTML

Filtry, które po zastosowaniu zwracają gotowe fragmenty kodów HTML do wykorzystania na stronie.

W skład tych filtrów wchodzą:

A	Img2
Img

Pozostałe

W skład tych filtrów wchodzą:

H	ToInt
Escape	ToNum
EscapeUri	ToTimeSpan
UnEscapeUri	DEBUG
ToString

Opis dostępnych filtrów:

First

Pobiera pierwszy element z tablicy.

Zwracany typ: zależny co przechowuje tablica.


{{ product-details.Product.Images |First |Img }}

Last

Pobiera ostatni element z tablicy.

Zwracany typ: zależny co przechowuje tablica.


{{ product-details.Product.Images |Last |Img }}

Skip

Zwraca tablicę, która nie zawiera początkowych elementów z tablicy wejściowej. Omija określoną liczbę elementów. Liczba elementów do ominięcia jest przekazywana w parametrze.

Parametry: int.
Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign kolory = koloryTekst |Split: ',' %}

Wszystkie elementy
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

Pomiń 3 pierwsze elementy
{% assign kolory = kolory |Skip: 3 %}
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign kolory = koloryTekst |Split: ',' %}

Wszystkie elementy

{% for kolor in kolory -%}

{% endfor -%}

Pomiń 3 pierwsze elementy

{% assign kolory = kolory |Skip: 3 %}

{% for kolor in kolory -%}

{% endfor -%}

Powyższy przykład zwróci:


Wszystkie elementy
biały
czarny
zielony
czerwony
niebieski
żółty

Pomiń 3 pierwsze elementy
czerwony
niebieski
żółty

Wszystkie elementy

biały

czarny

zielony

czerwony

niebieski

żółty

Pomiń 3 pierwsze elementy

czerwony

niebieski

żółty

Take

Zwraca tablicę, która zawiera tylko określoną liczbę początkowych elementów z tablicy wejściowej.

Parametry: int.
Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign kolory = koloryTekst |Split: ',' %}

Wszystkie elementy
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

Pobierz tylko 3 pierwsze elementy
{% assign kolory = kolory |Take: 3 %}
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign kolory = koloryTekst |Split: ',' %}

Wszystkie elementy

{% for kolor in kolory -%}

{% endfor -%}

Pobierz tylko 3 pierwsze elementy

{% assign kolory = kolory |Take: 3 %}

{% for kolor in kolory -%}

{% endfor -%}

Powyższy przykład zwróci:


Wszystkie elementy
biały
czarny
zielony
czerwony
niebieski
żółty

Pobierz tylko 3 pierwsze elementy
biały
czarny
zielony

Wszystkie elementy

biały

czarny

zielony

czerwony

niebieski

żółty

Pobierz tylko 3 pierwsze elementy

biały

czarny

zielony

Sort

Sortuje elementy w tablicy według przekazanego argumentu. Argument powinien być właściwością kolekcji elementów tablicy wejściowej.

Parametry: string.
Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign sortedFlags = product-details.Product.Flags |Sort: 'Text' %}
{% for flag in sortedFlags -%}
Nazwa: {{ flag.Text}}
{% endfor -%}

{% assign sortedFlags = product-details.Product.Flags |Sort: 'Text' %}

{% for flag in sortedFlags -%}

Nazwa: {{ flag.Text}}

{% endfor -%}

Reverse

Odwraca kolejność elementów w tablicy.

Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign kolory = koloryTekst |Split: ', ' %}
{% assign kolory = kolory |Reverse %}

Wszystkie elementy w odwróconej kolejności
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign kolory = koloryTekst |Split: ', ' %}

{% assign kolory = kolory |Reverse %}

Wszystkie elementy w odwróconej kolejności

{% for kolor in kolory -%}

{% endfor -%}

Powyższy przykład zwróci:


Wszystkie elementy w odwróconej kolejności
żółty
niebieski
czerwony
zielony
czarny
biały

Wszystkie elementy w odwróconej kolejności

żółty

niebieski

czerwony

zielony

czarny

biały

Randomize

Zwraca tablicę, w której kolejność elementów jest ustawiona w sposób losowy.

Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign kolory = koloryTekst |Split: ', ' %}
{% assign kolory = kolory |Randomize %}

Wszystkie elementy w losowej kolejności
{% for kolor in kolory -%}
{{ kolor }}
{% endfor -%}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign kolory = koloryTekst |Split: ', ' %}

{% assign kolory = kolory |Randomize %}

Wszystkie elementy w losowej kolejności

{% for kolor in kolory -%}

{% endfor -%}

Powyższy przykład może zwrócić:


czerwony
niebieski
biały
żółty
czarny
zielony

czerwony

niebieski

biały

żółty

czarny

zielony

Kolejny przykład


{% assign losowyObrazek = productdetails.Product.Images |Randomize %}

Pierwszy losowy obrazek na towarze
{{losowyObrazek |First |Img }}

{% assign losowyObrazek = productdetails.Product.Images |Randomize %}

Pierwszy losowy obrazek na towarze

Join

Łączy elementy tablicy w ciąg znaków wstawiając pomiędzy elementy przekazany parametr.

Parametry: string.
Zwracany typ: string.


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign tablicaKolorow = koloryTekst |Split: ', ' %}
{{tablicaKolorow |Join: '. ' }}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign tablicaKolorow = koloryTekst |Split: ', ' %}

Powyższy przykład zwróci:


biały. czarny. zielony. czerwony. niebieski. żółty

biały. czarny. zielony. czerwony. niebieski. żółty

Map

Zwraca tablicę składającą się z wartości elementów kolekcji wejściowej dla wskazanej właściwości przez przekazany argument.

Parametry: string.
Zwracany typ: tablica elementów typu wskazanej właściwości.


{% assign typyFlag = product-details.Product.Flags |Map: 'Text' %}
{% for typFlagi in typyFlag -%}
{{typFlagi}}
{% endfor -%}

{% assign typyFlag = product-details.Product.Flags |Map: 'Text' %}

{% for typFlagi in typyFlag -%}

{% endfor -%}

Powyższy przykład może zwrócić:


Promocja
Najlepiej oceniany

Promocja

Najlepiej oceniany

Kolejny przykład


{{ config.Languages |Map: 'Name' |Join: ', ' }}

Powyższy przykład może zwrócić:


polski, Deutsch, français

polski, Deutsch, français

Size

Zwraca liczbę elementów w tablicy.

Zwracany typ: int.


Liczba obrazków dla towaru {{ product-details.Product.Images |Size }}

Liczba obrazków dla towaru {{ product-details.Product.Images |Size }}

Uniq

Zwraca tablicę unikatowych elementów. Tablica ta nie zawiera duplikatów.

Zwracany typ: tablica elementów typu zdefiniowanego w tablicy wejściowej.


{% assign kolory = "czarny,biały,niebieski,czarny,niebieski" | Split: ',' -%}
{% assign unikatoweKolory = kolory | Uniq -%}
{% for kolor in unikatoweKolory -%}
	{{kolor}}	
{% endfor -%}

{% assign kolory = "czarny,biały,niebieski,czarny,niebieski" | Split: ',' -%}

{% assign unikatoweKolory = kolory | Uniq -%}

{% for kolor in unikatoweKolory -%}

{% endfor -%}

Powyższy przykład zwróci:


czarny
biały
niebieski

czarny

biały

niebieski

Format

Formatuje tekst zgodnie z wartościami przekazanymi w poszczególnych parametrach.

Parametry: object p1, object p2 = null, object p3 = null, object p4 = null, object p5 = null, object p6 = null, object p7 = null, object p8 = null, object p9 = null, object p10 = null.
Zwracany typ: string.


{% assign cenaWaluta = 'Cena: {0}, waluta {1}' -%}
{{ cenaWaluta | Format:'25.00', 'PLN' }}

{% assign cenaWaluta = 'Cena: {0}, waluta {1}' -%}

Powyższy przykład zwróci:


Cena: 25.00, waluta PLN

Cena: 25.00, waluta PLN

Append

Dodaje tekst przekazany przez argument na koniec tekstu wejściowego.
Jeżeli tekst wejściowy == null to filtr zwróci null.

Parametry: string.
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' %}
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst1 |Append: tekst2 }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' %}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Powyższy przykład zwróci:


Lorem ipsum dolor sit amet, consectetur adipiscing elit. Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.

Prepend

Dodaje tekst przekazany przez argument na początek tekstu wejściowego.
Jeżeli tekst wejściowy == null to filtr zwróci null.

Parametry: string.
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. ' %}
{{ tekst1 |Prepend: tekst2 }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. ' %}

Powyższy przykład zwróci:


Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Capitalize

Konwertuje tekst tak, aby każde słowo w tekście zaczynało się z dużej litery.

Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{{ tekst1 |Capitalize }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

Downcase

Konwertuje tekst tak, aby cały tekst (każda litera) był napisany małymi literami.

Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{{ tekst1 | Downcase }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

Upcase

Konwertuje tekst tak, aby cały tekst (każda litera) był napisany wielkimi literami.

Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{{ tekst1 |Upcase}}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

Remove

Usuwa z tekstu wejściowego fragment tekstu przekazanego przez parametr.

Parametry: string.
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{{ tekst1 |Remove: 'ip' }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

RemoveFirst

Usuwa z tekstu wejściowego pierwsze wystąpienie fragmentu tekstu przekazanego przez parametr.

Parametry: string.
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{{ tekst1 |RemoveFirst: 'ip' }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

Replace

Zamienia w tekście wejściowym szukany fragment tekstu innym tekstem (tekst zamienny). Szukany fragment tekstu oraz tekst zamienny przekazywane są przez parametry. Parametry przyjmują wyrażenia regularne.
Jeśli chcemy wyszukać znak specjalny i użyć go jak znaku, a nie części wyrażenia regularnego, należy go poprzedzić ukośnikiem \.

Parametry: string, string = „”.
Zwracany typ: string.


{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst2 |Replace:'!','.' }}
{% assign waga = '31.53kg' %}
{{ waga |Replace:'\.',',' }}
{% assign spacje = '     Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.     ' %}
{{ spacje |Replace:'^\s+|\s+$','' }}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

{% assign waga = '31.53kg' %}

{% assign spacje = ' Litwo! Ojczyzno moja! Ty jesteś jak zdrowie. ' %}

ReplaceFirst

Zamienia w tekście wejściowym pierwsze wystąpienie szukanego fragmentu tekstu innym tekstem (tekst zamienny). Szukany fragment tekstuoraz tekst zamienny przekazywane są przez parametry. Parametry przyjmują wyrażenia regularne.
Jeśli chcemy wyszukać znak specjalny i użyć go jak znaku, a nie części wyrażenia regularnego, należy go poprzedzić ukośnikiem \.

Parametry: string, string = „”.
Zwracany typ: string.


{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst2 |ReplaceFirst:'!','.' }}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Size

Zwraca długość tekstu – liczba znaków w tekście.

Zwracany typ: int.


Długość opisu towaru
{{ productdetails.Product.Description |Size }}

Długość opisu towaru

Kolejny przykład


Liczba znaków w cenie towaru
{{ productdetails.Product.Price |ToString |Size }}

Liczba znaków w cenie towaru

Slice

Zwraca fragment z tekstu wejściowego dla podanej pozycji początkowej oraz długości. Pozycja początkowa oraz długość przekazywane są przez parametry.
W przypadku, gdy parametr z pozycją początkową jest ujemny to pozycja początkowa liczona jest od od końca tekstu.

Uwaga

Znaki w tekście numerowane są od 0. Należy uwzględnić to przy określaniu pozycji początkowej.

Parametry: int, int = 1.
Zwracany typ: string.


{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst2 |Slice:0 }}
{{ tekst2 |Slice:1 }}
{{ tekst2 |Slice:0,20 }}
{{ tekst2 |Slice: - 1 }}
{{ tekst2 |Slice: - 20,10 }}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Powyższy przykład zwróci:


L
i
Litwo! Ojczyzno moja
.
 jesteś jak

Litwo! Ojczyzno moja

jesteś jak

Split

Tworzy z tekstu wejściowego tablicę, w której każdy element stanowi fragment tekstu rozdzielony przez podany wzorzec. Wzorzec przekazany przez parametr.

Parametry: string.
Zwracany typ: string[].


{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}
{% assign kolory = koloryTekst |Split: ', ' %}

Pierwszy element
{{ kolory[0] }}

Wszystkie elementy
{% for kolor in kolory - %}
{{ kolor }}
{% endfor - %}

{% assign koloryTekst = 'biały, czarny, zielony, czerwony, niebieski, żółty' %}

{% assign kolory = koloryTekst |Split: ', ' %}

Pierwszy element

Wszystkie elementy

{% for kolor in kolory - %}

{% endfor - %}

Powyższy przykład zwróci:


Pierwszy element
biały

Wszystkie elementy
biały
czarny
zielony
czerwony
niebieski
żółty

Pierwszy element

biały

Wszystkie elementy

biały

czarny

zielony

czerwony

niebieski

żółty

StripHtml

Usuwa wszystkie tagi HTML z tekstu wejściowego.

Zwracany typ: string.


{{ productdetails.Product.Description |StripHtml }}

StripNewlines

Usuwa wszystkie znaki nowej linii (podziały wiersza) z tekstu wejściowego.

Zwracany typ: string.


{{ productdetails.Product.Description |StripNewlines }}

NewlineToBr

Wstawia tag HTML przed każdym znakiem nowej linii w tekście wejściowym.

Zwracany typ: string.


{{ productdetails.Product.Description |NewlineToBr }}

Truncate

Obcina tekst wejściowy do podanej liczby znaków dodając na końcu tekst obcinający. Liczba znaków oraz tekst obcinający przekazywane są przez parametry. Tekst obcinający wliczony jest w liczbę znaków.

Parametry: int = 50, string = „…”.
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst1 |Truncate }}
{{ tekst2 |Truncate: 25, '(...)' }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Powyższy przykład zwróci:


Lorem ipsum dolor sit amet, consectetur adipisc...
Litwo! Ojczyzno moja(...)

Lorem ipsum dolor sit amet, consectetur adipisc...

Litwo! Ojczyzno moja(...)

TruncateWords

Obcina tekst wejściowy do podanej liczby wyrazów dodając na końcu tekst obcinający. Liczba wyrazów oraz tekst obcinający przekazywane są przez parametry.

Parametry: int 15, string = „…”
Zwracany typ: string.


{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}
{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{{ tekst1 |TruncateWords }}
{{ tekst2 |TruncateWords: 3,'(...)' }}

{% assign tekst1 = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.' %}

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Powyższy przykład zwróci:


Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Litwo! Ojczyzno moja!(...)

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Litwo! Ojczyzno moja!(...)

Times

Powtarza tekst wielokrotnie. Liczba powtórzeń przekazywana przez parametr.

Parametry: int.
Zwracany typ: string.


{% assign kropka = '.' %}
{% assign liczbaPowtorzen = 3 %}
Przykładowy tekst zakończony kropkami{{ kropka|Times: liczbaPowtorzen }}

{% assign kropka = '.' %}

{% assign liczbaPowtorzen = 3 %}

Przykładowy tekst zakończony kropkami{{ kropka|Times: liczbaPowtorzen }}

Plus

Dodawanie.

Parametry: int/decimal.
Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba1 = 9 %}
{% assign liczba2 = 2 %}
Wynik: {{ liczba1 | Plus: liczba2 }}

{% assign liczba1 = 9 %}

{% assign liczba2 = 2 %}

Wynik: {{ liczba1 | Plus: liczba2 }}

Uwaga

Jeśli filtr Plus wywołany zostanie na elemencie wejściowym typu string to działanie będzie podobne do użycia filtru Append.

Minus

Odejmowanie.

Parametry: int/decimal.
Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba1 = 9 %}
{% assign liczba2 = 3 %}
Wynik: {{ liczba1 |Minus: liczba2 }}

{% assign liczba1 = 9 %}

{% assign liczba2 = 3 %}

Wynik: {{ liczba1 |Minus: liczba2 }}

Times

Mnożenie.

Parametry: int/decimal.
Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba1 = 9.01 %}
{% assign liczba2 = 2 %}
Wynik: {{ liczba1 |Times: liczba2 }}

{% assign liczba1 = 9.01 %}

{% assign liczba2 = 2 %}

Wynik: {{ liczba1 |Times: liczba2 }}

DividedBy

Dzielenie.

Parametry: int/decimal.
Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba1 = 9 %}
{% assign liczba2 = 3 %}
Wynik:{{ liczba1 |DividedBy: liczba2 }}

{% assign liczba1 = 9 %}

{% assign liczba2 = 3 %}

Wynik:{{ liczba1 |DividedBy: liczba2 }}

Modulo

Reszta z dzielenia.

Parametry: int/decimal.
Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba1 = 9.01 %}
{% assign liczba2 = 2 %}
Wynik:{{ liczba1 |Modulo: liczba2 }}

{% assign liczba1 = 9.01 %}

{% assign liczba2 = 2 %}

Wynik:{{ liczba1 |Modulo: liczba2 }}

Normalize

Formatuje liczbę wejściową usuwając jej „zbędne” zera w części ułamkowej.

Typ liczby wejściowej: decimal.
Zwracany typ: decimal.


Cena: {{ productdetails.Product.Price }}
Cena: {{ productdetails.Product.Price |Normalize }}

Cena: {{ productdetails.Product.Price }}

Cena: {{ productdetails.Product.Price |Normalize }}

Powyższy przykład może zwrócić:


Cena: 10,00
Cena: 10

Cena: 10,00

Cena: 10

Floor

Zwraca największą liczbę całkowitą, która jest mniejsza lub równa wejściowej.

Typ liczby wejściowej: decimal.
Zwracany typ: int.


{% assign liczba = 6.05 %}
Wynik:{{ liczba |Floor }}

{% assign liczba = 6.05 %}

Wynik:{{ liczba |Floor }}

Powyższy przykład zwróci:


Wynik:6

Wynik:6

Ceil

Zwraca najmniejszą liczbę całkowitą, która jest większa lub równa wejściowej.

Typ liczby wejściowej: decimal.
Zwracany typ: int.


{% assign liczba = 6.05 %}
Wynik:{{ liczba |Ceil }}

{% assign liczba = 6.05 %}

Wynik:{{ liczba |Ceil }}

Powyższy przykład zwróci:


Wynik:7

Wynik:7

Abs

Zwraca wartość bezwzględną z liczby.


{% assign liczba = -6.05 %}
Wynik:{{ liczba |Abs }}

{% assign liczba = -6.05 %}

Wynik:{{ liczba |Abs }}

Powyższy przykład może zwrócić:


Wynik:6.05

Wynik:6.05

Round

Zaokrągla liczbę wejściową do określonej ilości miejsc po przecinku.

Zwracany typ: taki sam jak element wejściowy, na którym wywołany jest filtr.


{% assign liczba = 6.05687 %}
Wynik:{{ liczba |Round: 4 }}

{% assign liczba = 6.05687 %}

Wynik:{{ liczba |Round: 4 }}

Powyższy przykład zwróci:


Wynik:6.0569

Wynik:6.0569

Date

Formatuje datę i czas. Zwraca datę i czas zgodnie z formatem przekazanym w parametrze.

Wskazówka

Filtr Date w sklepie korzysta z domyślnych ustawień dla DotLiquid. Należy korzystać z formatu daty zgodnego z konwencją .NET dostępnym pod linkiem:
https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.100).aspx

Parametry: string.
Zwracany typ: string.


Data i czas "teraz"
{{ config.Now }}
Data
{{ config.Now |Date:'yyyy-MM-dd' }}
Czas
{{ config.Now |Date:'HH:mm:ss' }}

Data i czas "teraz"

Data

Czas

Powyższy przykład może zwrócić:


Data i czas "teraz"
13.10.2022 10:32:39
Data
2022-10-13
Czas
10:32:39

Data i czas "teraz"

13.10.2022 10:32:39

Data

2022-10-13

Czas

10:32:39

ToPrice

Formatuje cenę do formatu wyświetlania zgodnego z kulturą dla ustawionej lokalizacji sklepu (grupowanie tysięcy, kropka czy przecinek, itd.).
Lokalizacja sklepu określa, czy sklep został zainstalowany domyślnie na rynek polski, niemiecki, itd.

Zwracany typ: string.


Cena: {{ product-details.Product.Price }}
Cena: {{ product-details.Product.Price |ToPrice }}

Cena: {{ product-details.Product.Price }}

Cena: {{ product-details.Product.Price |ToPrice }}

Powyższy przykład może zwrócić:


Cena: 2348,68
Cena: 2 348,68 (lokalizacja na rynek polski)

Cena: 2348,68

Cena: 2 348,68 (lokalizacja na rynek polski)

Tworzy tag <a>wraz z atrybutami. Wartości dla atrybutów tagu pobierane są z elementu wejściowego.

Typ elementu wejściowego: obiekt Liquid.
Zwracany typ: string.

Filtr ma zastosowanie dla obiektów:

Strona
Grupa towarowa
Towar
Blog
Tagi

Przykład użycia filtra A dla obiektów: Strona


Strony
{{ config.DefinedPages.Home |A |H }}
{{ config.Pages['6'] |A |H }} {% comment %} Strona o id = 6 {% endcomment %}
{{ page.CurrentSiteNode |A |H }}
{{ page.GroupNodes[0] |A |H }}
{{ page.Breadcrumbs[0] |A |H }}

Strony

{{ config.Pages['6'] |A |H }} {% comment %} Strona o id = 6 {% endcomment %}

Powyższy przykład może zwrócić:


Strony
<a href="./">Strona główna</a>
<a href="profil-klienta,6">Profil klienta</a>
<a href="produkty/owoce-1/banany-555,2,1024703">Banany</a>
<a href="produkty/owoce-1,2,76">Owoce</a>
<a href="./">Strona główna</a>

Strony

<a href="./">Strona główna</a>

<a href="profil-klienta,6">Profil klienta</a>

<a href="produkty/owoce-1/banany-555,2,1024703">Banany</a>

<a href="produkty/owoce-1,2,76">Owoce</a>

<a href="./">Strona główna</a>

Przykład użycia filtra A dla obiektów: Towar


Towary
{{ product-new.Products[0] |A |H }}
{{ product-list.Products[1] |A |H }}
{{ product-details.Product |A |H }}

Towary

Powyższy przykład może zwrócić:


Towary
<a href="banany,3,1024703,81">Banany</a>
<a href="minibanany-odrobina-wystarczy,3,1024703,82">Minibanany odrobina wystarczy</a>
<a href="minibanany-odrobina-wystarczy,3,1024703,82">Minibanany odrobina wystarczy</a>

Towary

<a href="banany,3,1024703,81">Banany</a>

<a href="minibanany-odrobina-wystarczy,3,1024703,82">Minibanany odrobina wystarczy</a>

Przykład użycia filtra A dla obiektów: Blog, Tags


Blog
{{ blog.PostList.Posts[0] |A |H }}
{{ blog.PostDetails |A |H }}
Tags
{{ config.Tags.Blog[0] |A |H }}

Blog

Tags

<a rel="tag" href="blog,23?seaBlog=Informacje">Informacje</a>

Img

Tworzy tag <img>wraz z atrybutami. Wartości dla atrybutów tagu pobierane są z elementu wejściowego lub mogą być przekazywane przez parametry.

Uwaga

Tag <img> domyślnie ustawiony ma link do obrazka w atrybucie data-src. Należy zastosować funkcję skryptową, która przepisze wartość z atrybutu data-src do atrybutu src (lazy load).

Typ elementu wejściowego: obiekt Liquid, string.
Parametry: string size = „small”, string alt = null, string title = null.
Zwracany typ: string.

Dostępne wartości dla parametru size:

Parametr size	Rozmiar zdjęcia (dłuższa krawędź) w px
img	0
pico	16
icon	32
thumb	50
small	100
compact	160
medium	240
large	480
grande	600
master	1920

Filtr ma zastosowanie dla obiektów:

Towar
Zdjęcia towaru (na szczegółach towaru)
Producent
Marka
Blog (w obiekcie blog pomijany jest parametr size. Obrazki zwracane są zawsze w rozmiarze rzeczywistym).

Przykład użycia filtra Img dla obiektów: Towar, Zdjęcia towaru


Lista towarów
{{ product-list.Products[1] |Img |H }}
{{ produc-tlist.Products[1] |Img: 'medium','Świeże banany, Kraków' |H }}

Towar (szczegóły)
{{ product-details.Product |Img:'large' |H }}
{{ product-details.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %}
{{ product-details.Product.Images[0] |Img |H }}

Lista towarów

{{ produc-tlist.Products[1] |Img: 'medium','Świeże banany, Kraków' |H }}

Towar (szczegóły)

{{ product-details.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %}

Powyższy przykład może zwrócić:


Lista towarów
<img alt="Minibanany odrobina wystarczy" src="usr/alo.gif" data-src="img/small/59/minibanany.jpg"/>
<img alt="Świeże banany, Kraków" src="usr/alo.gif" data-src="img/medium/59/minibanany.jpg"/>

Towar (szczegóły)
<img alt="Minibanany odrobina wystarczy" src="usr/alo.gif" data-src="img/large/59/minibanany.jpg"/>
<img src="usr/alo.gif" data-src="Ima.ashx?t=wrs&Id=1"/>
<img alt="" src="usr/alo.gif" data-src="img/small/59/.jpg"/>

Lista towarów

Towar (szczegóły)

Przykład użycia filtra Img dla obiektów: Producent, Marka


Producent, Marka
{{ manufacturers-brands.Manufacturers[2] |Img |H }}
{{ manufacturers-brands.Manufacturers[2] |Img: 'thumb','Comarch globalny dostawca IT.' |H }}
{{ manufacturers-brands.Brands[3] |Img |H }}

Producent, Marka

{{ manufacturers-brands.Manufacturers[2] |Img: 'thumb','Comarch globalny dostawca IT.' |H }}

Powyższy przykład może zwrócić:


Producent, Marka
<img alt="Comarch" src="usr/alo.gif" data-src="img/small/160/Comarch.jpg"/>
<img alt="Comarch globalny dostawca IT." src="usr/alo.gif" data-src="img/thumb/160/Comarch.jpg"/>
<img alt="Comarch ALTUM" src="usr/alo.gif" data-src="img/small/92/Comarch%20ALTUM.jpg"/>

Producent, Marka

Przykład użycia filtra Img dla obiektów: Blog


Blog
{{ blog.LatestPosts[0] |Img |H }}
{{ blog.PostList.Posts[0] |Img: 'compact','Blog dla Partnera','Informacje dla Partnerów na blogu sklepu' |H }}
{{ blog.PostDetails |Img |H }}

Blog

{{ blog.PostList.Posts[0] |Img: 'compact','Blog dla Partnera','Informacje dla Partnerów na blogu sklepu' |H }}

Powyższy przykład może zwrócić:


Blog
<img alt="Blog wpis podstawowy" src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/>
<img alt="Blog dla Partnera" title="Blog dla Partnera,'Informacje dla Partnerów na blogu sklepu"
src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/>
<img alt="Blog wpis podstawowy" src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/>

Blog

<img alt="Blog dla Partnera" title="Blog dla Partnera,'Informacje dla Partnerów na blogu sklepu"

src="usr/alo.gif" data-src="Ima.ashx?t=blg&id=1"/>

Przykład użycia filtra Img dla tekstu z linkiem do obrazka


Tekst z linkiem do obrazka
{{ productdetails.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %}
{{ 'https://www.domena.pl/file/banner.jpg' |Img:'','atrybut alt','atrybut title' |H }}

Tekst z linkiem do obrazka

{{ productdetails.Product.StockLevel.ImageUrl |Img |H }} { % comment % } Tekst z linkiem {% endcomment %}

{{ 'https://www.domena.pl/file/banner.jpg' |Img:'','atrybut alt','atrybut title' |H }}

Powyższy przykład może zwrócić


Tekst z linkiem do obrazka
<img src="usr/alo.gif" data-src="Ima.ashx?t=wrs&Id=1"/>
<img alt="atrybut alt" title="atrybut title"src="usr/alo.gif" data-src="https://www.domena.pl/file/banner.jpg"/>

Tekst z linkiem do obrazka

Img2

Filtr Img2 zachowuje się w podobny sposób jak wyżej opisany filtr Img. Różnicą jest to, że utworzony tag <img> ma link do obrazka nie w atrybucie data-src, lecz w atrybucie data-lazy. Dodatkowo filtr Img2 pozwala na dodanie czwartego parametru raw, w którym można wpisać wszystko, np. class=”example_class” i znajdzie się to wewnątrz tagu <img>.

Typ elementu wejściowego: obiekt Liquid, string.
Parametry: string size = „small”, string raw = null, string alt = null, string title = null.
Zwracany typ: string.

Przykład użycia filtra Img2 na szczegółach towaru:


{{product.Images[0] |Img2 :'large', '', 'pasek', 'obrazek' }}
{{product.Images[0] |Img2: 'large', 'class="open-gallery"', 'pasek', 'obrazek' }}

{{product.Images[0] |Img2: 'large', 'class="open-gallery"', 'pasek', 'obrazek' }}

Powyższy przykład może zwrócić:


<img src="img/large/27/.jpg" alt="pasek" title="obrazek" style="opacity: 1;">
<img src="img/large/27/.jpg" alt="pasek" title="obrazek" class="open-gallery" style="opacity: 1;">

Zamienia znaki specjalne na encje HTML (HTMLEncode).

Zwracany typ: string.


{% assign tekst2HTML = '<p>Litwo! <b>Ojczyzno moja!</b> Ty jesteś jak zdrowie.</p>' %}
Tekst z encjami HTML
{{ tekst2HTML |H }}

{% assign tekst2HTML = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Tekst z encjami HTML

Powyższy przykład zwróci:


Tekst z encjami HTML
<p>Litwo! <b>Ojczyzno moja!</b> Ty jesteś jak zdrowie.</p>

Tekst z encjami HTML

Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.

Escape

Alias dla filtra H.

EscapeUri

Zamienia znaki spoza zakresu ASCII na format zgodny z ASCII.

Zwracany typ: string.


{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
Link użytkownika
{{ '<'|H }}a href="/?tekst={{ tekst2 | EscapeUri }}" (...)

{% assign tekst2 = 'Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

Link użytkownika

{{ '<'|H }}a href="/?tekst={{ tekst2 | EscapeUri }}" (...)

Powyższy przykład zwróci:


Link użytkownika
<a href="/?tekst=Litwo!%20Ojczyzno%20moja!%20Ty%20jeste%C5%9B%20jak%20zdrowie." (...)

Link użytkownika

<a href="/?tekst=Litwo!%20Ojczyzno%20moja!%20Ty%20jeste%C5%9B%20jak%20zdrowie." (...)

UnEscapeUri

Filtr przeciwstawny do filtra EscapeUri.

Zwracany typ: string.

ToString

Konwertuje element wejściowy do typu string.

Zwracany typ: string.


{% assign tekst2 = ' Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}
{% assign liczba = 3 %}
Liczba i tekst: {{ liczba |ToString |Append: tekst2 }}

{% assign tekst2 = ' Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.' %}

{% assign liczba = 3 %}

Liczba i tekst: {{ liczba |ToString |Append: tekst2 }}

Powyższy przykład zwróci:


Liczba i tekst: 3 Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.

Liczba i tekst: 3 Litwo! Ojczyzno moja! Ty jesteś jak zdrowie.

ToInt

Konwertuje element wejściowy do typu int.

Zwracany typ: int.


{% assign tekstLiczba1 = '9' %}
{% assign liczba1 = tekstLiczba1 |ToInt %}
ToInt: {{ liczba1 }} | {{ liczba1 |Minus: 4 }}

{% assign tekstLiczba1 = '9' %}

{% assign liczba1 = tekstLiczba1 |ToInt %}

ToInt: {{ liczba1 }} | {{ liczba1 |Minus: 4 }}

Powyższy przykład zwróci:


ToInt: 9 | 5

ToInt: 9 | 5

ToNum

Konwertuje element wejściowy zgodnie z formatem dla kultury Invariant (zapewnia zawsze taki sam format). Liczby oraz daty wyświetlane są zgodnie z kulturą dla lokalizacji sklepu.

Zwracany typ: string.


liczba: {{ 1239,01 }}
liczba (Invariant) : {{ 1239,01 |ToNum }}
data: {{config.Now }}
data (Invariant) {{config.Now |ToNum }}

liczba: {{ 1239,01 }}

liczba (Invariant) : {{ 1239,01 |ToNum }}

data: {{config.Now }}

data (Invariant) {{config.Now |ToNum }}

Powyższy przykład może zwrócić:


liczba: 1239,01
liczba (Invariant) : 1239.01
data: 29.04.2016 14:45:24
data (Invariant) 04/29/2016 14:45:24

liczba: 1239,01

liczba (Invariant) : 1239.01

data: 29.04.2016 14:45:24

data (Invariant) 04/29/2016 14:45:24

ToTimeSpan

Konwertuje tekst do typu TimeSpan zgodnie z formatem dla kultury Invariant.

Zwracany typ: TimeSpan.


TimeSpan: {{ '509.07:01:01' |ToTimeSpan }}

TimeSpan: {{ '509.07:01:01' |ToTimeSpan }}

DEBUG

Wyświetla obiekty globalne i lokalne wraz z jego właściwościami oraz odpowiadającymi im wartościami.

Przykład wyświetlenia obiektu customer z filtrem DEBUG


<fieldset>
<legend>DEBUG customer</legend>
<pre>{{ customer | DEBUG }}</pre>
</fieldset>
</fieldset>

<legend>DEBUG customer</legend>

<pre>{{ customer | DEBUG }}</pre>

</fieldset>

Powyższy przykład może zwrócić:


{
   "NewsletterSubscriber" : false,
   "Authenticated" : false,
   "CustomerDetailsEditable" : true,
   "Currency" : "PLN",
   "CurrencyExt" : {
      "Code" : "PLN",
      "Symbol" : "zł"
   },(...)

{

"NewsletterSubscriber" : false,

"Authenticated" : false,

"CustomerDetailsEditable" : true,

"Currency" : "PLN",

"CurrencyExt" : {

"Code" : "PLN",

"Symbol" : "zł"

},(...)

Uwaga

Tryb debug dla obiektów dostępny jest tylko, gdy włączony jest parametr Podgląd stron w czasie rzeczywistym

Tablice

Tekstowe

Liczbowe, Matematyczne

Data i czas

Cena

HTML

Pozostałe

Tablice

Tekstowe

Liczbowe, Matematyczne

Data i czas

Cena

HTML

Pozostałe

Opis dostępnych filtrów:

Czy ten artykuł był pomocny?

Społeczność Comarch

Oferta e-Commerce

Przydatne linki

Kontakt