WP Manifestindependent plugin directory
manifest / content / valle-branco-onde-encontrar

Valle Branco — Onde Encontrar self-updates

Plugin WordPress Valle Branco — Onde Encontrar (mapa, n8n, relatório)

by Valle Branco · github.com/elissonldr/valle-branco-onde-encontrar · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/elissonldr/valle-branco-onde-encontrar/archive/refs/heads/master.zip

Ships its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.

Readme

Valle Branco — Onde Encontrar

Plugin WordPress para o mapa de pontos de venda da Valle Branco.

Contexto

  • O site no Lovable foi um preview.
  • O site oficial será em WordPress.
  • Este plugin implementa Onde encontrar, com foco em desempenho, praticidade e organização.
  • A automação vem do n8n: lê notas fiscais, identifica produto e estabelecimento, e atualiza o mapa (fluxo diário).
  • No painel há relatório de entradas, com datas e tempo que o produto está no local.

Instalação local (XAMPP)

Pasta:

C:\xampp\htdocs\valle-branco\wp-content\plugins\valle-branco-onde-encontrar

  1. Ative em Plugins no WordPress.
  2. Menu Onde Encontrar → Configurações (chave da API + webhook n8n).
  3. Em uma página: [vb_onde_encontrar]

Estrutura

valle-branco-onde-encontrar/
├── valle-branco-onde-encontrar.php   # arquivo principal
├── uninstall.php
├── includes/                         # classes PHP
├── admin/                            # painel (CSS + views)
└── public/                           # mapa (CSS + JS)

Como usar no site

Elementor (recomendado)

Categoria Valle Branco:

  1. Onde Encontrar — Busca
  2. Onde Encontrar — Filtro
  3. Onde Encontrar — Mapa
  4. Onde Encontrar — Lista (opcional)

Deixe o campo Grupo igual em todas as peças da mesma página (ex.: padrao).

Shortcodes

Peça Código
Mapa [vb_oe_mapa]
Busca [vb_oe_busca]
Filtro [vb_oe_filtro]
Lista [vb_oe_lista]
Tudo junto [vb_onde_encontrar]

No painel: Onde Encontrar → Como usar.

API n8n + SAP B1

Configure o webhook e a chave no painel (Onde Encontrar → Configurações). Não versionar URLs ou chaves.

Método Rota Uso
POST /wp-json/valle-branco/v1/sincronizar 1 item
POST /wp-json/valle-branco/v1/sincronizar-lote vários itens
GET /wp-json/valle-branco/v1/locais mapa (público)
GET /wp-json/valle-branco/v1/relatorio relatório (admin)

Header: X-VB-API-Key: sua-chave

Aceita campos SAP flat (ItemCode, CardCode, DocNum…) ou JSON organizado (produto / estabelecimento).

Tabela SAP Uso
OINV Notas
ORDR + RDR1 Pedidos e itens
OITM Produtos
OITB Grupo / categoria
OCRD Cliente → ponto no mapa
OCPR / OSLP Contato / vendedor (observação)

Subir no site publicado

  1. Compacte a pasta do plugin em .zip, ou clone este repositório.
  2. Envie para wp-content/plugins/ no servidor.
  3. Ative e configure a chave de API + URL do webhook n8n no painel.

Read the full README on GitHub →