Como funciona
Uma explicação em linguagem simples do que acontece quando alguém carrega uma página com uma contagem regressiva.
Você não precisa de nada disto para usar o app — ativar a incorporação de app é toda a configuração. Mas, se você quer entender por que uma contagem regressiva se comporta de certa maneira, ou está investigando um problema, é isto que acontece por baixo dos panos.
A incorporação de app roda em todas as páginas da loja
Seção intitulada “A incorporação de app roda em todas as páginas da loja”O Countdown Timer Bar Samita chega à sua loja virtual por meio de uma incorporação de extensão de app de tema da Shopify, listada no editor de temas como Samita Countdown Timer Bar. Depois de ativada em um tema, um pequeno script do app roda em todas as páginas que quem visita carrega nesse tema.
Na maioria das visualizações de página, ele não tem nada a fazer. Sua primeira tarefa é verificar se algo que você configurou se aplica à página e, na maioria das páginas da maioria das lojas, a resposta é não, então ele sai do caminho.
Como as contagens regressivas ficam no app e não no tema, as alterações que você salva aparecem na loja virtual sem precisar republicar o tema.
O que ele sabe sobre a página
Seção intitulada “O que ele sabe sobre a página”Além das configurações da contagem regressiva, a incorporação capta algumas informações da própria página, conforme a Shopify a renderiza:
- O tipo de página — página de produto, coleção, carrinho, blog e assim por diante. É com isso que uma condição Page é comparada.
- O idioma da loja virtual em que a pessoa está navegando, que alimenta tanto a condição Language quanto o texto traduzido.
- A pessoa cliente conectada, se houver, incluindo as tags dela. É isso que as condições Customer e Customer tag leem.
- O produto que está sendo visto, em uma página de produto.
Tudo isso vem da página que a pessoa já carregou, e é por isso que as condições de cliente e de idioma são resolvidas imediatamente.
Como encontrar um lugar para renderizar
Seção intitulada “Como encontrar um lugar para renderizar”Há duas maneiras de uma contagem regressiva ganhar um lugar na página.
Automática, em páginas de produto. Se Product page estiver marcada, o script procura a área de Adicionar ao carrinho do tema e insere a contagem regressiva logo abaixo. Ele reconhece os padrões usados por uma longa lista de temas, mas um tema muito personalizado pode impedi-lo, e então nada é renderizado. Esse é o motivo mais comum de a posição automática falhar.
Blocos de shortcode. Um <div class="samita-countdown" ...> colocado por meio de um bloco de app Samita Countdown já está na página, então o script apenas o preenche. Isso funciona independentemente do tema, e é por isso que é a alternativa confiável.
As contagens regressivas de carrinho se posicionam no topo do formulário do carrinho, na página do carrinho e na gaveta do carrinho, quando o carrinho tem itens. Os Sale popups são adicionados à página e flutuam na posição que você definir.
Decidir se deve exibir
Seção intitulada “Decidir se deve exibir”Para cada contagem regressiva que poderia se aplicar, o app compara as condições com o que sabe sobre a página, o produto e a pessoa que visita. A maioria das condições é respondida na hora.
Duas precisam consultar algo:
- Collections — o app não consegue ver as coleções de um produto apenas pela página, então as busca usando o arquivo de modelo descrito em Enable the Collection condition. Sem esse arquivo, a condição não pode ser respondida e não corresponde a nada.
- Country — determinado pela consulta ao endereço IP de quem visita, e não lido da conta. Uma VPN ou um proxy muda o resultado.
Cálculo do tempo
Seção intitulada “Cálculo do tempo”O tempo restante é calculado no navegador de quem visita, comparando suas configurações com o relógio do dispositivo. Não há contagem no servidor.
É isso que deixa o app leve na sua página, e há três consequências que vale a pena conhecer:
- Quem tem o relógio do dispositivo muito errado vê um cronômetro errado.
- A janela de um Daily recurring timer é avaliada com base no relógio local da pessoa, então “9h às 11h” significa 9h no lugar onde ela está.
- Um cronômetro Countdown to a date conta até o momento que você definiu, e cada pessoa vê isso como o seu próprio tempo restante correto.
Como um cronômetro Fixed minutes é lembrado
Seção intitulada “Como um cronômetro Fixed minutes é lembrado”Um cronômetro Fixed minutes precisa sobreviver às mudanças de página, então, na primeira vez que alguém o vê, o app grava o horário de término pessoal dessa pessoa em um cookie no navegador. Nas visualizações seguintes, ele lê o cookie e continua a contagem.
Por isso: vale por navegador e por dispositivo, é perdido quando os cookies são apagados e é reiniciado para todo mundo se você alterar o número de minutos configurado.
O que o app não faz
Seção intitulada “O que o app não faz”- Ele não altera seus produtos. Nem preços, nem estoque, nem disponibilidade. Quando um cronômetro chega a zero, ele remove o cronômetro, e mais nada.
- Ele não reserva estoque. Uma contagem regressiva de carrinho é um estímulo, não uma reserva.
- Ele não edita os modelos do seu tema. Ativar a incorporação adiciona o script do app; os blocos de app são adicionados e removidos no editor de temas como qualquer outro bloco. A única exceção é o arquivo de modelo opcional para as condições de coleção, que você mesmo adiciona.