Presentes que se encaixam na stack que você criou, sem mexer nela
Uma gaveta do carrinho personalizada também precisa de opções de presente. Dê um nome de classe a qualquer elemento, e o Gift Block aparece ali, sem mexer no resto.
O tema fica como você o publicou
Criou o tema do zero ou o personalizou até ficar irreconhecível? Os Gift Blocks são blocos de app de tema que carregam com a incorporação de app, então os presentes chegam sem nada no código do tema para você manter.
- Nenhum snippet para manter. Os arquivos do tema podem ficar como foram publicados. Refatore à vontade: não há snippet de presente embolado no código.
- Atualizações de tema no seu ritmo. Os Gift Blocks se reconectam depois das atualizações de tema, então a próxima versão não precisa de checklist de presentes. Publique numa sexta-feira, se precisar.
- Blocos de app onde suas seções aceitam. Na página do produto e na página do carrinho, os Gift Blocks entram como qualquer outro bloco de app. Onde uma seção não aceita nenhum, o Wrapped posiciona o bloco por conta própria.
Sua própria gaveta do carrinho, com um Gift Block
Criou a gaveta você mesmo? Todo Gift Block da loja virtual tem três pontos de integração estáveis justamente para isso. A maioria das lojas nunca precisa deles: sem eles, o Wrapped posiciona cada bloco por conta própria.
- Um nome de classe que você escolhe. O Gift Block aparece dentro do elemento que tem essa classe: em cada item, antes do botão de checkout, onde o design pedir. O markup de celular e o de desktop podem ter a classe.
- Um evento JavaScript com o nome que você der. Disparado em
documentedocument.documentElementquando um cliente salva ou remove opções de presente. Nenhum dado do carrinho vai junto, então seu listener busca o carrinho e redesenha a gaveta do seu jeito. - Um UUID para o seu CSS. Cada bloco o traz no atributo
uuid, então o Gift Block da gaveta pode ficar compacto enquanto o da página do carrinho mantém seu espaço.
Os Gift Blocks funcionam em
- A gaveta do próprio tema. Posicionados para você.
- Os apps de gaveta do carrinho mais populares da Shopify. Recriados quando a gaveta carrega tarde.
- Uma gaveta que você criou. Posicionados pelo nome de classe que você escolher.
Peças da própria Shopify no carrinho e no checkout
Se você conhece a Shopify, já sabe como os presentes funcionam. Cada opção de presente é um produto real da Shopify, com preço, estoque e imagem próprios, e o carrinho e o checkout rodam nos pontos de extensão da própria Shopify.
- Um cart transform para pacotes. No modo agrupado, o presente vai dentro da linha do produto por meio de uma função cart transform da Shopify. No modo detalhado, ele tem uma linha própria. De qualquer forma, o pedido mostra cada linha a separar.
- Uma função de desconto para descontos de presente. Os descontos em produtos de presente são aplicados automaticamente, ficam em Descontos da Shopify com os demais e se combinam com descontos de produto, de pedido e de frete. Ninguém precisa digitar um código.
- No checkout, com Shopify Plus. O Gift Block do checkout é uma extensão de UI do checkout, posicionada no editor de checkout da Shopify e estilizada pela identidade visual do checkout. Mude o estilo do checkout, e o bloco acompanha.



Dados de presente onde seu pipeline já procura
A sincronização com o seu ERP e a importação do seu 3PL já leem os pedidos da Shopify. Os presentes chegam nesses mesmos lugares, então não há feed novo para integrar, e ninguém redigita uma mensagem de presente no sistema do depósito.
- Propriedades de item e atributos do pedido. Opção de presente, Para, De e mensagem, na linha presenteada com Presentes para produtos e no pedido com Presentes para pedidos.
- As chaves que seu mapeamento espera. Os nomes dos atributos podem corresponder à sua importação, e um sublinhado no início oculta um deles dos clientes enquanto ele continua no pedido.
- Um resumo que seu parser encontra. Um resumo do presente vai na observação do pedido, a partir de um template Liquid, entre duas linhas — Wrapped Gifting Attributes —. O resto da observação é mantido.
- Uma tag que convive bem com as outras. A tag é 🎁 Wrapped ou a sua, e ela se junta às tags que já estão no pedido.
Entregue a loja do cliente sem nada a explicar
O próximo desenvolvedor herda um tema sem nenhum código de presente nosso, e a equipe do cliente cuida dos presentes no admin da Shopify, com o visual que você definiu.
- Pronto em um tema de staging. Configure os presentes em um tema de staging, e tudo fica pronto no dia em que esse tema for publicado.
- A equipe do cliente cuida disso. A aparência do bloco e o que ele diz ficam no Editor de presentes, então trocar “Embrulhar para presente” por “Embrulhe para as festas” é decisão deles, não um ticket seu.
- Uma nota de entrega do tamanho de um post-it. Se você posicionou um bloco por nome de classe, mencione o elemento para o qual ele aponta, já que esse markup é seu. Todo o resto fica no admin da Shopify.
Dúvidas comuns de desenvolvedores
A próxima atualização do tema vai quebrar os presentes?
Não. Os Gift Blocks são blocos de app de tema que carregam com a incorporação de app, os arquivos do tema podem ficar como foram publicados, e os blocos se reconectam depois das atualizações de tema. A única coisa a levar adiante é o markup que você mesmo adicionou: um elemento para o qual um nome de classe aponta precisa estar na nova versão também.
Um Gift Block pode ficar em uma gaveta do carrinho que eu mesmo criei?
Sim. Dê a um elemento da gaveta um nome de classe que você escolher, e o Gift Block aparece dentro dele. Com Presentes para produtos, coloque o elemento dentro do loop de itens para que cada item tenha o seu. Markups separados de celular e desktop podem ter o nome de classe.
O evento JavaScript traz dados do carrinho?
Não. O Wrapped dispara o evento com o nome que você der em document e em document.documentElement quando um cliente salva ou remove opções de presente, e é só isso. Seu listener busca o carrinho e roda o seu próprio código, por exemplo para redesenhar uma gaveta personalizada sem recarregar a página.
Em quais partes de um Gift Block meu código pode confiar?
Três: o nome de classe que você escolhe, o evento com o nome que você der e o UUID no atributo uuid do bloco. O markup dentro de um Gift Block não é uma delas, então construa sobre essas três e deixe o visual com o Editor de presentes.
O que uma importação de ERP ou 3PL recebe de um pedido com presente?
Dados comuns de pedidos da Shopify. Opção de presente, Para, De e mensagem são propriedades de item com Presentes para produtos e atributos do pedido com Presentes para pedidos, e os nomes podem corresponder à sua importação. Um resumo do presente vai na observação do pedido a partir de um template Liquid, entre duas linhas — Wrapped Gifting Attributes —, e a tag 🎁 Wrapped, ou a sua, se junta às tags do pedido. As propriedades e os atributos estão lá assim que o pedido é criado. O resumo na observação e a tag chegam em um ou dois minutos.
Posso estilizar o Gift Block do checkout?
Pela identidade visual do checkout. Com Shopify Plus, o Gift Block do checkout é uma extensão de UI do checkout, posicionada no editor de checkout da Shopify e estilizada pela identidade visual do checkout que você já definiu, em cada item ou uma vez para o pedido.
Gift Blocks que se encaixam na sua stack, sem mexer nela
Comece com um teste grátis de 7 dias.
… Before we had even paid a cent for Wrapped, Adam answered questions, got into the nitty-gritty of coding and integration with our web developer. …