item

Como utilizar o objeto item

O objeto {{ item }} é usado no atributo items do cart para renderizar itens adicionados ao carrinho de compras.

<div>
  {% cartitems %}
    <div>
      <a href="{{ item.product_url }}">
        <img src="{{ item.image_url | resize: '250x' }}" alt="{{ product.name }}" />
      </a>
      
      <p>
        <a href="{{ item.product_url }}">
          {{ item.product_name }}
        </a><br />
        {{ item.variant_name }} / {{ item.variant_sku }}<br />
        {{ item.price | money_format }}
      </p>
    
    </div>
  {% endcartitems %}
</div>

Confira os atributos do objeto item na tabela a seguir:

Atributos

Função

available_quantity

Retorna a quantidade de itens disponíveis na loja. Útil para delimitar quantos itens poderão ser adicionados no carrinho.

delivery_days

Retorna o prazo de entrega do item.

extra

Retorna uma lista com os atributos personalizados do produto, se houver.

has_customizations

Retorna true se o item possui personalização, e false se o item não possui personalização.

id

Retorna o ID do item do carrinho (diferente do ID do produto).

image_url

Retorna a URL da imagem da variante adicionada ao carrinho. Se a variante adicionada ao carrinho não possuir uma imagem relacionada, retorna a imagem do produto.

place_id

Código identificador do local de venda.

price

Retorna o preço unitário do produto.

product_id

Retorna o ID do produto.

product_name

Retorna o nome do produto.

product_reference

Retorna a referência do produto.

product_type

Retorna o tipo do produto.

product_url

Retorna a URL da página do produto.

quantity

Retorna a quantidade desse item adicionada ao carrinho.

seller

Retornar a loja responsável pela venda, em caso de vendas via marketplace.

seller_name

Retorna o nome da loja que fará o envio do produto, em casos de venda via marketplace.

subtotal

Retorna o subtotal do item (valor da unidade multiplicado pela quantidade de itens).

total

Retorna o valor total do item (valor da unidade multiplicado pela quantidade de itens, incluindo descontos promocionais).

updated_at

Retorna a data e horário da última atualização do item. O formato de retorno dos dados é o ISO 8601.

A exibição desse atributo pode ser controlada através do filtro date.

variant_attributes

Retorna os atributos da variante.

variant_min_quantity

Retorna a quantidade mínima da variante que deve ser adicionada ao carrinho.

variant_name

Retorna o nome da variante adicionada ao carrinho.

variant_intl_price

Retorna o preço internacional da variante.

variant_price

Retorna o preço unitário da variante adicionada ao carrinho.

variant_properties

Retorna um objeto com as propriedades da variante:

  • variant_properties.property1
  • variant_properties.property2
  • variant_properties.property3

Cada propriedade da variante possui três informações:

  • name: o nome da propriedade (ex. “Tamanho”, “Cor”);
  • value: o valor da propriedade (ex. “G”, “Amarelo”);
  • defining: retorna true se a variante possui uma definição ou false se a variante não possui.

variant_sku

Retorna o código identificador SKU da variante adicionada ao carrinho.

📘

Saiba mais sobre os conceitos de variante e produto no artigo Referências e SKU.