Marketplace

[Chico Gois]

Lançamento: Marketplace para phpBB

Uma nova forma de anunciar, vender, trocar e encontrar produtos dentro da comunidade.

Olá, comunidade!

Temos o prazer de anunciar o lançamento da nova extensão Marketplace para phpBB.

A proposta é simples: transformar o fórum em um espaço mais completo para anúncios, classificados e negociações entre membros, mantendo a integração com o phpBB e sem transformar a comunidade em uma loja virtual complexa.

Principais recursos

• Página pública com visual moderno de marketplace
• Cadastro de anúncios com título, descrição, preço, localização e contato
• Upload de múltiplas imagens
• Galeria com troca de imagem principal
• Efeito de zoom/lupa na imagem do anúncio
• Quantidade disponível para produtos com mais de uma unidade
• Categorias com suporte multilíngue
• Filtros por categoria, tipo, condição, preço e localização
• Área do usuário para gerenciar os próprios anúncios
• Painel administrativo com dashboard, moderação e gerenciamento de categorias
• Sistema de denúncias e notificações
• Suporte a anúncios destacados, vendidos, expirados, ocultos e pendentes

Estoque simples, sem virar e-commerce

A extensão agora também permite informar a quantidade disponível de um produto.

Isso é útil para quem possui mais de uma unidade do mesmo item, por exemplo:

• camisetas
• acessórios
• peças
• produtos personalizados
• itens repetidos

Quando a quantidade chega a zero, o anúncio pode ser tratado como esgotado/vendido.

Importante: a extensão não implementa sistema de pagamento. Ou seja, não é um e-commerce completo com checkout, PayPal ou gateway de pagamento. A negociação continua sendo feita entre os membros, como em um marketplace/classificados.

Experiência visual melhorada

A página do anúncio recebeu melhorias importantes:

• imagem principal em destaque
• miniaturas clicáveis
• zoom ao passar o mouse
• layout mais limpo para preço, vendedor e detalhes
• melhor visualização em desktop e mobile

Integração com phpBB

A extensão foi pensada para funcionar integrada ao phpBB, respeitando:

• permissões
• usuários
• mensagens privadas
• painel de controle do usuário
• painel administrativo
• idiomas
• estilo prosilver

Administração e moderação

No ACP, os administradores podem:

• acompanhar estatísticas do marketplace
• revisar anúncios pendentes
• gerenciar categorias
• controlar regras por categoria
• analisar denúncias
• destacar ou ocultar anúncios
• visualizar status e estoque dos anúncios

Suporte multilíngue

As categorias padrão usam chaves de idioma, permitindo que sejam exibidas corretamente conforme o idioma do fórum.

Atualmente há suporte para:

• Português do Brasil
• Inglês

Objetivo da extensão

O Marketplace foi criado para comunidades que desejam oferecer um espaço organizado para compra, venda, troca ou divulgação de produtos e serviços entre os membros, sem depender de plataformas externas.

Ele pode ser usado para:

• classificados da comunidade
• anúncios de produtos usados
• serviços entre membros
• itens colecionáveis
• produtos personalizados
• pequenos vendedores dentro do fórum

Download: https://github.com/mundophpbb/marketplace

Demo: https://mundophpbb.com.br/area51/app.php/marketplace

O Marketplace está chegando para deixar o phpBB mais completo, visual e funcional.

Teste, envie sugestões e ajude a melhorar a extensão!

[Chico Gois]

Changelog - Marketplace / Classificados

Esta atualização traz uma evolução importante para a extensão Marketplace / Classificados, com foco em recursos de venda, promoções, pagamentos, acompanhamento de vendedores e melhorias visuais.

Novidades principais

• Mais anúncios deste usuário
  Adicionada uma área na página do anúncio exibindo outros anúncios publicados pelo mesmo vendedor.
• Renovação de anúncios expirados
  Anúncios expirados continuam gerenciáveis pelo autor e podem ser renovados ou republicados.
• Anúncios destacados
  Adicionado suporte a anúncios destacados, com destaque visual e prioridade na listagem pública.
• Anúncios impulsionados
  Separado o recurso de “subir anúncio” do novo recurso de impulsionamento.
• Pacotes de promoção
  Criada uma nova área no ACP para configurar pacotes de destaque, impulsionamento e renovação.
• Pagamentos via PayPal para promoções
  Adicionado fluxo de pagamento via PayPal para pacotes pagos de promoção do anúncio.
