Instalação e Configuração

Guia Passo a Passo do PAP Afiliados Pro

Este guia vai te mostrar como instalar e configurar o PAP Afiliados Pro do zero. Desde os requisitos técnicos até o seu primeiro produto cadastrado e funcionando no site.

Se você já mexe com WordPress, vai ser moleza. Se está começando agora, relaxa — vou explicar cada passo de forma clara.

---

Requisitos Mínimos

Antes de começar, confirme que seu servidor atende esses requisitos:

Sistema:

• WordPress 6.2+
• PHP 7.4+
• MySQL 5.6+ (com suporte a InnoDB)
• Permissões para criar tabelas no banco

Recursos recomendados:

• Memória PHP: mínimo 128 MB (ideal 256 MB+)
• Espaço em disco: ~5 MB para o plugin
• Servidor deve permitir upload de plugins via painel

Compatibilidade testada:

• Gutenberg (editor nativo do WordPress)
• Elementor (via widget customizado)
• Temas responsivos modernos

Nota técnica: O plugin usa tabelas InnoDB para armazenar cliques e presets. A maioria dos servidores modernos já suporta isso.

---

Método 1: Instalação via Painel WordPress

Este é o jeito mais comum e que eu recomendo. Se você tem o arquivo .zip do plugin, use este método.

Passo 1: Baixar o Plugin

1. Faça download do pap-afiliados-pro.zip
2. Salve em local fácil de achar
3. Não descompacte — WordPress precisa do .zip

Passo 2: Acessar o Painel

1. Entre no admin do WordPress
2. Menu lateral: Plugins → Adicionar Novo

[Print: Menu “Plugins” expandido com “Adicionar Novo” destacado]

3. No topo da página, clique em Enviar Plugin

[Print: Botão “Enviar Plugin” no topo da página]

Passo 3: Enviar e Instalar

1. Clique em Escolher arquivo
2. Selecione o pap-afiliados-pro.zip
3. Clique em Instalar Agora

[Print: Interface de upload com botão “Instalar Agora”]

4. Aguarde o upload e descompactação
5. Quando aparecer “Plugin instalado com sucesso”, clique em Ativar Plugin

[Print: Mensagem de sucesso com botão “Ativar Plugin”]

Passo 4: Verificar Instalação

Confirme que funcionou:

Menu do Admin:
Um novo item “PAP Afiliados Pro” deve aparecer no menu lateral (entre “Plugins” e “Configurações”)

[Print: Menu lateral com item “PAP Afiliados Pro”]

Dashboard do Plugin:
Acesse PAP Afiliados Pro → Dashboard para ver a página inicial

[Print: Dashboard mostrando visão geral: produtos, categorias, presets, cliques]

Banco de Dados:
Durante a ativação, o plugin criou automaticamente duas tabelas:

• {prefixo}_pap_clicks (rastreamento)
• {prefixo}_pap_presets (templates salvos)

Se algo der errado na ativação, veja a seção Troubleshooting no final.

---

Método 2: Instalação via WordPress.org

Nota: Este método estará disponível após aprovação no repositório oficial.

Como instalar

1. Vá em Plugins → Adicionar Novo
2. Busque por: “PAP Afiliados Pro”
3. Localize o plugin (desenvolvido por Fernando Pimenta)
4. Clique em Instalar Agora
5. Depois em Ativar

[Print: Busca de plugins mostrando PAP com botão “Instalar Agora”]

Vantagens:

• Atualizações automáticas
• Instalação com um clique
• Notificações de atualização no painel

---

Método 3: Instalação Manual (FTP)

Para usuários avançados ou quando o upload via painel não funciona (firewall, limites de upload, etc).

O que você precisa

• Cliente FTP (FileZilla, WinSCP)
• Credenciais FTP do servidor
• Arquivo pap-afiliados-pro.zip descompactado

Como fazer

1. Descompactar:

• Extraia o pap-afiliados-pro.zip
• Você terá uma pasta pap-afiliados-pro

2. Conectar via FTP:

• Abra seu cliente FTP
• Conecte no servidor
• Navegue até wp-content/plugins/

[Print: FileZilla mostrando pasta “plugins”]

3. Enviar arquivos:

• Faça upload da pasta pap-afiliados-pro completa
• Estrutura final: wp-content/plugins/pap-afiliados-pro/

4. Ativar no WordPress:

• Vá em Plugins → Plugins Instalados
• Localize “PAP Afiliados Pro”
• Clique em Ativar

5. Se der erro de permissões:

• Pasta: 755 (rwxr-xr-x)
• Arquivos: 644 (rw-r–r–)

Problemas comuns FTP

“Não foi possível criar o diretório”
→ Verifique permissões de wp-content/plugins/

