WP Manifestindependent plugin directory
manifest / utilities / controle-supermercado

WP Supermercado

Sistema de controle de compras de supermercado/loja

by Marco Antonio Vivas · github.com/markovivas/controle-supermercado · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/markovivas/controle-supermercado/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/markovivas/controle-supermercado ↗

Controle de Supermercado

Sistema de controle de compras de supermercado/loja para WordPress. Permite cadastrar produtos, registrar compras, buscar por código de barras (EAN) com integração à Open Food Facts, e importar/exportar dados em CSV.

Requisitos

  • PHP 8.0+
  • WordPress 6.0+
  • Permissão de administrador para acessar páginas do plugin e executar ações sensíveis

Instalação

  • Copie a pasta wp-supermarket-purchase-manager para wp-content/plugins/
  • Ative o plugin em Plugins > Instalados
  • Na primeira ativação, as tabelas são criadas e categorias/lojas padrão são inseridas

Páginas do Admin

  • Dashboard: visão geral, estatísticas e botão de reset
  • Produtos: listar, adicionar, editar, importar CSV, exportar CSV
  • Relatórios: filtros por período, categoria e loja, exportar CSV
  • Categorias: gerenciar categorias
  • Lojas: gerenciar lojas

Shortcode

  • Formulário de registro de compra:
    [product_registration]
  • Campos principais:
    • Buscar por Código de Barras: somente EAN válido (8–14 dígitos)
    • Nome do Produto, Categoria, Loja
    • Quantidade, Unidade, Preço Unitário, Total
    • Data da compra e observações

Busca por Código de Barras

  • Validação de EAN (8–14 dígitos) no front-end
  • Busca local no banco por barcode com correspondência exata e parcial
  • Integração com Open Food Facts para sugerir dados quando não houver cadastro local

Importação CSV (Produtos)

  • Formato esperado (ponto e vírgula “;” como separador):
    • Cabeçalho: Nome;Categoria;Preço Padrão;Unidade Padrão;Código de Barras
    • Preços aceitam , ou . como separador decimal (convertidos para ponto)
  • Opção para atualizar produtos existentes via código de barras
  • Acesso em Produtos > Importar CSV

Exportação CSV

  • Produtos: botão “Exportar CSV” na página de Produtos (gera produtos_YYYY-mm-dd_HH-ii-ss.csv)
  • Relatórios: botão “Exportar CSV” na página de Relatórios, respeitando filtros (gera compras_YYYY-mm-dd_HH-ii-ss.csv)

Botão de Reset

  • Local: Dashboard > Resetar Plugin
  • Ação: apaga todas as compras, produtos, categorias e lojas
  • Após o reset, categorias e lojas padrão são recriadas
  • Requer confirmação e nonce; acessível somente para administradores

Segurança

  • Ações administrativas exigem manage_options
  • Nonces específicos em importação e exportação
  • Sem armazenamento de segredos; não loga dados sensíveis

Tabelas do Banco

  • Prefixo: {$wpdb->prefix}wpsgl_
  • categories (id, name, created_at)
  • stores (id, name, address, created_at)
  • products (id, name, category_id, default_price, default_unit, barcode, created_at)
  • purchases (id, product_id, category_id, store_id, quantity, unit, unit_price, total_price, purchase_date, purchase_time, notes, created_at)

Suporte

  • Para ajustes ou novas funcionalidades (ex.: filtros adicionais na exportação, ou regras de segurança mais restritas), abra uma issue no repositório ou entre em contato com o mantenedor.