• Compra direta via PayPal
  Adicionado botão de compra direta na página pública do anúncio.
• Pagamento direto ao vendedor
  A compra do item anunciado agora usa o PayPal informado pelo vendedor no próprio anúncio. O fórum não recebe nem intermedeia o pagamento.
• Confirmação de venda pelo vendedor
  O vendedor pode confirmar ou recusar vendas diretamente pelo UCP após verificar o pagamento em sua conta PayPal.
• Seguir vendedor
  Usuários podem seguir vendedores e receber notificação quando eles publicarem novos anúncios.
• Melhorias visuais
  A interface pública, o formulário de publicação e o UCP receberam melhorias visuais com layout mais limpo, botões flat e melhor organização das informações.

Administração / ACP

• Nova opção para permitir ou desativar anúncios destacados.
• Nova opção para permitir ou desativar anúncios impulsionados.
• Nova opção para permitir solicitações de promoção.
• Nova área para gerenciamento de pacotes de promoção.
• Configurações de PayPal separadas para produção e sandbox.
• Campo de moeda convertido para menu dropdown com moedas comuns.
• Nova opção para ativar compra direta via PayPal.
• Nova opção para permitir seguir vendedores.
• Área administrativa com visualização de promoções e compras pendentes.

UCP / Área do usuário

• Melhoria visual na página “Meus anúncios classificados”.
• Cards de anúncios mais organizados.
• Ações do anúncio com botões mais claros.
• Exibição de vendas aguardando confirmação.
• Área de vendedores seguidos.
• Notificações do Marketplace melhor organizadas.

Pagamentos

• PayPal do fórum é usado apenas para pacotes pagos de promoção, como destaque e impulsionamento.
• PayPal do vendedor é usado para compra direta do item anunciado.
• A extensão informa que o fórum não intermedeia pagamento, entrega, reembolso ou disputa.
• Fluxo inicial usa validação manual, sem webhook automático.

Banco de dados / Migrations

• Adicionadas tabelas para promoções, pacotes, compras e seguidores.
• Adicionados campos para destaque, impulsionamento, renovação e PayPal do vendedor.
• Migrations revisadas para evitar duplicação de módulos e problemas em instalação limpa.
• Melhor compatibilidade em atualização incremental e reinstalação.

Correções

• Corrigido erro de dependência inválida em migration.
• Corrigida duplicação do módulo ACP de pacotes em instalação limpa.
• Corrigido redirecionamento externo para PayPal bloqueado pelo phpBB.
• Corrigida separação entre PayPal sandbox e PayPal de produção.
• Corrigido fluxo para evitar que pagamentos de compra direta fossem enviados ao admin.
• Corrigidos estados parciais de migration em ambiente online.
• Ajustados botões, alinhamentos e textos de interface.

Observações importantes

• A compra direta via PayPal é feita diretamente entre comprador e vendedor.
• O fórum não recebe valores da venda do item anunciado.
• O administrador continua podendo monetizar o fórum por meio de pacotes pagos de destaque e impulsionamento.
• Para pagamentos automáticos futuros, ainda será necessário implementar IPN/Webhook do PayPal.

Recomendado após atualizar

• Limpar o cache do phpBB.
• Atualizar os assets do navegador com CTRL + F5.
• Testar criação, edição, renovação e compra de anúncios.
• Testar permissões com usuário comum, vendedor, moderador e administrador.
• Testar PayPal em modo Sandbox antes de usar em produção.

[Chico Gois]

Como configurar o PayPal no Marketplace

Este tutorial explica como configurar o PayPal para vender pacotes pagos de destaque ou impulsionamento de anúncios no Marketplace.

Com essa configuração, quando um usuário pagar pelo PayPal, a extensão poderá receber a confirmação automática por IPN e aprovar a promoção sem intervenção manual.

1. O que você precisa antes de começar

Antes de configurar, você precisa ter:

• Uma conta PayPal Business.
• A extensão Marketplace instalada e atualizada.
• A URL pública do seu fórum funcionando com HTTPS.
• A opção de pagamentos PayPal ativada no ACP da extensão.

Importante: para testes, use primeiro o ambiente Sandbox do PayPal. O Sandbox permite simular compras sem movimentar dinheiro real.

2. Criando contas Sandbox no PayPal

Acesse:

Código: Selecionar todos

https://developer.paypal.com/

Depois faça login com sua conta PayPal.

No painel do desenvolvedor, vá em:

Código: Selecionar todos

