O Shabbify fecha automaticamente sua loja Shopify durante o Shabat e os feriados judaicos, em horários baseados no pôr do sol que você controla para o local da sua loja. Você controla o que é bloqueado, o que os clientes veem e quando a loja reabre.
Este guia cobre cada recurso do app e como usá-lo.
O que o Shabbify faz
Quando sua loja está fechada, o Shabbify pode:
- Bloquear a adição ao carrinho — os clientes não conseguem adicionar novos itens
- Bloquear o checkout (no servidor) — o checkout é rejeitado na própria etapa de checkout da Shopify
- Desativar o botão de checkout — o botão de checkout na página do carrinho fica desativado
- Bloquear a loja inteira — uma sobreposição em página inteira com sua mensagem e a contagem regressiva
Quando sua loja está aberta, o Shabbify fica invisível para os clientes.
Os períodos de fechamento são calculados a partir de:
- Shabat semanal — acendimento das velas / pôr do sol e havdalá / anoitecer no seu local
- Feriados judaicos — gerados automaticamente a partir do calendário hebraico (com opções para editar ou adicionar fechamentos personalizados)
Início rápido
Abra Apps → Shabbify → Configuração inicial para uma lista de verificação passo a passo. O fluxo completo:
| Etapa | O que fazer |
|---|---|
| 1 | Configurações → confira se Ativar o Shabbify está marcado (já vem ativado em novas instalações) |
| 2 | Editor de temas → Incorporações de app → ative Shabbify: Lógica principal → salve o tema |
| 3 | Adicione um bloco à loja virtual (Banner de texto ou Formulário de contato) pela página Configuração do tema |
| 4 | Início → defina o local, o período do Shabat e os bloqueios |
| 5 | Confira o card do checkout em Início: a regra Shabbify – Close checkout é ativada na instalação. Se aparecer desativada ou ausente, clique em Ativar o bloqueio do checkout |
| 6 | Veja a prévia dos blocos no editor de temas e depois confira sua loja virtual durante o próximo fechamento |
Visão geral das páginas do admin
| Página | Finalidade |
|---|---|
| Início | Status ao vivo (aberta/fechada), bloqueios, configurações do Shabat, fechamento manual |
| Configuração inicial | Lista de verificação interativa com links para o editor de temas |
| Configurações | Interruptor geral, horários do Shabat, Klaviyo (quando disponível) |
| Feriados | Ver, editar, adicionar ou gerar de novo os períodos de fechamento dos feriados |
| Configuração do tema | Links de um clique para ativar a incorporação de app e adicionar blocos |
| Registro de atividades | Histórico de mudanças de status, notificações e erros |
Configurações
Caminho: Apps → Shabbify → Configurações
Ativar o Shabbify
O interruptor geral. Quando desativado, sua loja fica aberta durante o Shabat e os feriados, independentemente dos horários: nenhum estado de loja fechada na loja virtual, nenhum bloqueio do checkout e nenhum e-mail de status. Novas instalações começam com ele ativado.
Configuração do Shabat
As mesmas opções da página Início (veja Configuração do Shabat e dos zmanim):
- Modo de fechamento semanal — quando o fechamento do Shabat começa (
candles= antes do pôr do sol, ouchatzos= meio-dia haláchico) - Minutos antes — quantos minutos antes do acendimento das velas a loja fecha (padrão: 18)
- Minutos depois — quantos minutos depois do anoitecer a loja reabre (padrão: 60)
- Local — usa o endereço da sua loja na Shopify por padrão; você pode definir um local personalizado se os zmanim devem ser calculados em outro lugar
Klaviyo (em algumas instalações)
Se a integração com o Klaviyo estiver ativada na sua loja, informe aqui sua chave de API e o ID do Flow para enviar notificações por SMS, quando a loja reabrir, aos clientes que se inscreveram durante o fechamento.
Início — status da loja e bloqueios
Caminho: Apps → Shabbify → Início
Painel de status
Mostra se sua loja está ABERTA ou FECHADA neste momento, incluindo:
- Próximo horário de fechamento ou reabertura
- Contagem regressiva ao vivo
- Motivo (por exemplo, Shabat, Yom Kipur)
- Tempo até a próxima verificação automática de status
Use Atualizar status agora se a tela parecer desatualizada.
Fechamento manual
Força a loja a ficar fechada imediatamente, independentemente dos horários.
Quando usar: fechamentos de emergência, fechar mais cedo antes de um feriado, ou sempre que você precisar bloquear compras fora dos horários automáticos.
Para voltar ao normal: desmarque Fechar minha loja agora (o fechamento manual) e salve. A loja volta a seguir os horários automáticos.
Bloqueios
Escolha uma ou mais opções (elas podem ser combinadas):
| Opção | O que acontece |
|---|---|
| Bloquear adição ao carrinho | Os clientes não conseguem adicionar itens ao carrinho |
| Bloquear checkout | O checkout é bloqueado no servidor (requer a regra de checkout — veja abaixo) |
| Desativar o botão de checkout | O botão de checkout na página do carrinho fica desativado |
| Bloquear a loja inteira | Sobreposição em página inteira em todas as páginas, com sua mensagem e a contagem regressiva |
Requer a incorporação no tema: o bloqueio da adição ao carrinho, o bloqueio do botão de checkout e a sobreposição da loja precisam de Shabbify: Lógica principal ativado no seu tema.
Mensagem de loja fechada
O texto que os clientes veem quando a loja está fechada (no app: Mensagem para os clientes). Aceita placeholders dinâmicos (veja Placeholders de mensagem).
Mensagem padrão:
No momento o checkout não está disponível porque a loja está fechada. Reabrimos: [[opentime]].
Definir horários manualmente
Abre uma janela para definir horários exatos de início e fim do fechamento, em vez dos zmanim calculados. Útil para testes ou fechamentos especiais de uma vez só.
Configuração do Shabat e dos zmanim
O Shabbify calcula os períodos semanais do Shabat usando o kosher-zmanim nas coordenadas e no fuso horário da sua loja.
| Configuração | Descrição |
|---|---|
| Local | Latitude/longitude para os zmanim. Por padrão, o endereço da sua loja na Shopify. Use um local personalizado se o seu negócio segue os horários de outra comunidade. |
| Modo de fechamento semanal | Candles (Shkiah) — fecha antes do pôr do sol; Chatzos — fecha no meio-dia haláchico |
| Minutos antes | Quanto tempo antes do acendimento das velas o fechamento começa |
| Minutos depois | Quanto tempo depois do anoitecer o fechamento termina |
| Dia de descanso | Dia de descanso semanal (normalmente sexta-feira) |
Depois de mudar o local ou os minutos, salve suas configurações. Os feriados podem ser gerados de novo quando os minutos antes e depois mudam.
Feriados
Caminho: Apps → Shabbify → Feriados
Feriados gerados automaticamente
Na instalação, o Shabbify gera os períodos de fechamento dos feriados do ano atual com base no seu local e nos seus horários. Os feriados suportados incluem:
- Rosh Hashaná, Yom Kipur
- Sucot (primeiro/segundo dia, Chol Hamoed, Hoshaná Rabá)
- Pessach (primeiro/segundo dia, Chol Hamoed)
- Shavuot, Purim, Tishá BeAv
- Personalizado — seus próprios períodos de fechamento, com o nome que você escolher
Gerenciar feriados
| Ação | Como |
|---|---|
| Ver | Veja todos os próximos feriados na tabela |
| Editar | Ative/desative, ajuste os horários de início/fim, personalize a mensagem de cada feriado |
| Adicionar feriado | Crie um período de fechamento totalmente personalizado |
| Excluir | Remova feriados personalizados que você criou |
| Gerar feriados de novo | Busque de novo no calendário hebraico para o(s) ano(s) selecionado(s) — use depois de mudar o local ou o fuso horário |
Os feriados também são atualizados automaticamente a cada trimestre (janeiro, abril, julho, outubro).
Configuração do tema (loja virtual)
Caminho: Apps → Shabbify → Configuração do tema
Obrigatório: Shabbify Lógica principal (incorporação de app)
Editor de temas → Incorporações de app → Shabbify: Lógica principal → Ativar → Salvar
Isso é o que faz funcionar:
- O bloqueio da adição ao carrinho
- O bloqueio do botão de checkout
- A sobreposição da loja inteira
- As atualizações de status ao vivo pela API do Shabbify
Sem essa incorporação, os bloqueios e as sobreposições não funcionam na sua loja virtual.
A página Configuração do tema verifica seu tema ativo para você: cada cartão mostra se a incorporação de app está ativada e quais blocos do Shabbify foram adicionados (e onde), com um botão para ativar, adicionar ou editar no editor de temas. Clique em Verificar de novo depois de salvar no editor de temas.
Veja o que os clientes veem
Configuração do tema → Confira o que os clientes veem mostra o banner de texto, o aviso no carrinho, o formulário de contato ou o bloqueio da loja inteira como os clientes os veem enquanto você está fechado. Usa as configurações do seu tema ativo, no idioma do seu admin, no computador ou no celular, para o Shabat, o Yom Tov ou um fechamento manual. Nada muda na sua loja.
Prévia no editor de temas
Todo bloco do Shabbify tem a opção Prévia no editor de temas:
- Loja fechada: o bloco aparece no editor de temas como se a loja estivesse fechada, para você estilizá-lo em qualquer dia.
- Status real: o bloco mostra exatamente o que os clientes veem agora.
O banner de texto vem por padrão em Loja fechada. O formulário de contato, o aviso no carrinho e a incorporação de app (o bloqueio da loja inteira) vêm por padrão em Status real, porque um pop-up ou uma sobreposição cobriria a página durante a edição normal do tema. Mude para Loja fechada para ver a prévia deles, ou use a prévia da página Configuração do tema.
Essa opção só muda o editor de temas. Na sua loja ao vivo, os blocos aparecem apenas enquanto você está fechado.
Blocos da loja virtual
Adicione estes blocos no editor de temas (Loja virtual → Temas → Personalizar):
Shabbify: Banner de texto
Um banner com sua mensagem de fechamento e a contagem regressiva ao vivo.
| Configuração | Descrição |
|---|---|
| Prévia no editor de temas | Loja fechada (padrão) ou Status real; só no editor de temas |
| Posição | Normal, fixa no topo ou fixa na parte inferior |
| Cores, espaçamento, tipografia | Combine com o seu tema |
| Mensagem | Texto formatado com os placeholders [[opentime]] e [[countdown]] |
Dica: coloque no cabeçalho para a máxima visibilidade.
Shabbify: Formulário de contato
Um formulário em pop-up ou na página, durante o fechamento, para os clientes deixarem o telefone e serem avisados quando você reabrir.
Aparece na loja ao vivo somente depois que você salva uma chave de API do Klaviyo e um ID do Flow em Configurações. Você sempre pode ver a prévia no editor de temas ou na página Configuração do tema.
| Configuração | Descrição |
|---|---|
| Modo de exibição no desktop/dispositivo móvel | Pop-up ou na página |
| Cores e desfoque da sobreposição | Personalize a aparência |
| Textos do formulário | Título, descrição, texto do botão, mensagens de sucesso/erro |
| Prévia no editor de temas | Status real (padrão) ou Loja fechada; só no editor de temas |
Requer a configuração do Klaviyo para o envio de SMS (veja Notificações por SMS).
Shabbify: Aviso no carrinho
Insere um aviso de fechamento e, opcionalmente, a inscrição para SMS na gaveta do carrinho ou na página do carrinho.
| Configuração | Descrição |
|---|---|
| Seletor CSS do carrinho | Classe CSS do contêiner do carrinho do seu tema (por exemplo, .mini-cart__items) |
| Título, descrição, rótulo do telefone | Personalize os textos |
| Cores | Cores do texto, do fundo, do título e do botão |
| Prévia no editor de temas | Status real (padrão) ou Loja fechada; só no editor de temas |
Substituir blocos antigos
Os blocos antigos (Shabbify Messaging, Shabbify Klaviyo - HP, Shabbify Klaviyo - Cart) foram removidos. Se o seu tema ainda faz referência a um deles, substitua-o no editor de temas:
| Bloco antigo | Use no lugar |
|---|---|
| Shabbify Messaging | Shabbify: Banner de texto |
| Shabbify Klaviyo - HP | Shabbify: Formulário de contato |
| Shabbify Klaviyo - Cart | Shabbify: Aviso no carrinho |
Você também pode abrir Apps → Shabbify → Configuração do tema para links de um clique que adicionam os blocos.
Bloqueio do checkout
O bloqueio do checkout tem duas partes:
1. Ative no Shabbify (Início)
Marque Bloquear checkout em Bloqueios e salve.
2. Confira a regra de checkout da Shopify
O Shabbify adiciona a regra Shabbify – Close checkout na Shopify e a ativa quando você instala o app. O card do checkout em Início e o guia de configuração mostram o estado real da regra. Se algum dia ela estiver desativada ou ausente, clique ali em Ativar o bloqueio do checkout e o Shabbify a repara.
Se o botão não conseguir ativar a regra (por exemplo, se a loja já tem o número máximo de regras de checkout), adicione-a manualmente:
- Acesse Admin da Shopify → Configurações → Checkout
- Role até Regras de checkout
- Clique em Adicionar regra
- Selecione Shabbify – Close checkout
- Defina a regra como Ativa
- Clique em Salvar
Sem essa regra, o bloqueio do checkout no servidor não funciona. O bloqueio do botão de checkout no navegador continua funcionando pela incorporação no tema.
Banner no checkout
Quando o bloqueio do checkout está ativado e a loja está fechada, um banner de aviso aparece automaticamente no checkout com sua mensagem, o horário de reabertura e a contagem regressiva. Não é preciso configurar mais nada.
Notificações por SMS (Klaviyo)
Com o Klaviyo configurado, os clientes podem se inscrever durante o fechamento para receber um SMS quando sua loja reabrir.
Configuração
- Configurações → informe a chave de API do Klaviyo e o ID do Flow → Salvar
- Adicione um bloco Formulário de contato ou Aviso no carrinho ao seu tema
- Os clientes informam o telefone durante o fechamento
- Quando a loja reabre, o Shabbify aciona seu Flow do Klaviyo para enviar o SMS
O bloco Formulário de contato fica oculto na loja ao vivo até que os dois campos do Klaviyo sejam salvos.
Requisitos
- Conta Klaviyo com um Flow de SMS configurado
- Bloco Formulário de contato ou Aviso no carrinho na sua loja virtual
- Configurações do Klaviyo visíveis no Shabbify (disponíveis em algumas instalações do app)
Placeholders de mensagem
Use estes placeholders nas mensagens dos blocos (no admin ou no editor de temas):
| Placeholder | Substituído por |
|---|---|
[[opentime]] |
Horário de reabertura formatado (por exemplo, "sábado 20:42") |
[[countdown]] |
Contagem regressiva ao vivo até a loja reabrir |
Exemplo:
Estamos fechados no Shabat e reabrimos: [[opentime]]. Tempo restante: [[countdown]]
Registro de atividades
Caminho: Apps → Shabbify → Registro de atividades
Uma linha do tempo paginada da atividade do app:
- Mudanças de status da loja (aberta ↔ fechada)
- Inscrições para notificações
- Eventos do Klaviyo (se ativado)
- Erros e conclusões de fluxos de trabalho
Útil para auditoria e solução de problemas.
Solução de problemas
A loja não fecha no Shabat
- Confirme que Ativar o Shabbify está marcado em Configurações
- Veja a página Início — o status mostra FECHADA?
- Verifique se o local e os minutos antes/depois estão corretos
- Clique em Atualizar status agora na página Início
- Em Feriados, confirme que o feriado em questão está ativo
O bloqueio não funciona na loja virtual
- Ative a incorporação de app Shabbify: Lógica principal no editor de temas
- Salve o tema
- Confirme que os bloqueios certos estão marcados na página Início
O checkout continua funcionando com a loja fechada
- Ative Bloquear checkout na página Início
- Confira o card do checkout em Início: a regra Shabbify – Close checkout deve aparecer ativada. Se estiver desativada ou ausente, clique em Ativar o bloqueio do checkout (veja Bloqueio do checkout)
O banner não aparece
- Adicione um bloco Banner de texto ou Formulário de contato no editor de temas
- Na loja ao vivo, os banners só aparecem durante um fechamento. Para conferir o estilo, use Configuração do tema → Confira o que os clientes veem ou abra o editor de temas (lá os blocos aparecem como fechados)
- Confirme que a incorporação de app está ativada (a página Configuração do tema mostra se ela está ativa)
Horários de fechamento ou reabertura errados
- Verifique o local — os zmanim são calculados a partir das coordenadas
- Ajuste os minutos antes e os minutos depois conforme o seu minhag (costume)
- Em Feriados, edite os horários de cada feriado ou clique em Gerar feriados de novo depois de mudar o local
Não vejo a loja fechar
- Confirme que Ativar o Shabbify está marcado em Configurações
- Confirme que a incorporação de app Shabbify: Lógica principal está ativada no seu tema
- Visite a loja virtual durante um período de fechamento (ou use o fechamento manual)
Perguntas frequentes
O Shabbify funciona automaticamente depois da instalação?
Em parte. O Shabbify vem ativado, os feriados são criados e a regra de checkout é ativada na instalação, mas você precisa concluir a configuração: a incorporação no tema e os bloqueios. O guia de configuração verifica a incorporação e a regra para você.
Posso fechar a loja fora do Shabat e dos feriados?
Sim. Use o fechamento manual na página Início para fechar imediatamente, ou Adicionar feriado na página Feriados para fechamentos personalizados programados.
Posso manter a loja aberta durante um fechamento programado?
Use as opções manuais do admin (fechamento manual desativado ou, se necessário, abertura forçada pelo suporte).
O que acontece se a API do Shabbify ficar temporariamente indisponível?
As extensões da loja virtual leem os metacampos da loja e usam os dados de zmanim em cache. O app foi projetado para falhar com segurança e evitar bloquear compras por causa de erros passageiros, a menos que você tenha configurado um fechamento explicitamente.
Preciso de todos os blocos do tema?
Não. Configuração mínima:
- Incorporação de app Lógica principal (obrigatória para os bloqueios)
- Pelo menos um bloco de mensagem (recomendamos o Banner de texto)
- Regra de validação do checkout (obrigatória para o bloqueio do checkout no servidor)
Com que frequência o status é atualizado?
Uma tarefa em segundo plano recalcula o status continuamente (aproximadamente a cada minuto). A página Início mostra uma contagem regressiva até a próxima verificação.
Posso usar o Shabbify com vários temas?
Ative a incorporação de app e adicione os blocos no seu tema ativo/publicado. Repita nos outros temas se você troca de tema com frequência.
O Shabbify deixa minha loja virtual mais lenta?
Não. Enquanto sua loja está aberta, o Shabbify não adiciona nada às suas páginas: nenhum script, nenhuma folha de estilo, nenhuma requisição de rede. A incorporação de app e os blocos do tema só carregam seu código a partir de 24 horas antes de um fechamento programado, durante o fechamento, quando você fecha a loja manualmente ou dentro do editor de temas.
Se você fizer um teste de velocidade (Google PageSpeed, Lighthouse etc.), faça-o com a loja aberta e compare com um teste com a incorporação de app desativada. Os dois devem ser indistinguíveis. Se você testar durante o Shabat ou um feriado, o script de bloqueio está ativo e vai aparecer nos resultados; isso é esperado.
Idiomas
O admin, as mensagens na loja virtual, a mensagem no checkout e os e-mails do Shabbify estão disponíveis em sete idiomas: inglês, hebraico (da direita para a esquerda), espanhol, francês, russo, português (Brasil) e alemão. O admin segue o idioma do seu admin da Shopify. As mensagens na loja virtual e no checkout seguem o idioma de cada cliente, quando o seu tema e a Shopify o fornecem; se você escrever sua própria mensagem, os clientes veem seu texto como foi escrito.
Sidekick da Shopify
O Sidekick, o assistente do admin da Shopify, pode responder perguntas sobre o Shabbify usando as configurações e os horários da sua própria loja:
| Você pergunta | Você recebe |
|---|---|
| "Minha loja está fechada agora? Quando ela reabre?" | O status atual, o motivo e os próximos horários de fechamento e reabertura |
| "Quais fechamentos vêm por aí nesta semana?" | Os períodos de fechamento e os feriados dos próximos dias |
| "Por que os clientes ainda conseguem finalizar a compra?" | Uma verificação de cada condição que o bloqueio do checkout precisa, com um link de correção para o que estiver errado |
| "O que falta na minha configuração do Shabbify?" | A lista de verificação da configuração, incluindo se a incorporação de app está ativada no seu tema ativo |
| "O que o Shabbify fez nesta semana?" | O registro de atividades |
O Sidekick pode ler as configurações do Shabbify, mas não alterá-las. Para mudar uma configuração, ele leva você à página certa no app. Não há nada para configurar: se o Sidekick está disponível na sua loja, as ferramentas já estão lá.
Precisa de mais ajuda?
Entre em contato com o suporte do Shabbify pelo widget de ajuda dentro do app, ou acesse a página de suporte do app na Shopify App Store.