“Failed to open stream”
→ Confirme que todos os arquivos foram transferidos completamente

---

Configuração Inicial

Plugin instalado e ativo? Agora vamos configurar e criar seu primeiro produto.

Acessar o Painel PAP

Clique em PAP Afiliados Pro no menu lateral. Você verá:

1. Dashboard – Visão geral
2. Adicionar Produto – Criar produtos
3. Gerenciar Produtos – Lista completa
4. Categorias – Organização
5. Importar/Exportar CSV – Cadastro em massa
6. Aparência – Template Builder
7. Estatísticas – Analytics de cliques
8. Configurações – Opções gerais
9. Ajuda – Documentação e gerador de shortcodes

[Print: Menu PAP expandido com todos os submenus]

Configurações Essenciais

Antes de criar produtos, ajuste o básico.

Acesse: PAP Afiliados Pro → Configurações

[Print: Página de configurações]

Opções principais:

Configuração	O que faz	Recomendação
Forçar carregamento de CSS	Carrega CSS mesmo sem shortcode na página	Ativar se usar widgets ou construtores de página
Limite de cliques por sessão	Anti-spam	Deixar em 3
Ativar tracking	Rastreia cliques anonimamente	Ativar (é LGPD compliant)
Marketplace padrão	Pré-selecionado ao criar produtos	Escolha seu principal (Amazon, ML, etc)
Badge padrão	Texto opcional em cards	“Oferta”, “Mais Vendido” – ou deixe vazio

Salve as alterações quando terminar.

Primeiro Produto de Teste

Vamos criar um produto manualmente para validar que tudo funciona.

1. Acessar criação:

• Vá em PAP Afiliados Pro → Adicionar Produto

[Print: Página de criação de produto]

2. Preencher campos:

Campos obrigatórios:

• Título: “Notebook Dell Inspiron 15”
• Descrição: Use o editor visual para descrever o produto

  Notebook ideal para trabalho e estudos. Processador Intel Core i5, 
  8GB RAM, SSD 256GB. Perfeito para tarefas do dia a dia.

• Preço: 2999.90 (apenas números e ponto decimal)
• Link de Afiliado: Cole seu link completo

  https://amzn.to/abc123xyz

Campos opcionais:

• Categoria: Selecione ou crie “Notebooks”
• Marketplace: Escolha “Amazon”
• Badge: “Mais Vendido” (aparece em destaque no card)
• Imagem: Clique em “Definir imagem destacada” e faça upload

[Print: Meta boxes com campos de preço, link, marketplace]

3. Publicar:

• Clique em Publicar (canto superior direito)

[Print: Botão “Publicar” destacado]

4. Copiar shortcode:
Após publicar, você verá o shortcode único do produto:

[pap_produto id="1"]

Copie esse código.

Testar no Frontend

Vamos exibir o produto em uma página.

1. Criar página de teste:

• Vá em Páginas → Adicionar Nova
• Título: “Teste PAP”

2. Adicionar shortcode:

• No editor, adicione um bloco de Shortcode (Gutenberg)
• Cole: [pap_produto id="1"]

[Print: Editor Gutenberg com bloco de shortcode]

3. Publicar e visualizar:

• Clique em Publicar
• Abra a página no site

Resultado esperado:
Card do produto renderizado com:

• ✅ Imagem
• ✅ Título clicável
• ✅ Preço formatado (R$ 2.999,90)
• ✅ Badge (se adicionou)
• ✅ Botão “Ver Oferta” ou “Comprar Agora”
• ✅ Marketplace exibido

[Print: Card do produto renderizado no frontend]

Se aparecer apenas o shortcode (texto puro):
→ Veja Troubleshooting: Shortcode não renderiza

Se renderizar mas sem imagem:
→ Veja Troubleshooting: Imagens não aparecem

---

Checklist Pós-Instalação

Confirme que tudo está OK:

• [ ] Menu PAP apareceu no admin
• [ ] Consegue criar produto
• [ ] Shortcode renderiza no frontend
• [ ] Imagens aparecem nos cards
• [ ] Tracking está ativo (clique no botão e veja se registra em Estatísticas)
• [ ] Template Builder abre sem erros

---

Troubleshooting Comum

Plugin não aparece no menu

Sintoma: Ativou o plugin mas não vê “PAP Afiliados Pro” no menu lateral

Possíveis causas:

1. Cache de admin ativo

• Solução: Limpe cache do navegador (Ctrl+Shift+Delete)
• Ou acesse painel em modo anônimo

1. Erro na ativação (silencioso)

• Solução: Desative e reative o plugin
• Vá em Plugins → Plugins Instalados
• Clique em “Desativar” depois “Ativar”

1. Conflito com plugin de segurança/roles