Testing Tools > Sandbox Accounts

Normalmente o PayPal já cria duas contas sandbox:

• Business: representa o vendedor, ou seja, a conta que recebe o pagamento.
• Personal: representa o comprador, ou seja, o usuário que fará o pagamento de teste.

Você vai usar a conta Business Sandbox no ACP da extensão.

Anote o e-mail da conta Business Sandbox. Ele será usado como e-mail recebedor no Marketplace.

3. Configurando o PayPal no ACP do Marketplace

No phpBB, acesse:

Código: Selecionar todos

ACP > Extensões > Marketplace > Configurações

Procure a área de pagamentos PayPal.

Configure os campos principais:

• Ativar PayPal: Sim.
• Modo Sandbox: Sim, enquanto estiver testando.
• E-mail PayPal recebedor: coloque o e-mail da conta Business Sandbox.
• Moeda: use a mesma moeda dos pacotes, por exemplo BRL ou USD.
• Pacotes pagos: configure os valores e dias de destaque/impulsionamento.

Atenção: o e-mail PayPal configurado no ACP precisa ser exatamente o mesmo da conta Business Sandbox usada para receber o pagamento. Se for diferente, o IPN poderá chegar, mas a extensão marcará o pagamento como divergente.

4. URL de IPN do Marketplace

Na tela de configurações do Marketplace, a extensão mostra a URL de IPN.

Ela será parecida com:

Código: Selecionar todos

https://seudominio.com/marketplace/paypal/ipn

Essa é a URL que o PayPal usa para avisar automaticamente ao fórum que um pagamento foi realizado.

Copie essa URL.

5. Ativando o IPN no PayPal

No PayPal Business, procure as configurações de IPN.

Você deverá informar a URL de notificação da extensão:

Código: Selecionar todos

https://seudominio.com/marketplace/paypal/ipn

Ative o recebimento de notificações IPN.

Observação: mesmo que a extensão envie a URL de IPN automaticamente no botão de pagamento, é recomendado deixar o IPN configurado também na conta PayPal Business.

6. Testando com Sandbox

Para testar:

1. No ACP do Marketplace, mantenha o modo Sandbox ativado.
2. Crie ou acesse um anúncio no Marketplace.
3. Escolha uma opção paga de destaque ou impulsionamento.
4. Clique para pagar com PayPal.
5. Faça login usando a conta Personal Sandbox, que representa o comprador.
6. Conclua o pagamento.
7. Volte ao ACP do Marketplace.

Depois do pagamento, acesse:

Código: Selecionar todos

ACP > Extensões > Marketplace > Anúncios

Verifique o bloco:

Código: Selecionar todos

Histórico de pagamentos PayPal / IPN

Se tudo estiver correto, você deverá ver algo parecido com:

Código: Selecionar todos

Pagamento confirmado e promoção aprovada automaticamente

A promoção também deverá sair de:

Código: Selecionar todos

Aguardando pagamento

para:

Código: Selecionar todos

Aprovada

7. O que aparece no histórico do ACP

O histórico de pagamentos mostra informações como:

• Data do IPN.
• Anúncio relacionado.
• Usuário.
• Tipo de promoção: destaque ou impulsionamento.
• Referência do pagamento.
• ID da transação PayPal.
• Valor recebido.
• Moeda.
• Conta PayPal recebedora.
• Status de verificação do PayPal.
• Resultado da validação.

Exemplo de resultado correto:

Código: Selecionar todos

Pagamento confirmado e promoção aprovada automaticamente

Exemplo de resultado com problema:

Código: Selecionar todos

Pagamento recebido, mas dados não conferem

Nesse caso, verifique:

• Se o valor pago é igual ao valor do pacote.
• Se a moeda é a mesma configurada no ACP.
• Se o e-mail recebedor é o mesmo da conta Business Sandbox ou Business real.
• Se a promoção ainda está aguardando pagamento.
• Se o anúncio ainda está ativo.

8. Usando o IPN Simulator

O PayPal Developer também possui uma ferramenta chamada IPN Simulator.

Ela permite enviar notificações de teste para a URL da extensão.

Use a URL:

Código: Selecionar todos

https://seudominio.com/marketplace/paypal/ipn

No simulador, envie um IPN de teste para verificar se o fórum está recebendo a notificação.

Importante: o IPN Simulator serve para testar se a URL responde corretamente, mas o teste mais confiável é fazer uma compra sandbox completa usando uma conta Personal Sandbox.

