PAP Afiliados Pro

Descrição

Transforme seu conteúdo em receita com cartões de produtos profissionais. O PAP Afiliados Pro permite exibir produtos de afiliados com modelos visuais personalizáveis, detecção automática de marketplace e estatísticas detalhadas de cliques — sem necessidade de programação.

Recursos principais

  • 5 Templates de Card: Standard, Horizontal, Minimal, Comparativo e Ranking — escolha o melhor layout para cada contexto
  • Detecção automática de marketplace: Amazon, Mercado Livre, Shopee, AliExpress e mais — detectados a partir da URL
  • 6 Shortcodes de exibição: Cartão individual, Grade, Lista, Por categoria, Recentes e Linker Inline
  • Rastreamento de cliques e estatísticas: Monitore o desempenho por produto, marketplace e período
  • Importação/Exportação de CSV: Gerencie produtos em massa (até 1.000 linhas / 5 MB) com detecção automática de codificação
  • Sistema de Badges Personalizados: 7 estilos visuais (Texto, Faixa, Estrela, Banner, Medalha, Escudo, Faixa de Cabeçalho) com configuração por predefinição
  • Privacidade em primeiro lugar: Compatível com LGPD — zero armazenamento de dados pessoais
  • Integração Gutenberg: Editor de produto com painéis de sidebar, bloco PAP Linker e tipo de formato PAP Link
  • Widget do Elementor: Integração nativa com 4 modos de exibição
  • Protegido para SEO: Proteção de 7 camadas contra indexação de páginas internas

Ideal para

  • Blogs de avaliações e comparações
  • Sites de cupons e ofertas
  • Portais de conteúdo monetizados
  • Afiliados profissionais
  • Criadores de conteúdo

Segurança e privacidade

  • Em conformidade com a privacidade (LGPD / proteção de dados)
  • Zero rastreamento de dados pessoais (sem IP, sem User Agent)
  • Sanitização completa de entradas
  • Proteção contra SQL Injection, XSS e CSRF

Personalização total

  • 5 templates de card com layouts distintos
  • 7 estilos de badge (SVG inline, sem imagens externas)
  • Controles de tipografia: tamanho da fonte do título, preço e descrição por predefinição
  • 19 variáveis CSS personalizáveis
  • Cores, bordas e espaçamentos ajustáveis
  • Predefinições salvas para reutilização

Estatísticas inteligentes

  • Painel com métricas em tempo real
  • Gráficos interativos (Chart.js local)
  • Produtos mais clicados
  • Filtros de período (7/30/90 dias)
  • Limpeza de dados com limite de taxa de segurança

Desempenho

  • Cache de objetos em 8 classes críticas
  • Carregamento condicional de scripts e estilos
  • Zero dependências externas (sem CDN)

Suporte a idiomas

  • Interface em inglês (padrão)
  • Tradução para português do Brasil incluída
  • Pronto para tradução (arquivo .pot completo incluído)

Capturas de tela

Blocos

Este plugin disponibiliza 2 blocos.

  • PAP Linker Insert trackable affiliate link.
  • PAP Product Cards Display affiliate product cards with live preview.

Instalação

  1. Envie a pasta pap-afiliados-pro para /wp-content/plugins/
  2. Ative o plugin através do menu ‘Plugins’ no WordPress
  3. Vá para ‘PAP Afiliados’ no menu administrativo
  4. Configure suas preferências em ‘Configurações’
  5. Crie seu primeiro produto em ‘Adicionar produto’

Requisitos

  • WordPress 6.2 ou superior
  • PHP 8.2 ou superior
  • MySQL 5.7 ou superior

Perguntas frequentes

Quais marketplaces são suportados?

Detectados atualmente: Amazon, Mercado Livre, Shopee e AliExpress. O marketplace é identificado automaticamente a partir da URL do link de afiliado. Você também pode usar qualquer outro link de afiliado — ele funcionará com o rótulo de marketplace “Outro”.

O plugin está em conformidade com a LGPD?

Sim! O PAP Afiliados Pro não armazena NENHUM dado pessoal (IP, User Agent, ID do usuário). Registramos apenas o ID do produto, a URL da página (apenas o caminho) e o carimbo de data/hora do clique.

Funciona com o Gutenberg?

Sim! O editor de produto utiliza painéis nativos de sidebar do Gutenberg para uma experiência de edição moderna. Também incluímos um bloco “PAP Linker” e um Tipo de Formato “PAP Link” para adicionar links de afiliados diretamente no editor de blocos, com pesquisa integrada de produtos.

Funciona com o Elementor?

Sim! Se o Elementor estiver ativo, um widget PAP será disponibilizado automaticamente com 4 modos de exibição (individual, grade, recentes, categoria).

Posso importar produtos em massa?

