Vitrine Flash: tienda virtual con Pix, panel y píxeles de anuncios

Vitrine Flash es un sistema de tienda virtual en PHP para vender con Pix en Brasil. Lo instalas en tu servidor, registras los productos y empiezas a recibir pedidos. Funciona como una vitrina con varios productos o como la página de un solo producto, formato muy usado en anuncios pagados en redes sociales y en Google.

Para quién es
Para quienes venden productos físicos en Brasil y quieren una tienda propia, ligera y fácil de instalar, sin mensualidad de plataforma: comerciantes, gestores de tráfico y quienes montan tiendas para clientes.

Qué incluye el paquete

• site/: la tienda completa, lista para subir al hosting
• docs/manual-vitrine-flash.pdf: manual de 31 páginas, con instalación, configuración y solución de problemas
• docs/nginx.conf.exemplo: modelo de configuración para quienes usan Nginx
• tests/: pruebas automáticas (opcional)
• LEIA-ME.txt y LICENCA.txt

Ventas y pago

• Checkout simplificado, con búsqueda de dirección por CEP
• Pix con código QR y código copia y pega
• Dos formas de cobrar: Pix directo a tu clave (tú confirmas en el panel) o Mercado Pago (el pedido cambia a pagado solo)
• Cupones de porcentaje, valor fijo y envío gratis, con compra mínima, plazo y límite de usos
• Envío de valor fijo por pedido, o gratis a partir de un valor
• Oferta extra opcional en el checkout
• Stock reservado mientras el cliente paga; un pedido cancelado o vencido devuelve el stock

Productos

• Fotos, precio tachado (de/a) y control de stock
• Opciones con precio y stock propios, como talla o color
• Categorías, con búsqueda y filtro en la vitrina
• Tres estilos de vitrina (cuadrícula, lista y vitrina grande), además de cuatro temas visuales
• El producto agotado no entra al carrito; el stock bajo aparece en el panel

Panel de administración

• Panel con modo claro y oscuro
• Pedidos: marcar como pagado, enviar con código de rastreo, cancelar, reembolsar y buscar
• Carritos abandonados, con botón para retomar la conversación con el cliente
• Informes por período: ingresos, ventas por campaña y embudo desde la visita hasta la compra, con exportación en CSV
• Páginas de envío, cambios, privacidad y términos, como modelos para que los ajustes
• Modo de mantenimiento, borrar datos de prueba y recuperación de acceso por clave

Anuncios

• Píxel de Meta con API de Conversiones: la compra también se envía por el servidor, con el mismo código del navegador, para no contarla dos veces
• Google Analytics 4
• Píxel de TikTok
• Aviso de cookies que solo activa los píxeles después de aceptar
• Origen de la venta por parámetros UTM, para saber qué anuncio vendió

Temas por fecha
Claro, Navidad, Black Friday y Noir. El cambio es con un clic y, si quieres, la franja superior y el título de la página de inicio acompañan el tema.

Instalación
Sube la carpeta site/ al hosting, abre la dirección de la tienda y sigue el instalador, que revisa el servidor antes de comenzar. No necesita SSH, Composer, Node ni programador de tareas. Base de datos SQLite (ya viene lista) o MySQL/MariaDB.

Requisitos

• PHP 8.1 o más nuevo, con las extensiones pdo_sqlite (o pdo_mysql), mbstring, session, gd y curl
• Apache con mod_rewrite y .htaccess habilitado, o Nginx con PHP-FPM
• Dominio o subdominio con HTTPS, instalado en la raíz
• Uso en Brasil: Pix, real (R$) y portugués de Brasil

Lo que la tienda no hace

• Acepta solo Pix: no tiene tarjeta de crédito ni boleto
• El envío es un valor fijo; no consulta Correios ni transportistas
• No emite factura y no se integra con sistemas de gestión (ERP)
• Una moneda y un idioma

Qué se probó
Más de 1.600 verificaciones automáticas pasan con SQLite y MariaDB, en PHP 8.1 y 8.3 en el servidor integrado de PHP; Apache y Nginx se ejercitaron con PHP 8.3. Guiones de prueba en Chromium, en computadora y celular, cubren la instalación, la vitrina, el carrito, el checkout, el Pix y las pantallas del panel.

Mercado Pago, Meta, Google y TikTok se probaron contra servidores simulados, no con cuentas reales. Antes de promocionar la tienda, haz un pedido de R$ 1,00 y verifica que el dinero llegó a la cuenta correcta.

No se probaron: PHP 8.2 y 8.4, MySQL (solo MariaDB), Safari y Firefox, hostings específicos e instalación en subcarpeta.

Licencia y soporte
Uso sin plazo y sin límite de tiendas, dominios o servidores, y puedes modificar el código, el diseño y los textos. El código no puede revenderse como producto; los términos están en LICENCA.txt. Dudas de instalación y uso: chat del pedido.