9. Colocando em produção

Depois que o teste Sandbox funcionar corretamente:

1. Acesse o ACP do Marketplace.
2. Desative o modo Sandbox.
3. Troque o e-mail recebedor para o e-mail real da sua conta PayPal Business.
4. Confira a moeda dos pacotes.
5. Salve as configurações.
6. Limpe o cache do phpBB.
7. Faça um teste real com um valor pequeno.

A partir desse momento, pagamentos reais poderão aprovar automaticamente os destaques e impulsionamentos.

10. Resumo do fluxo

O fluxo completo é:

Código: Selecionar todos

Usuário escolhe pacote pago
Marketplace cria promoção aguardando pagamento
Usuário paga pelo PayPal
PayPal envia IPN para o fórum
Marketplace valida o IPN
Marketplace aprova automaticamente a promoção
Anúncio é destacado ou impulsionado
ACP registra tudo no histórico de pagamentos

11. Problemas comuns

O pagamento foi feito, mas não aprovou automaticamente

Verifique se o IPN chegou no histórico do ACP.

Se não chegou, confira:

• Se a URL de IPN está correta.
• Se o fórum está acessível publicamente.
• Se o site usa HTTPS válido.
• Se o modo Sandbox está correto.

O IPN chegou, mas marcou divergência

Confira:

• E-mail recebedor.
• Valor do pacote.
• Moeda.
• Status do pagamento.
• Referência da promoção.

O e-mail recebedor está diferente

No Sandbox, use o e-mail da conta Business Sandbox.

Em produção, use o e-mail da conta PayPal Business real.

O anúncio não foi impulsionado

Verifique se a promoção foi aprovada e se o campo correspondente foi atualizado:

Código: Selecionar todos

ad_boosted_until

Para anúncios destacados, o campo é:

Código: Selecionar todos

ad_featured_until

12. Recomendação final

Sempre teste primeiro em Sandbox.

Somente coloque em produção depois de confirmar no ACP que o histórico mostra:

Código: Selecionar todos

Pagamento confirmado e promoção aprovada automaticamente

Quando essa mensagem aparece, significa que o PayPal notificou o fórum, a extensão validou o pagamento e o anúncio recebeu o destaque ou impulsionamento automaticamente.

[Chico Gois]

Changelog - Marketplace

Pagamentos PayPal e Impulsionamento

• Adicionado suporte ao fluxo automático de confirmação de pagamento via PayPal IPN.
• Adicionada rota pública para recebimento de notificações PayPal:

  Código: Selecionar todos

  /marketplace/paypal/ipn

• O botão de pagamento PayPal agora envia a URL de notificação IPN para o PayPal.
• Adicionada validação do IPN diretamente com o PayPal.
• Adicionado suporte ao modo Sandbox e modo Produção para validação IPN.
• Promoções pagas podem ser aprovadas automaticamente quando o pagamento é confirmado.
• Impulsionamentos aprovados atualizam automaticamente o campo:

  Código: Selecionar todos

  ad_boosted_until

• Destaques aprovados atualizam automaticamente o campo:

  Código: Selecionar todos

  ad_featured_until

• Aprovações automáticas ficam registradas com referência de transação PayPal.

Auditoria de Pagamentos

• Criada tabela própria para logs de pagamento:

  Código: Selecionar todos

  phpbb_marketplace_payment_logs

• Cada IPN recebido passa a ser registrado no banco de dados.
• O log armazena referência de pagamento, ID da transação PayPal, status, valor, moeda, conta recebedora e resultado da validação.
• Adicionado registro de IPNs válidos, inválidos, divergentes ou ignorados.
• Adicionado registro para casos em que a promoção não é encontrada, já está aprovada ou não pode ser aplicada.

ACP - Gerenciamento e Controle

• Adicionado bloco no ACP para histórico de pagamentos PayPal/IPN.
• O histórico mostra data, anúncio, usuário, tipo da promoção, referência, transação PayPal, valor, conta recebedora, verificação e resultado.
• Promoções pendentes passaram a exibir o último IPN relacionado.
• Adicionado bloco específico:

  Código: Selecionar todos

  Usuários com promoções contratadas

• Esse bloco lista usuários que solicitaram, aguardam pagamento ou já tiveram destaque/impulsionamento aprovado.
• A listagem mostra usuário, anúncio, tipo de promoção, status, pacote, valor, pagamento, referência, último IPN e validade.

Migrations e Banco de Dados