Sim! Use o recurso de Importação/Exportação de CSV para gerenciar centenas de produtos de uma vez. Cada arquivo suporta até 1.000 linhas e 5 MB com 8 a 13 colunas — incluindo campos opcionais para avaliação, prós, contras e dados de ranking. O plugin detecta automaticamente a codificação (UTF-8, Windows-1252, ISO-8859-1) e o delimitador (vírgula ou ponto e vírgula).

As estatísticas são precisas?

Sim! Usamos rastreamento via JavaScript (API sendBeacon) com fallback de fetch, além de 3 camadas anti-spam (cookie de 30 min, transient de 5 seg, contador de sessão) para garantir dados limpos e precisos.

Posso personalizar a aparência do cartão?

Com certeza! Escolha entre 5 templates de card (Standard, Horizontal, Minimal, Comparativo e Ranking), adicione badges personalizados com 7 estilos visuais e ajuste tipografia, cores, bordas e espaçamentos no Construtor de Modelos. Salve predefinições para reutilizar em diferentes páginas.

O que acontece quando eu desinstalar o plugin?

Por padrão, todos os dados são removidos (posts, tabelas, opções, transients). Se preferir manter os dados para uma reinstalação futura, ative a opção “Manter dados ao desinstalar” nas Configurações antes de desinstalar.

Avaliações

Não há avaliações para este plugin.

Colaboradores e desenvolvedores

“PAP Afiliados Pro” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

PAP Afiliados Pro” foi traduzido para 1 localidade. Agradecemos aos tradutores por suas contribuições.

Traduzir o “PAP Afiliados Pro” para seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.

Registro de alterações

2.7.0

  • Novo: Widget do Elementor reconstruído — seleção de produto via SELECT2 (único/múltiplo), seletor de template de card (5 layouts) e preview real do card no editor.
  • Corrigido: Espaço em branco (~178px) no topo do editor de produtos (Gutenberg).
  • Corrigido: Painel “Caixas de metadados” removido do editor de produtos (Gutenberg).

2.6.0

  • Novo: sistema completo de personalização visual com acordeão do Builder em 6 abas (Layout & Card, Tipografia, Cores, Botões & Selos, Conteúdo & Comportamento, Presets)
  • Novo: Pré-visualização CSS Instantânea para 5 campos do Builder (raio do botão, linhas da descrição, peso da fonte do título/preço, família da fonte)
  • Novo: Efeitos de Selo — 5 estilos visuais (Plano, Sombra 3D, Bisel, Entalhe, Neon) com definições de filtro SVG nativas
  • Novo: controle independente de cor da borda para o estilo de card “Com Borda”
  • Novo: bloco Gutenberg “Cards de Produto PAP” com 4 modos de exibição, pré-visualização SSR real e busca de produtos com autocompletar
  • Novo: pré-visualização do card em tempo real no editor de produtos CPT (canvas + barra lateral lado a lado)
  • Novo: texto de botão por marketplace, colunas de grade responsivas (tablet/mobile), proporções de imagem adicionais (4:3, 16:9, Automático), tag HTML do título configurável, limite de linhas da descrição, controles de peso/família da fonte, intensidade do hover, ícones de prós/contras
  • Melhoria: template Minimalista com contêiner de imagem 1:1, borda do card alinhada e modo de grade compacto
  • Melhoria: controle de Ajuste de Imagem agora disponível para os templates Horizontal e Minimalista
  • Melhoria: Construtor de Templates reorganizado de 8 para 6 abas com agrupamento semântico
  • Correção: proporção de imagem 1:1 do card nos layouts Lista Padrão e Horizontal
  • Correção: efeitos de bisel/entalhe do selo agora renderizam corretamente via filtros SVG nativos
  • Correção: definições de filtro SVG agora são emitidas no contexto admin para a pré-visualização do Builder
  • Interno: base em PHP 8.2 — autoloader, registro de marketplaces, 6 enums com valor, Settings Schema, guarda de AJAX centralizada
  • Interno: 100% de declarações de tipo em todos os métodos, ~440 linhas de código morto removidas
  • Interno: i18n atualizado para 700 entradas traduzidas (138 novas strings em pt_BR, zero perdidas)

