A plataforma dispõe de alguns data providers destinados a construção de vitrines e com algumas possibilidades de filtros, ordenação e limit/offset em comum. Com isso é possível montar vitrines de itens com origens diferentes para os dados, como por exemplo itens a partir de um termo buscado, relacionados a categorias, em promoção, entre outros.

Limit e offset

Usado para construir paginação entre para uma listagem, definindo a quantidade de itens retornados e o ponto de início dessa listagem.
Para isso, definir os parâmetros _limit e _offset no query string da URL da vitrine com os seus respectivos valores, onde se omitidos o padrão é 24 para o limite e 0 para o offset e o limite não poderá ser maior 48.

Exemplos:

Limite de 10 itens a partir do 11º item:
https://www.minhaloja.com.br/minha-vitrine?_limit=10&_offset=10

Limite de 24 itens a partir do 1º item:
https://www.minhaloja.com.br/minha-vitrine?_limit=24&_offset=0

Ordenação

Usado para ordenar de forma ascendente ou descendente a vitrine a partir de um campo presente nos itens.
Para isso, definir o parâmetro _sort no query string com os campos desejados e um prefixo indicando a direção da ordenação. Alguns data providers específicos permitem uma ordenação padrão sem que seja necessário a definição no query string. Se nenhuma ordenação for informada, seja no query string ou via data provider, a plataforma seguirá o padrão de disponibilidade do item (disponíveis primeiro e depois indisponíveis) e em seguida a ordem de cadastro.
Para ordenação ascendente informar somente o nome do campo (_sort=campo). Para ordenação descendente informar o nome do campo com um hífen como prefixo (_sort=-campo). Os campos ordenáveis por padrão são:

• id
  ID de identificação do item
• name
  Nome do item
• price
  Preço do item
• categories
  Categorias do item
• Campos extras: o slug do campo extra deve ser informado obedecendo as regras descritas acima.

Exemplos:

Ordenação por preço do menor pro maior:
https://www.minhaloja.com.br/minha-vitrine?_sort=price

Ordenação por nome de Z-A (decrescente):
https://www.minhaloja.com.br/minha-vitrine?_sort=-name

Ordenação pelo campo extra descrescente e preço do maior pro menor:
https://www.minhaloja.com.br/minha-vitrine?_sort=-meucampoextra,-price

Filtros

Usado para filtrar itens da listagem inicial. Poderá comparar valores dos campos abaixo usando algumas funções de comparação como maior que, menor que, igual a, semelhante a, entre outros, informando o campo junto ao seu comparador e o valor para comparação no query string da URL da vitrine da seguinte forma:

• Igual a
  https://www.minhaloja.com.br/minha-vitrine?campo=valor
• Semelhante a
  https://www.minhaloja.com.br/minha-vitrine?campo-lk=*valor*
• Diferente de
  https://www.minhaloja.com.br/minha-vitrine?campo-not=valor
• Menor que
  https://www.minhaloja.com.br/minha-vitrine?campo-st=valor
• Menor ou igual a
  https://www.minhaloja.com.br/minha-vitrine?campo-max=valor
• Maior que
  https://www.minhaloja.com.br/minha-vitrine?campo-gt=valor
• Maior ou igual a
  https://www.minhaloja.com.br/minha-vitrine?campo-min=valor
• Dentro da lista
  https://www.minhaloja.com.br/minha-vitrine?campo-in=valor1,valor2,valor3

A seguir estão todos os campos que aceitam comparações por padrão:

• id
  ID de identificação do item
• name
  Nome do item
• price
  Preço do item
• tags
  O slug da tag
• Campos extras: o slug do campo extra deve ser informado obedecendo às regras descritas acima.

Exemplos:

Nome semelhante a "teste"
https://www.minhaloja.com.br/minha-vitrine?name-lk=*teste*

Preço até (menor ou igual a) R$ 50,99
https://www.minhaloja.com.br/minha-vitrine?price-max=50.99

Campo extra na entre as opções selecionadas
https://www.minhaloja.com.br/minha-vitrine?meucampoextra-in=a,b,c

Tag igual a
https://www.minhaloja.com.br/minha-vitrine?tags=slug-da-tag