Vitrine Flash: loja virtual com Pix, painel e pixels de anúncios (PHP)

Vitrine Flash é um sistema de loja virtual em PHP para vender pelo Pix no Brasil. Você instala no seu servidor, cadastra os produtos e começa a receber pedidos. Funciona como vitrine com vários produtos ou como a página de um produto só, formato muito usado em anúncios pagos em redes sociais e no Google.

Para quem é
Quem vende produtos físicos no Brasil e quer uma loja própria, leve e fácil de instalar, sem mensalidade de plataforma: lojistas, gestores de tráfego e quem monta lojas para clientes.

O que vem no pacote

• site/: a loja completa, pronta para enviar à hospedagem
• docs/manual-vitrine-flash.pdf: manual de 31 páginas, com instalação, configuração e solução de problemas
• docs/nginx.conf.exemplo: modelo de configuração para quem usa Nginx
• tests/: testes automáticos (opcional)
• LEIA-ME.txt e LICENCA.txt

Vendas e pagamento

• Checkout enxuto, com busca de endereço pelo CEP
• Pix com QR Code e código copia e cola
• Dois jeitos de receber: Pix direto na sua chave (você confirma no painel) ou Mercado Pago (o pedido muda para pago sozinho)
• Cupons de percentual, valor fixo e frete grátis, com compra mínima, prazo e limite de usos
• Frete de valor fixo por pedido, ou grátis acima de um valor
• Oferta extra opcional no checkout
• Estoque reservado enquanto o cliente paga; pedido cancelado ou vencido devolve o estoque

Produtos

• Fotos, preço riscado (de/por) e controle de estoque
• Opções com preço e estoque próprios, como tamanho ou cor
• Categorias, com busca e filtro na vitrine
• Três estilos de vitrine (grade, lista e vitrine grande), além de quatro temas visuais
• Produto esgotado não entra no carrinho; estoque baixo aparece no painel

Painel de administração

• Painel com modo claro e escuro
• Pedidos: marcar como pago, enviar com código de rastreio, cancelar, reembolsar e buscar
• Carrinhos abandonados, com botão para retomar a conversa com o cliente
• Relatórios por período: receita, vendas por campanha e funil da visita até a compra, com exportação em CSV
• Páginas de envio, trocas, privacidade e termos, como modelos para você ajustar
• Modo de manutenção, apagar dados de teste e recuperação de acesso por chave

Anúncios

• Pixel da Meta com API de Conversões: a compra também vai pelo servidor, com o mesmo código do navegador, para não contar duas vezes
• Google Analytics 4
• Pixel do TikTok
• Aviso de cookies que só liga os pixels depois do aceite
• Origem da venda por parâmetros UTM, para saber qual anúncio vendeu

Temas por data
Claro, Natal, Black Friday e Noir. A troca é por um clique e, se você quiser, a faixa do topo e o título da página inicial acompanham o tema.

Instalação
Envie a pasta site/ para a hospedagem, abra o endereço da loja e siga o instalador, que confere o servidor antes de começar. Não precisa de SSH, Composer, Node nem agendador de tarefas. Banco SQLite (já vem pronto) ou MySQL/MariaDB.

Requisitos

• PHP 8.1 ou mais novo, com as extensões pdo_sqlite (ou pdo_mysql), mbstring, session, gd e curl
• Apache com mod_rewrite e .htaccess liberado, ou Nginx com PHP-FPM
• Domínio ou subdomínio com HTTPS, instalado na raiz
• Uso no Brasil: Pix, real (R$) e português do Brasil

O que a loja não faz

• Aceita só Pix: não tem cartão de crédito nem boleto
• O frete é um valor fixo; não consulta Correios nem transportadoras
• Não emite nota fiscal e não se integra a sistemas de gestão (ERP)
• Uma moeda e um idioma

O que foi testado
Mais de 1.600 verificações automáticas passam com SQLite e MariaDB, em PHP 8.1 e 8.3 no servidor embutido do PHP; Apache e Nginx foram exercitados com PHP 8.3. Roteiros no Chromium, em computador e celular, cobrem a instalação, a vitrine, o carrinho, o checkout, o Pix e as telas do painel.

Mercado Pago, Meta, Google e TikTok foram testados contra servidores simulados, não com contas reais. Antes de divulgar a loja, faça um pedido de R$ 1,00 e confira se o dinheiro caiu na conta certa.

Não foram testados: PHP 8.2 e 8.4, MySQL (só o MariaDB), Safari e Firefox, hospedagens específicas e instalação em subpasta.

Licença e suporte
Uso sem prazo e sem limite de lojas, domínios ou servidores, e você pode alterar o código, o visual e os textos. O código não pode ser revendido como produto; os termos estão no LICENCA.txt. Dúvidas de instalação e uso: chat do pedido.