2.5.0

  • Novo: 5 templates de card — Standard, Horizontal, Minimal, Comparativo e Ranking com seleção por shortcode ou por predefinição
  • Novo: Sistema de badges personalizados com 7 estilos SVG inline (Texto, Faixa, Estrela, Banner, Medalha, Escudo, Faixa de Cabeçalho) com configuração por predefinição
  • Novo: Controles de tipografia no Construtor de Modelos — tamanho da fonte do título, preço e descrição por predefinição com herança opcional da fonte do tema
  • Novo: Importação CSV enriquecida suporta 5 colunas opcionais (Avaliação, Prós, Contras, Posição no Ranking, Rótulo do Ranking) — compatível com o formato de 8 colunas
  • Novo: Editor de produto migrado para painéis de sidebar do Gutenberg (Detalhes do Afiliado + Dados do Card) para uma experiência de edição moderna
  • Novo: Layout responsivo para mobile do editor de produto com sidebar adaptada para telas menores
  • Novo: Construtor de Modelos expandido com seleção de template de card, configuração de badges e seções recolhíveis
  • Melhorado: Pré-visualização de predefinição do Construtor de Modelos abre em modal isolado (não afeta mais o estado de edição)
  • Melhorado: Badge do marketplace agora é clicável com link de afiliado e rastreamento de cliques
  • Melhorado: Construtor de Modelos desativa controles irrelevantes por template com avisos informativos
  • Melhorado: Block API migrada para metadados block.json (WordPress Block API v3)
  • Melhorado: Compatibilidade com WordPress 7.0 — zero avisos de depreciação
  • Corrigido: Estilos de botão (sólido, gradiente, contorno) agora renderizam corretamente em todos os 5 templates
  • Corrigido: Configuração de sombra do card mesclada corretamente com os padrões da predefinição
  • Corrigido: Classes de proporção de imagem e modo de ajuste aplicadas de forma consistente em todos os templates
  • Corrigido: Layout mobile do template Minimal mantém orientação horizontal com quebra de botão suave
  • Corrigido: Gráficos de estatísticas inicializam corretamente ao alternar entre as abas Visão Geral e Por Post

2.4.1

  • Corrigido: Botões dos cartões de produtos não centralizando corretamente no layout de grade
  • Corrigido: Seletor de arquivo de importação de predefinição não respondendo a cliques
  • Adicionado: Aviso de solicitação de avaliação acionado por marcos de uso (10 produtos ou 100 cliques)
  • Adicionado: Nova aba \”Por Post\” em Estatísticas mostrando as contagens de cliques agrupadas por URL da página
  • Melhorado: Versão mínima do PHP aumentada de 7.4 para 8.2
  • Melhorado: Adicionada verificação de versão do PHP em tempo de execução com desativação segura

2.4.0

  • Novo: Hub de Importação/Exportação — importação/exportação reorganizada em uma interface com abas (Produtos, Predefinições, Estatísticas)
  • Novo: Importação/Exportação de Predefinições — exportar predefinições para JSON e importá-las novamente com resolução de conflitos (ignorar, renomear, substituir)
  • Novo: Exportação de Estatísticas em CSV — exportar estatísticas de cliques em CSV com filtro de período (7/30/90/Todos os dias)
  • Melhorado: Reforço de segurança — adicionado wp_unslash() na entrada de estatísticas, invalidação de cache após a limpeza de estatísticas, nocache_headers nas respostas AJAX
  • Melhorado: Padrão Singleton para a instância de Linker Stats (desempenho)
  • Corrigido: Strings de visualização da importação de CSV estavam fixas (hardcoded) em português em vez de usar i18n
  • Corrigido: Condição inativa no process_row do CSV simplificada

2.3.0

  • Adicionado: Download em massa de imagens durante a importação CSV — caixa de seleção de exclusão (ativada por padrão) baixa imagens remotas de produtos para a Biblioteca de Mídia e as define como Imagem Destacada. URL original mantida como alternativa.
  • Adicionado: Teto de tamanho (10 MB por imagem), tempo limite HTTP em escopo (20s) e tamanho de lote menor (3 linhas/requisição) quando o download de imagens está habilitado.
  • Adicionado: Proteção contra repetição (replay) para lotes de importação CSV — rejeita offsets duplicados com HTTP 409.
  • Segurança: Reforço RESOURCE-EXISTS no rastreamento de cliques (AJAX e REST) — verifica se o post do produto existe e tem o post_type esperado antes de gravar as estatísticas.
  • Segurança: Reforço BULK-LIMIT nas ações em massa de produtos — limita os IDs processados a 100 por requisição.

2.2.1

  • Corrigido: Predefinições padrão não apareciam em ambientes de hospedagem após a atualização do plugin (a rotina de atualização agora é executada corretamente no fluxo padrão de atualização do WordPress sem exigir a reativação manual do plugin)
  • Corrigido: Produtos com URLs meli.la permaneciam rotulados como marketplace “outro” após a correção da detecção — adicionado mecanismo de re-verificação de marketplace por versão que atualiza automaticamente todos os produtos existentes quando os padrões de detecção mudam
  • Melhoria: Compatibilidade com cache de objetos — adicionado nocache_headers() às respostas AJAX dinâmicas e invalidação de cache consistente em todas as operações de escrita de predefinições para ambientes com cache de objetos persistente (Redis, Memcached, LiteSpeed)

