O módulo de carrinhos abandonados pode usar a base gratuita GeoLite2 Country, da MaxMind, para identificar o país aproximado do IP de cada visitante. Quando a base está configurada, carrinhos completamente anônimos de fora do Brasil deixam de aparecer na lista administrativa.
A captura não é bloqueada e nenhum carrinho é apagado. Se o visitante preencher nome, sobrenome, e-mail ou telefone, o registro volta a aparecer normalmente, independentemente do país.
1. Criar uma conta na MaxMind
Acesse Criar uma conta MaxMind, preencha o cadastro e confirme o endereço de e-mail.
Depois de entrar no portal da MaxMind, solicite acesso ao GeoLite. A MaxMind precisa aprovar a utilização da base antes de liberar a criação da chave. Essa aprovação geralmente é automática, mas em alguns casos pode exigir uma análise adicional.
Espere o acesso ao GeoLite aparecer como ativo na conta antes de continuar.
2. Gerar a license key
Com o GeoLite aprovado:
- Entre no portal da MaxMind.
- Abra Account → Manage License Keys.
- Selecione a opção para gerar uma nova chave.
- Informe uma descrição que identifique a loja, por exemplo
WooCommerce - Minha Loja. - Gere e copie a chave.
A MaxMind mostra a chave completa somente no momento da criação. Se ela for perdida, será necessário substituí-la por uma nova. Trate a license key como uma senha e não a publique em documentos, tickets ou repositórios.
3. Informar a chave no WooCommerce
No painel do WordPress, acesse:
WooCommerce → Configurações → Integrações → MaxMind Geolocation
Cole a chave no campo MaxMind License Key e salve as alterações. Ao validar a chave, o WooCommerce baixa a base GeoLite2-Country.mmdb para o servidor.
Na mesma tela, confira o caminho exibido para o arquivo da base. A restrição dos carrinhos só entra em funcionamento quando esse arquivo existe e pode ser lido pelo WordPress.
Não é obrigatório mudar a opção Localização padrão do cliente para utilizar esta restrição. O módulo consulta diretamente a base local configurada na integração MaxMind.
Como os carrinhos são filtrados
Com a base disponível, o país estimado pelo IP é salvo junto ao carrinho. Por padrão, a lista administrativa segue estas regras:
- Carrinho anônimo do Brasil: aparece normalmente.
- Carrinho anônimo de outro país: fica oculto.
- Carrinho com nome, sobrenome, e-mail ou telefone: aparece, independentemente do país.
- Carrinho antigo sem país armazenado: continua aparecendo por compatibilidade.
- Base MaxMind ausente ou indisponível: a restrição não é aplicada.
Um carrinho é considerado anônimo somente quando nome, sobrenome, e-mail e telefone estão todos vazios. Assim que o visitante preencher qualquer um desses dados, o mesmo registro pode aparecer na lista sem depender do país detectado.
Carrinhos estrangeiros anônimos continuam armazenados. Isso permite que o registro seja recuperado caso o visitante se identifique posteriormente. A regra apenas reduz o ruído exibido na administração.
Permitir outros países
O Brasil (BR) é o único país permitido para carrinhos anônimos por padrão. Para incluir outros países, use o filtro abaixo em um plugin de snippets ou no código da loja:
add_filter( 'rishi_abandoned_carts_allowed_anonymous_countries', function( array $countries ): array {
return [ 'BR', 'PT', 'US' ];
} );
Use códigos de duas letras no padrão ISO 3166-1, sempre em maiúsculas.