Antes de começar
Abra Configurações → Marca d'água em PDF no admin do Alva. A marca d'água é apenas para plano pago. O editor de template tem dois campos: o template do carimbo (a grande sobreposição diagonal ou posicionada) e o template do rodapé (texto menor no rodapé de cada página). Ambos aceitam as mesmas variáveis.
Como o template é renderizado
No momento do carimbo, o Alva Digital Downloads analisa o template, encontra cada {token} e substitui pelos dados do comprador. Qualquer coisa fora das chaves é renderizada exatamente como escrita. O template do carimbo e o template do rodapé compartilham a mesma lista de tokens, então uma variável que funciona em um campo funciona no outro.
Variáveis disponíveis
O Alva suporta dez tokens agrupados em quatro categorias. Use qualquer combinação deles nos campos do carimbo e do rodapé.
Cliente
{customer.full_name}— nome completo do comprador no Shopify. Volta para o e-mail quando as partes do nome estão vazias (isso acontece em pedidos do Shopify POS, onde só o e-mail é capturado).{customer.first_name}— apenas o primeiro nome.{customer.last_name}— apenas o sobrenome.{customer.email}— endereço de e-mail do comprador.
Pedido
{order.name}— nome do pedido Shopify, por exemplo#1234.{order.id}— identificador interno do pedido Shopify (numérico longo).{order.date}— data de criação do pedido no fuso horário da sua loja.
Produto
{product.title}— título do produto Shopify ao qual o PDF pertence.{file.name}— nome de arquivo original do PDF.
Loja
{shop.name}— nome da sua loja Shopify.
Adicione uma variável pelo seletor
1. Clique no campo que quer editar
Clique no campo do template do carimbo ou do rodapé para focá-lo. O cursor cai onde você clicar dentro do texto existente.
2. Clique em qualquer botão de variável
Abaixo do campo, clique em qualquer botão de variável — por exemplo, {customer.full_name}. Cada token está exposto em um único clique.
3. O Alva adiciona o token ao campo
O Alva adiciona o token ao final do texto atual do campo. Arraste o cursor e reorganize a linha à mão se precisar do token em outra posição.
4. Repita para cada variável
Repita para cada variável que quer misturar no template, depois salve a página de configurações. Clicar em um botão de variável adiciona ao final do campo — não insere na posição do cursor.
Exemplos de templates
Três templates de exemplo que funcionam bem como pontos de partida. Copie qualquer um deles em um dos campos e ajuste o texto estático ao seu gosto.
Marcador de rastreamento minimalista
Licensed to {customer.email} · Order {order.name}Linha amigável voltada ao comprador
{customer.full_name} — purchased from {shop.name} on {order.date}Linha de rodapé completa
{product.title} · Order {order.name} · {customer.email} · {shop.name}Limites e segurança
- Cada campo de template é limitado a 1.000 caracteres.
- Quebras de linha, tabs e outros caracteres de controle nos dados do cliente são reduzidos a espaços antes da renderização — o Alva Digital Downloads sanitiza tokens para que um comprador não consiga quebrar o layout com dados de perfil maliciosos.
- Valores vazios (por exemplo, cliente sem sobrenome) renderizam como strings vazias, então
{customer.first_name} {customer.last_name}reduz-se ao primeiro nome sem espaço sobrando quando necessário. - Tokens desconhecidos (
{order.shipping_country}etc.) ficam literalmente no resultado renderizado — o Alva só substitui tokens que conhece.
Visualize seu template
A página de configurações mostra uma pré-visualização em tempo real usando dados de teste falsos — Test Customer, test@example.com, #1001. A pré-visualização é um mock CSS, não um PDF carimbado real. Para verificar o resultado real, habilite um produto via , faça um pedido de teste no seu próprio nome e baixe o arquivo.Habilite a marca d'água em PDF em um produto específico
Perguntas frequentes
Sim — ambos os campos aceitam as mesmas variáveis. Muitas lojas escrevem uma única linha curta de rastreamento no rodapé e uma linha mais decorativa, voltada ao cliente, no carimbo diagonal. Os dois campos são independentes, então você também pode usar apenas um deles deixando o outro em branco.
O Shopify POS captura o e-mail do cliente no checkout, mas raramente captura o primeiro nome e o sobrenome. Quando ambas as partes do nome estão vazias, o Alva Digital Downloads volta para o e-mail do cliente para que a marca d'água nunca mostre "Licenciado para ".
Não. Apenas os tokens documentados são substituídos. Qualquer outra coisa fica literal no PDF renderizado, o que torna os erros de digitação visíveis — um carimbo dizendo "Licenciado para {customer.emial}" indica imediatamente que o template tem um erro de digitação para corrigir.
Veja também
Foi útil?
Última atualização 2026-05-28