Instalação e Configuração
Guia completo para instalar o PAP Afiliados Pro e fazer a configuração inicial.
Requisitos
Antes de instalar, verifique se seu ambiente atende aos requisitos mínimos:
- WordPress: 6.2 ou superior (recomendado 6.9+)
- PHP: 7.4 ou superior (testado em 8.2)
- MySQL: 5.6+ ou MariaDB 10.0+
O plugin não depende de WooCommerce, Elementor ou qualquer outro plugin para funcionar. Se você usa Elementor, um widget nativo será ativado automaticamente. Caso contrário, nada muda.
Instalação via WordPress.org (Recomendado)
O método mais simples — direto pelo painel do WordPress:
- No admin do WordPress, acesse Plugins > Adicionar novo
- No campo de busca, digite “PAP Afiliados Pro”
- Localize o plugin nos resultados e clique em Instalar agora
- Após a instalação, clique em Ativar
Pronto. O menu PAP Afiliados Pro aparecerá na barra lateral do admin com o ícone de carrinho.
Instalação Manual (via ZIP)
Se preferir instalar manualmente:
- Baixe o arquivo ZIP do plugin em wordpress.org/plugins/pap-afiliados-pro/
- No admin do WordPress, acesse Plugins > Adicionar novo > Enviar plugin
- Selecione o arquivo ZIP e clique em Instalar agora
- Após a instalação, clique em Ativar
O Que Acontece na Ativação
Quando você ativa o plugin pela primeira vez, ele configura automaticamente:
- Tipo de conteúdo próprio — “Produtos Afiliados” aparece como um novo tipo de post, separado dos seus posts e páginas normais
- Categorias e tags — Taxonomias dedicadas para organizar seus produtos (independentes das categorias do blog)
- Tabelas no banco de dados — Duas tabelas são criadas para armazenar cliques rastreados e presets visuais
- Configurações padrão — Mais de 40 opções visuais são definidas com valores iniciais (cores, layouts, comportamento dos botões)
- Permissões — A capability
view_papafpro_statsé atribuída a administradores e editores para acesso às estatísticas
Nenhuma configuração manual é necessária para começar a usar. O plugin já vem pronto com defaults sensatos.
Estrutura do Menu
Após a ativação, o menu do plugin aparece na barra lateral com os seguintes itens:
- Dashboard — Visão geral com contadores de produtos e cliques recentes
- Adicionar Produto — Editor para cadastrar um novo produto afiliado
- Gerenciar Produtos — Listagem de todos os produtos com filtros e ações em massa
- Categorias — Gerenciamento de categorias hierárquicas (ex: Eletrônicos > Notebooks)
- Tags — Tags para classificação rápida e filtros
- Importar/Exportar CSV — Importação e exportação em massa
- Aparência — Template Builder para personalização visual
- Estatísticas — Dashboard de cliques com gráficos
- Configurações — Opções gerais do plugin
- Ajuda — Documentação integrada com gerador de shortcodes
Configuração Inicial
O plugin funciona imediatamente após a ativação, mas vale a pena dar uma olhada em duas áreas antes de cadastrar produtos.
Aparência (Template Builder)
Acesse PAP Afiliados Pro > Aparência para personalizar como seus cards de produto serão exibidos. As configurações são organizadas em abas:
- Cores — Cores de fundo, botão, preço, badge, texto e hover
- Estrutura — Estilo do card, bordas, sombras, espaçamentos, layout (grid ou lista) e colunas
- Imagem — Proporção, ajuste e fundo da imagem do produto
- Comportamento — Texto do botão, exibição de preço, título clicável, abrir em nova aba
- Preços — Formato de exibição e texto quando não há preço
- Avançado — Estilo do botão, sombra, borda e opção de forçar CSS
Todas as alterações são exibidas em tempo real no preview ao lado. Quando estiver satisfeito, salve como preset para reutilizar em diferentes páginas.
Configurações
Acesse PAP Afiliados Pro > Configurações para a única opção global do plugin:
- Manter dados na desinstalação — Se ativado, seus produtos, categorias, presets e estatísticas são preservados caso você desinstale e reinstale o plugin. Por padrão, a desinstalação remove tudo.
Cadastrando o Primeiro Produto
Para cadastrar um produto manualmente:
- Acesse PAP Afiliados Pro > Adicionar Produto
- Preencha o título do produto (nome que aparecerá no card)
- No painel lateral “Detalhes do Produto Afiliado”, preencha:
- Link de Afiliado (obrigatório) — A URL com seu código de afiliado. O marketplace é detectado automaticamente
- Preço — Valor numérico (ex: 99.90). Opcional
- URL da Imagem — Link direto para a imagem do produto. Opcional (também pode usar a Imagem Destacada do WordPress)
- Badge Personalizado — Texto curto como “Oferta” ou “Mais Vendido” (máx. 20 caracteres). Opcional
- Atribua categorias e tags conforme necessário
- Clique em Publicar
Se o link de afiliado estiver vazio, o produto será salvo automaticamente como rascunho — já que sem link, não faz sentido exibir no frontend.
Exibindo Produtos no Site
Com pelo menos um produto cadastrado, você pode exibi-lo de três formas:
Shortcode
No editor de posts ou páginas, insira:
[papafpro_produto id="1"]O número é o ID do produto (visível na listagem ou no shortcode copiável na coluna da listagem).
Bloco Gutenberg
No editor de blocos, pesquise por “PAP” para encontrar:
- PAP Produto — Exibe um card de produto
- PAP Linker — Insere um link rastreável inline no texto
Widget Elementor
Se você usa Elementor, procure por “PAP Afiliados” na aba de widgets. Arraste para a página e configure o ID do produto.
Página de Ajuda Integrada
O plugin inclui uma página de ajuda completa em PAP Afiliados Pro > Ajuda, com:
- Gerador de Shortcodes — Interface visual que monta o shortcode para você. Selecione o tipo, os filtros, e copie o resultado
- Documentação por feature — Cada funcionalidade tem um accordion com descrição, parâmetros e exemplos
- Dados dinâmicos — Os dropdowns do gerador são populados automaticamente com suas categorias, tags e presets existentes
Próximos Passos
Com o plugin instalado e o primeiro produto cadastrado:
- Personalize a aparência no Template Builder — Crie presets visuais para diferentes contextos
- Importe produtos em massa via CSV — Cadastre dezenas de produtos de uma vez
- Acompanhe os cliques nas Estatísticas — Veja quais produtos performam melhor