=== Sevol - Programa de Afiliados para WooCommerce ===
Contributors: sevolafiliados
Tags: afiliados, afiliado, indicação, comissão, woocommerce
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Programa de afiliados completo para WooCommerce: link de indicação, cupom, comissão por produto e saques. Sem taxa e sem limite de afiliados.

== Description ==

O Sevol transforma a sua loja WooCommerce num programa de afiliados, e o programa inteiro é grátis. Não é teste, não é lista de recurso travado: afiliados ilimitados, nenhuma comissão sobre as suas vendas, nenhuma conta pra criar em lugar nenhum.

Cada afiliado ganha um link de indicação e, se você quiser, um cupom próprio do WooCommerce. Quando um cliente compra pelo link ou pelo cupom, o Sevol registra a indicação, calcula a comissão e espera o pedido ser pago de verdade antes de aprovar.

Tudo roda dentro do seu próprio WordPress. O plugin grátis não faz nenhuma chamada externa.

= O que vem =

* Cadastro de afiliado com a sua aprovação: ninguém começa a ganhar sem você deixar entrar. Você também pode cadastrar afiliados por conta própria.
* Termos do programa opcionais, que o afiliado precisa aceitar no cadastro.
* Um link de indicação por afiliado, com cookie de rastreio cuja validade você escolhe.
* Cupom nativo do WooCommerce amarrado ao afiliado: a venda é creditada mesmo quando o comprador nunca tocou no link.
* Comissão aprovada só quando o pedido chega a um status pago, e estornada sozinha se o pedido for reembolsado.
* Regras de comissão por produto, por categoria e por afiliado individual, em porcentagem ou valor fixo por unidade.
* Painel do afiliado no front da loja pelo shortcode `[sevol_painel_afiliado]`, com cliques, indicações, ganhos aprovados e pendentes.
* Pedido de saque: o afiliado solicita ao bater o mínimo que você definir, e manda junto os dados de pagamento.
* Lista de comissões com filtro por período e exportação em CSV.
* E-mails de aviso para o afiliado e para o dono da loja.
* Modo de teste, pra rodar uns pedidos e ver o fluxo inteiro antes de ir pro ar.
* Assistente de configuração na primeira ativação, que já cria a página do painel do afiliado pra você.

= Como a comissão é decidida =

O Sevol procura a taxa nesta ordem e para na primeira que achar:

1. Taxa definida no afiliado.
2. Taxa definida no produto.
3. Taxa definida na categoria do produto.
4. O padrão da loja.

Assim você paga 5% na loja toda, 15% num produto de lançamento e uma taxa especial pra um parceiro, sem as regras brigarem entre si.

= Grátis e pago =

O programa de afiliados acima é o plugin grátis, completo. Não existe versão premium dele.