• Adicionada migration para criação da tabela de logs de pagamento.
• Adicionada migration de reparo para garantir a existência das colunas de destaque e impulsionamento.
• A migration verifica e adiciona, quando necessário:

  Código: Selecionar todos

  ad_featured_until
  ad_featured_by
  ad_boosted_until
  ad_boosted_by

• Corrigido erro em instalações onde a coluna

  Código: Selecionar todos

  ad_boosted_by

  ainda não existia.
• Corrigido erro de SQL causado por referência incorreta à tabela de logs de pagamento.

Interface do Usuário

• Corrigido alinhamento vertical do botão de voltar na tela de criação/edição de anúncio.
• O botão de voltar continua multilíngue usando a chave:

  Código: Selecionar todos

  MARKETPLACE_BACK

• Corrigida chave não traduzida na mensagem de anúncio salvo.
• O botão de visualização passou a usar a chave já traduzida:

  Código: Selecionar todos

  MARKETPLACE_VIEW_AD

• Ajustes aplicados no template e no CSS da tela de publicação de anúncio.

Idiomas

• Adicionadas novas traduções em Português do Brasil.
• Adicionadas novas traduções em Inglês.
• Incluídas traduções para informações de IPN, histórico de pagamentos e usuários com promoções contratadas.

Arquivos principais alterados

Código: Selecionar todos

controller/main_controller.php
controller/acp_controller.php
config/services.yml
config/routing.yml
adm/style/acp_marketplace_ads.html
adm/style/acp_marketplace_settings.html
styles/all/template/marketplace_post.html
styles/all/theme/marketplace.css
language/pt_br/acp.php
language/pt_br/common.php
language/en/acp.php
language/en/common.php
migrations/v_1_4_13.php
migrations/v_1_4_14.php

Resumo

Esta atualização adiciona controle completo sobre promoções pagas no Marketplace, incluindo pagamento PayPal via IPN, aprovação automática de destaque/impulsionamento, histórico de pagamentos no ACP, auditoria de transações e uma área específica para visualizar usuários com promoções contratadas.

[Chico Gois]

Changelog - Marketplace / Classificados

Versão: atualização de melhorias visuais, notificações e página inicial - V1.7.0-rc1

Esta atualização traz melhorias no sistema de notificações do Marketplace, na exibição do atalho de Classificados no topo do fórum e adiciona um novo bloco com os anúncios mais recentes na página inicial.

Novidades

• Bloco de últimos anúncios na página inicial
  Foi adicionado um novo bloco na index do fórum para exibir os últimos 5 anúncios ativos do Marketplace.
• Melhoria visual no atalho “Classificados”
  O item de navegação do Marketplace recebeu melhor espaçamento, badge de notificação mais destacado e aparência mais integrada ao layout do phpBB.
• Badge de notificações do Marketplace
  O contador de mensagens/notificações agora é exibido de forma mais clara, semelhante a uma notificação real.
• Link separado para conversas
  Quando houver mensagens não lidas no Marketplace, o atalho poderá direcionar o usuário diretamente para a área de conversas.
• Botão “Ver conversa” nas notificações
  As notificações internas do Marketplace agora incluem um botão para acessar diretamente a conversa relacionada.

Melhorias

• Melhor organização visual das notificações de Classificados.
• Melhor destaque para mensagens não lidas.
• Integração mais clara entre notificações, conversas e anúncios do Marketplace.
• Exibição compacta dos últimos anúncios ativos na página inicial.
• Melhor experiência para usuários que acompanham mensagens e anúncios recentes.

Arquivos alterados

Código: Selecionar todos

event/main_listener.php
config/services.yml
styles/all/template/event/overall_header_navigation_prepend.html
styles/all/template/event/index_body_markforums_before.html
styles/all/template/ucp_marketplace_notifications.html
styles/all/template/ucp_marketplace_conversations.html
styles/all/theme/marketplace.css
language/pt_br/common.php
language/en/common.php

Observações

• A atualização não altera o core do phpBB.
• Após substituir os arquivos da extensão, é necessário limpar o cache do phpBB pelo ACP.
• Recomenda-se testar o envio e recebimento de mensagens do Marketplace para confirmar o funcionamento dos links de conversa.

Instalação / Atualização

1. Substitua os arquivos da extensão pela nova versão.
2. Acesse o ACP do phpBB.
3. Vá em Geral > Limpar cache.
4. Teste a página inicial, o menu “Classificados” e as notificações do Marketplace.