• Alguns plugins escondem menus por nível de acesso
• Solução: Use conta de Administrador

1. Versão incompatível do WordPress

• Confirme que tem WordPress 6.2+
• Atualize se necessário

Se nada disso resolver:
Ative WP_DEBUG e veja se há erros em wp-content/debug.log

Shortcode não renderiza

Sintoma: Aparece [pap_produto id="1"] como texto, não o card

Causas e soluções:

1. Plugin desativado

• Parece óbvio, mas acontece
• Solução: Verifique em Plugins → Plugins Instalados se está “Ativo”

1. Shortcode em local incompatível

• Alguns widgets não processam shortcodes
• Solução: Use bloco “Shortcode” no Gutenberg

1. Erro de sintaxe

• Espaços extras, aspas erradas
• Solução: Copie novamente da coluna “Shortcode” em Gerenciar Produtos

Exemplos corretos:

[pap_produto id="123"]
[pap_produto id="123" preset_id="1"]

Exemplos incorretos:

[ pap_produto id="123" ]  ❌ (espaços extras)
[pap_produto id=123]       ❌ (falta aspas)
[pap_produto]              ❌ (falta parâmetro id)

Imagens não aparecem

Sintoma: Card renderiza mas imagem não carrega

Causas e soluções:

1. Nenhuma imagem definida

• Solução: Edite o produto e adicione Imagem Destacada

1. URL inválida

• Se usando campo “URL da Imagem”, link pode estar quebrado
• Solução: Teste o link no navegador

1. Problema de permissões

• Solução: Verifique permissões de wp-content/uploads/ (deve ser 755)

1. SSL/HTTPS incompatível

• Site HTTPS mas imagens HTTP
• Solução: Use URLs HTTPS

1. Lazy loading agressivo

• Plugins de otimização podem atrasar
• Solução: Adicione exceção para .pap-product-card img

Debug rápido:

1. Clique direito no card → Inspecionar
2. Procure tag <img> e veja o src
3. Copie URL e tente abrir no navegador

Erros de PHP

Sintoma: Página em branco ou mensagens “Fatal error”

Como diagnosticar:

1. Ativar debug:
   Edite wp-config.php e adicione:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);

Erros vão para wp-content/debug.log

2. Verificar requisitos:

• PHP 7.4+ e WordPress 6.2+
• Muitos erros são por versões antigas

2. Testar conflito:

Estatísticas não registram cliques

Sintoma: Clica no botão mas nada aparece em Estatísticas

Causas e soluções:

1. JavaScript desabilitado

• Tracking depende de JS
• Solução: Teste em navegador diferente

1. Bloqueador de anúncios

• AdBlock pode bloquear o script
• Solução: Desative para testar

1. Limite de cliques (anti-spam)

• Máximo 3 cliques por produto por sessão
• Solução: Limpe cookies ou use modo anônimo

1. Cache agressivo

• Solução: Limpe cache (Ctrl+Shift+R)

Teste manual:

1. Abra Console (F12)
2. Clique no botão
3. Deve aparecer: PAP: Click tracked successfully for product 123
4. Se não aparecer, há erro de JavaScript

---

Próximos Passos

Plugin instalado e funcionando? Agora explore recursos avançados:

Personalização Visual

• Template Builder – Customize cores, layouts e espaçamentos
• CSS Customizado – Adicione seus estilos na aba “Avançado”
• Presets Múltiplos – Crie visuais diferentes para cada tipo de produto

Gestão de Produtos

• Importação CSV – Cadastre centenas de produtos de uma vez
• Categorias – Organize produtos hierarquicamente
• Tags – Crie vitrines dinâmicas

Exibição

• Shortcodes Avançados – Aprenda todos os parâmetros disponíveis
• Elementor – Use o widget PAP no page builder
• Gutenberg Blocks – Blocos customizados

Analytics

• Dashboard de Estatísticas – Entenda seus dados de cliques
• Tracking LGPD – Como funciona sem coletar dados pessoais

---

Suporte

GitHub:

• Issues: https://github.com/fernando-pimenta/pap-afiliados-pro/issues
• Wiki: https://github.com/fernando-pimenta/pap-afiliados-pro/wiki

Central de Ajuda:
Acesse PAP Afiliados Pro → Ajuda para:

• Gerador de shortcodes interativo
• FAQs
• Links úteis

Reportar bugs:

1. Ative WP_DEBUG e colete erro
2. Crie issue no GitHub com:

• Versão WordPress/PHP/PAP
• Plugins ativos
• Mensagem de erro completa

---

Versão: 1.0.1
Atualizado: Fevereiro 2026
Compatível: PAP Afiliados Pro 1.0.1+

Dica: Salve esta página nos favoritos para consultar depois.