Vitrine Flash: Online Store with Pix, Admin Panel and Ad Pixels (PHP)

Vitrine Flash is an online store system in PHP for selling with Pix in Brazil. You install it on your own server, add your products and start receiving orders. It works as a storefront with several products or as a single-product page, a format widely used in paid ads on social networks and on Google.

Who it's for
People who sell physical products in Brazil and want their own store that is lightweight and easy to install, with no platform monthly fee: store owners, traffic managers and people who build stores for clients.

What's in the package

• site/: the complete store, ready to upload to your hosting
• docs/manual-vitrine-flash.pdf: 31-page manual with installation, setup and troubleshooting
• docs/nginx.conf.exemplo: sample configuration template for those who use Nginx
• tests/: automated tests (optional)
• LEIA-ME.txt and LICENCA.txt

Sales and payment

• Streamlined checkout, with address lookup by CEP
• Pix with QR Code and copy-and-paste code
• Two ways to get paid: Pix straight to your key (you confirm it in the panel) or Mercado Pago (the order changes to paid automatically)
• Coupons for percentage, fixed amount and free shipping, with minimum purchase, deadline and usage limit
• Fixed-price shipping per order, or free above a certain amount
• Optional extra offer at checkout
• Stock is reserved while the customer pays; a canceled or expired order returns the stock

Products

• Photos, crossed-out price (from/to) and stock control
• Options with their own price and stock, such as size or color
• Categories, with search and filter in the storefront
• Three storefront styles (grid, list and large showcase), plus four visual themes
• Sold-out products cannot be added to the cart; low stock appears in the panel

Admin panel

• Panel with light and dark mode
• Orders: mark as paid, ship with tracking code, cancel, refund and search
• Abandoned carts, with a button to resume the conversation with the customer
• Reports by period: revenue, sales by campaign and funnel from visit to purchase, with CSV export
• Shipping, exchanges, privacy and terms pages, as templates for you to adjust
• Maintenance mode, delete test data and access recovery by key

Ads

• Meta Pixel with Conversions API: the purchase is also sent through the server, with the same code as the browser, so it is not counted twice
• Google Analytics 4
• TikTok Pixel
• Cookie notice that only turns on the pixels after acceptance
• Sales source by UTM parameters, to know which ad made the sale

Seasonal themes
Light, Christmas, Black Friday and Noir. Switching is one click and, if you want, the top banner and the home page title follow the theme.

Installation
Upload the site/ folder to your hosting, open the store address and follow the installer, which checks the server before starting. No SSH, Composer, Node or task scheduler needed. SQLite database (already included) or MySQL/MariaDB.

Requirements

• PHP 8.1 or newer, with the extensions pdo_sqlite (or pdo_mysql), mbstring, session, gd and curl
• Apache with mod_rewrite and .htaccess enabled, or Nginx with PHP-FPM
• Domain or subdomain with HTTPS, installed at the root
• Use in Brazil: Pix, real (R$) and Brazilian Portuguese

What the store does not do

• Accepts only Pix: no credit card or boleto
• Shipping is a fixed amount; it does not query Correios or carriers
• Does not issue invoices and does not integrate with management systems (ERP)
• One currency and one language

What was tested
More than 1,600 automated checks pass with SQLite and MariaDB, on PHP 8.1 and 8.3 on PHP's built-in server; Apache and Nginx were exercised with PHP 8.3. Scripts in Chromium, on desktop and mobile, cover installation, the storefront, the cart, checkout, Pix and the panel screens.

Mercado Pago, Meta, Google and TikTok were tested against simulated servers, not with real accounts. Before promoting the store, place an order of R$ 1.00 and check that the money arrived in the right account.

Not tested: PHP 8.2 and 8.4, MySQL (only MariaDB), Safari and Firefox, specific hosting providers and installation in a subfolder.

License and support
Use with no time limit and no limit on stores, domains or servers, and you can change the code, the look and the texts. The code cannot be resold as a product; the terms are in LICENCA.txt. Installation and usage questions: order chat.