2.2.0

  • Adicionado: 3 predefinições pré-configuradas instaladas na ativação — [PAP] Shopee, [PAP] Mercado Livre, [PAP] Black Friday
  • Adicionado: Estado vazio com botões de CTA na lista de produtos quando não existirem produtos
  • Adicionado: Estado vazio com link de referência de shortcode na página de estatísticas quando não houver cliques registrados
  • Adicionado: A rotina de atualização instala predefinições padrão para usuários existentes (execução única, pula se o nome já existir)
  • Corrigido: A detecção de marketplace agora reconhece URLs encurtadas meli.la para o Mercado Livre (a partir da v2.1.2)

2.1.1

  • Melhoria: Descrição do plugin reescrita para maior clareza — foco em cartões de produtos e modelos visuais
  • Adicionado: Link de ação “Configurações” na lista de plugins
  • Adicionado: Links meta de “Suporte” e “Avaliar ★” na lista de plugins
  • Corrigido: 4 avisos PHPCS para o parâmetro $hook não utilizado em callbacks admin_enqueue_scripts

2.1.0

  • Adicionado: Coluna de shortcode na lista de predefinições com cópia em um clique
  • Adicionado: Filtro/pesquisa nos menus suspensos do gerador de shortcodes (mais de 5 opções)
  • Adicionado: Pesquisa de produto por nome ou ID no gerador de shortcodes
  • Adicionado: Gráfico de distribuição de marketplace na página de Estatísticas
  • Adicionado: Coluna de marketplace na tabela detalhada de cliques
  • Melhoria: Desempenho do endpoint de pesquisa de produtos (baseado em LIKE)
  • Melhoria: Manipulação de solicitações de pesquisa com cancelamento ao inserir novos dados

2.0.3

  • Corrigido: Selo de marketplace para “Mercado Livre” exibido sem espaço (“MERCADOLIVRE”)
  • Corrigido: Várias strings da interface estavam codificadas em português em vez de inglês, causando rótulos não traduzidos no translate.wordpress.org
  • i18n: Arquivo .pot regenerado, arquivos de tradução .po/.mo atualizados

2.0.2

  • Adicionado: Coluna de ID da predefinição na lista de predefinições do Construtor de Modelos
  • Adicionado: Shortcodes agora aceitam o nome da predefinição além do ID numérico (ex: preset_id=”Meu Tema”)
  • Melhoria: Lista de predefinições migrada para layout de tabela nativa para melhor alinhamento
  • Melhoria: Cores alternadas (zebra) na lista de predefinições para melhor legibilidade
  • Corrigido: Salvamento da página de configurações não funcionando corretamente

2.0.1

  • Corrigido: O sistema de predefinições agora aplica corretamente as configurações visuais individuais por shortcode
  • Corrigido: O gerador de shortcodes produz o parâmetro preset_id correto
  • Corrigido: O rastreamento de cliques para o bloco PAP Link e PAP Linker funciona de forma confiável para todos os usuários, incluindo administradores logados
  • Melhoria: API de Blocos atualizada para a versão 3 para compatibilidade com WordPress 7.0
  • Melhoria: O Construtor de Modelos exibe um indicador visual ao editar uma predefinição

2.0.0

  • Reescrita completa do plugin (versão anterior: 1.0.2)
  • Adicionado: Suporte para marketplaces brasileiros com detecção automática
  • Adicionado: Construtor de Modelos Visual com visualização ao vivo e predefinições
  • Adicionado: 6 shortcodes (produto único, múltiplos produtos, categoria, recentes, predefinição, link inline)
  • Adicionado: Importação/Exportação de CSV com detecção de codificação e delimitador
  • Adicionado: Bloco Gutenberg (PAP Linker) e Tipo de Formato (PAP Link)
  • Adicionado: Widget do Elementor com carregamento condicional
  • Adicionado: Estatísticas com Chart.js (cópia local)
  • Adicionado: Painel com métricas em tempo real
  • Adicionado: REST API para preenchimento automático de produtos
  • Adicionado: Proteção de SEO de 7 camadas
  • Adicionado: Conformidade total com a LGPD (zero dados pessoais)
  • Adicionado: Cache de objetos em 8 classes críticas
  • Adicionado: Anti-spam com 3 camadas (cookie, transient, sessão)
  • Melhoria: Arquitetura com 20 classes (focada em dependências)
  • Melhoria: Segurança com 7 regras obrigatórias em todo o código
  • Melhoria: Prefixo exclusivo papafpro (8 caracteres) em todos os elementos
  • Melhoria: Código 100% em conformidade com os Padrões de Codificação do WordPress

1.0.2

  • Versão anterior (descontinuada)
  • Recursos básicos de afiliados