📋 Manual de Gerenciamento de Parceiros - Culturando

📖 Visão Geral

A seção Parceiros é destinada a exibir negócios, instituições e colaboradores do projeto. Cada parceiro possui uma página própria (/parceiros/nome-do-parceiro/), integração nativa com mapa interativo, caixa de contatos padronizada e filtros por categoria (Áreas).

---

🧩 Estrutura da Tela de Edição

Ao criar ou editar um parceiro, você encontrará os seguintes blocos:

Bloco	Local na Tela	Função
Título	Topo	Nome oficial do parceiro
Editor de Conteúdo	Centro	Descrição completa, história, serviços, galerias, vídeos
Imagem Destacada	Coluna direita	Logo oficial do parceiro
Áreas	Coluna direita	Categoria do negócio (Gastronomia, Cultura, Passeios, etc.)
Mapa: clique para definir	Abaixo do editor	Seleção de coordenadas no mapa interativo
Dados do Marcador	Coluna direita	Título e texto do popup do mapa + zoom
Dados de Contato	Coluna direita	Endereço, telefone, e-mail, WhatsApp, redes sociais

---

🛠️ Passo a Passo: Como Adicionar um Parceiro

1. Acessar e Criar

1. No menu lateral, clique em Parceiros → Adicionar novo
2. Preencha o Título com o nome exato do estabelecimento/instituição

2. Conteúdo Principal

• Use o editor padrão para escrever a apresentação do parceiro
• Você pode inserir imagens, galerias, vídeos do YouTube, listas e formatação rica
• 💡 Dica: Evite repetir aqui os dados de contato (telefone, e-mail, WhatsApp). O sistema exibe automaticamente um box padronizado no final da página.

3. Logo (Imagem Destacada)

1. Na coluna direita, clique em Definir imagem destacada
2. Envie a logo do parceiro
3. ✅ Recomendações:
   • Formato: PNG com fundo transparente ou JPG de alta qualidade
   • Tamanho ideal: 400 × 400 px (quadrada ou circular)
   • Peso: até 150KB
   • Evite logos com margens brancas ou textos muito pequenos

4. Definir Localização no Mapa

1. Role até o box Mapa: clique para definir
2. Navegue até o endereço ou clique diretamente no local no mapa
3. O marcador será posicionado. Para ajustar:
   • Arraste o marcador para o ponto exato
   • Use a roda do mouse ou os controles +/- para definir o zoom
   • O zoom será salvo automaticamente
4. Na caixa Dados do Marcador (sidebar), preencha:
   • Coordenadas: (preenchidas automaticamente, não edite)
   • Zoom: (ajustado pelo mapa, pode editar manualmente se preferir)
   • Título: Nome que aparecerá no topo do popup do mapa
   • Conteúdo da popup: Breve descrição ou horário (ex: Seg a Sex, 9h às 18h)
5. ✅ O link “Como chegar” é gerado automaticamente no popup

5. Preencher Dados de Contato

No box Dados de Contato (sidebar), preencha:

Campo	Formato Recomendado
Endereço	Texto livre (ex: Rua das Flores, 123 - Centro)
Telefone	Apenas números e formatação visual (ex: (21) 3333-4444)
E-mail	E-mail válido (ex: contato@parceiro.com.br)
WhatsApp	Apenas números, com DDI+DDD (ex: 5521999998888)
Facebook / Instagram	URL completa (ex: https://instagram.com/parceiro)

⚠️ Importante: O box de contatos no frontend é gerado exclusivamente a partir desses campos. Se você digitar o telefone apenas no conteúdo principal, ele não aparecerá na caixa padronizada.

6. Categorizar (Áreas)

1. No box Áreas, selecione ou crie categorias (ex: Gastronomia, Cultura, Hospedagem)
2. Um parceiro pode ter múltiplas áreas
3. Isso permite filtrar a listagem no site (/area/gastronomia/, etc.)

7. Publicar

• Clique em Publicar (ou Agendar se quiser controle de data)
• Acesse /parceiros/nome-do-parceiro/ para verificar a renderização

---

🌐 Como o Parceiro Aparece no Site

Elemento	Comportamento
URL	/parceiros/{slug-do-parceiro}/
Logo	Exibida no topo, antes do conteúdo
Conteúdo	Texto rico inserido no editor
Mapa	Renderizado automaticamente se coordenadas forem definidas
Box de Contatos	Gerado automaticamente ao final, com links clicáveis (tel:, mailto:, WhatsApp, redes)
Filtros	Aparece nas listagens filtradas por Áreas

---

✅ Boas Práticas

Área	Recomendação
Nomenclatura	Use o nome comercial oficial. Evite siglas sem contexto
Conteúdo	Mantenha entre 2 e 5 parágrafos. Use subtítulos, listas e mídia
Logo	Fundo transparente sempre que possível. Teste em fundo claro e escuro
Mapa	Posicione o marcador na entrada principal do estabelecimento
Contato	Preencha WhatsApp apenas com números. O site adiciona automaticamente o link wa.me/
Áreas	Selecione no máximo 3 áreas por parceiro para manter a listagem relevante

---

🔧 Solução de Problemas

“O mapa não aparece na página do parceiro”

✅ Verifique:

• Se clicou no mapa e salvou o post (coordenadas lat/lng devem estar preenchidas)
• Se o status do post é Publicado
• Se há conflito de cache (limpe o cache do navegador/plugin)

“O box de contatos está vazio”

✅ Verifique:

• Se os campos foram preenchidos no box lateral Dados de Contato
• Se não há espaços em branco acidentais antes/depois dos valores
• Se o post foi atualizado após preencher

“A logo aparece distorcida ou cortada”

✅ Verifique:

• Se a imagem enviada é próxima de quadrada (1:1)
• Se o peso está abaixo de 150KB
• Reenvie com as dimensões recomendadas (400×400 px)

“Quero alterar a posição do marcador no mapa”

✅ Abra o parceiro novamente, clique no mapa para mover o pino, ajuste o zoom se necessário e clique em Atualizar.

---

📞 Suporte e Solicitações

Para:

• Criar novas Áreas personalizadas
• Ajustar ordem de exibição no mapa ou listagens
• Integrar dados adicionais (horário de funcionamento, link para cardápio, etc.)

Entre em contato com a equipe de desenvolvimento ou registre uma solicitação no canal de suporte.

---

Última atualização: Abril 2026
Versão do módulo: 1.0