Cashback é outro produto: o **Sevol Pro**, add-on pago vendido em [sevol.app](https://sevol.app). Ele devolve saldo pro cliente gastar de novo na loja. Você nunca precisa dele pra rodar o programa de afiliados, e este plugin não fica te empurrando a compra.

= Language =

The interface, the e-mails and the admin screens are in Brazilian Portuguese. The plugin was built for Brazilian WooCommerce stores, and things like Pix payout details reflect that. If you do not read Portuguese, keep this in mind before installing.

= Feito pra se comportar =

* Compatível com HPOS (armazenamento de pedidos de alta performance), declarado pela API oficial do WooCommerce.
* Não mexe no checkout. Nenhum campo extra, nenhum script injetado na página onde o seu cliente paga.
* Só hooks padrão do WooCommerce. Nada de editar arquivo do core nem gambiarra no banco.
* Nenhuma chamada pra serviço externo. Nada da sua loja, dos seus clientes ou dos seus afiliados sai do seu servidor.
* Afiliado nunca ganha comissão na própria compra.
* Desinstalação limpa: remover o plugin remove as tabelas, opções e metadados dele.

== Installation ==

1. Instale o WooCommerce e confira que ele está ativo.
2. Instale o Sevol por Plugins > Adicionar novo, ou suba o zip em Plugins > Adicionar novo > Enviar plugin.
3. Ative o plugin no menu Plugins.
4. Siga o assistente de configuração, ou vá em Sevol > Configurações e defina a comissão padrão e a validade do cookie.
5. Uma página com o shortcode do painel do afiliado é criada pra você. Também dá pra colar `[sevol_painel_afiliado]` em qualquer página sua.

== Frequently Asked Questions ==

= Precisa do WooCommerce? =

Sim. O Sevol lê os pedidos do WooCommerce pra saber quando uma venda aconteceu e quanto valeu, então o WooCommerce precisa estar instalado e ativo. Funciona com qualquer tema, e não adiciona nada à página do checkout.

= Tem limite de afiliados ou taxa por venda? =

Não pros dois. Afiliados ilimitados, nenhuma taxa sobre o seu faturamento e nenhum teto de vendas. O plugin não tira nada das suas vendas.

= Quando a comissão é aprovada? =

Quando o pedido chega a um status pago. Se o pedido for cancelado ou reembolsado depois, a comissão é estornada sozinha, desde que ainda não tenha sido paga ao afiliado.

= O plugin paga os meus afiliados? =

Não. O Sevol calcula quanto cada afiliado tem a receber e junta os dados de pagamento que ele informou, mas a transferência é você quem faz, pelo banco ou pelo meio que já usa. Depois de pagar, você marca a comissão como paga na tela de Comissões.

= Qualquer um pode se cadastrar e já sair ganhando? =

Não, e é de propósito. Todo cadastro chega como pendente e só vira afiliado quando você aprova na aba Afiliados. Você também pode cadastrar as pessoas por conta própria e pular o formulário.

= Afiliado ganha na própria compra? =

Não. A indicação é ignorada quando o comprador é o próprio afiliado.

= Posso dar comissão diferente pra um produto específico? =

Pode. Abra o produto, vá na seção Sevol e defina a taxa ali. Essa taxa ganha da regra de categoria, que ganha do padrão da loja. Taxa definida direto no afiliado ganha de todas.

= E se o cliente usar o cupom em vez do link? =

A venda é creditada do mesmo jeito. Cupom amarrado a afiliado conta como indicação por si só, o que cobre o cliente que ouviu falar de você num vídeo ou numa live e digitou o código na mão.

= O plugin manda dado pra algum servidor externo? =

Não. O plugin grátis não faz requisição externa de nenhum tipo. Tudo fica no seu próprio banco de dados, o que também significa que nenhum terceiro vê a sua lista de clientes.

= Usava a versão antiga, meus shortcodes continuam funcionando? =

Sim. `[afp_painel_afiliado]` segue funcionando como apelido de `[sevol_painel_afiliado]`, então as páginas que você já publicou continuam de pé depois da renomeação.

= O que é o Sevol Pro? =

Um add-on pago separado que adiciona cashback, vendido em sevol.app. O programa de afiliados deste plugin é completo sem ele.

== Screenshots ==

1. Painel com cliques, indicações, comissões pendentes e aprovadas.
2. Lista de afiliados, com aprovação de cadastro e taxa por afiliado.
3. Regras de comissão por produto e por categoria.
4. Lista de comissões com filtro por período e exportação em CSV.
5. O painel do afiliado no front da loja, via shortcode.
6. Pedidos de saque esperando pra marcar como pago.

== Changelog ==

= 1.0.2 =
* Segurança: as exportações em CSV não deixam mais uma célula ser lida como fórmula de planilha. O afiliado escolhe o próprio nome de exibição e os dados de pagamento, então esses campos podiam carregar uma fórmula que rodava quando o lojista abria o arquivo.
* Segurança: os cupons de afiliado agora têm teto por afiliado, e só afiliado aprovado consegue criar. Antes, o formulário podia ser reenviado sem parar e um afiliado rejeitado ainda conseguia criar cupons de desconto válidos.
* Segurança: o cookie de indicação agora sai com HttpOnly, SameSite=Lax e, em loja com HTTPS, Secure.
* Afiliado com cadastro rejeitado não vê mais o painel de afiliado.

= 1.0.1 =
* Entrada blindada: todo valor lido de uma requisição agora é sanitizado no ponto em que é lido, incluindo campos de array.

= 1.0.0 =
* Primeira versão pública.

== Upgrade Notice ==

= 1.0.2 =
Versão de segurança. Corrige injeção de fórmula no CSV, limita a criação de cupom de afiliado e blinda o cookie de indicação. Recomendada pra toda loja.

= 1.0.1 =
Entrada blindada nas telas do admin.

= 1.0.0 =
Primeira versão pública.
