A documentação e as perguntas frequentes são apresentadas em Português, tendo em conta que a esmagadora maioria dos utilizadores deste plugin é de Portugal.
🇬🇧 The documentation and FAQs are presented in Portuguese, bearing in mind that the overwhelming majority of users of this plugin are from Portugal. If you need English support, click on the technical support link next to your license key and open a ticket.
O Códigos Postais Portugueses para WooCommerce, da Naked Cat Plugins, preenche automaticamente a localidade a partir do código postal introduzido pelo cliente na finalização da compra, com sugestões de códigos postais à medida que este escreve, e faz o mesmo nos ecrãs de gestão de encomendas. Esta página reúne a documentação, as perguntas frequentes e os developer hooks disponíveis. Para preços e instalação, consulte a página do produto.
Table of Contents
Suporte
Como solicitar suporte técnico?
Se a razão pela qual necessita de suporte técnico não está mencionada nesta página, clique no link de suporte junto à chave de licenciamento, no ecrã de definições do plugin, e preencha o ticket.
Onde posso submeter vulnerabilidades de segurança encontradas neste plugin?
Pode reportar erros de segurança identificados no código deste plugin pelo Patchstack Vulnerability Disclosure Program.
A equipa do Patchstack vai ajudar na verificação, emissão de CVE e tratar de nos notificar.
Licenciamento
Como transferir a licença de domínio?
Pedir na sua área de cliente, junto à encomenda original, a mudança de domínio.
Depois de receber a nossa resposta a indicar que a chave está livre, deve ir às definições do site antigo, remover a chave e gravar. De seguida, vá às definições do site novo, introduza a mesma chave e grave. Se clonou o site, a chave de licenciamento está na base de dados, pelo que tem de a remover, gravar, voltar a introduzir e gravar novamente.
O que acontece se não renovar a minha licença?
Se a sua licença expirar, o plugin continuará a funcionar e o preenchimento automático da localidade a partir do código postal mantém-se. No entanto, perderá acesso a:
- Sugestões de códigos postais, uma vez que o modo Autocomplete deixa de estar disponível e o plugin passa a comportar-se como se estivesse configurado no modo sem sugestões, tanto no checkout clássico como no checkout de blocos
- Actualizações da base de dados dos CTT, que chegam nas actualizações do plugin: os códigos postais que já tem instalados continuam a funcionar, mas deixam de acompanhar as alterações e os novos códigos publicados
- Actualizações de funcionalidades, incluindo correcções e novas funcionalidades
- Actualizações de segurança, que são essenciais para manter a sua loja e os dados dos seus clientes seguros
- Suporte técnico, caso precise de ajuda ou tenha algum problema
Renovar a sua licença ajuda-nos a continuar a melhorar o plugin, a responder às alterações no WordPress, no WooCommerce e nos ficheiros dos CTT, e a fornecer-lhe suporte fiável. Recomendamos vivamente que a mantenha activa.
Sem qualquer chave de licenciamento válida, o plugin não activa nenhuma das suas funcionalidades.
Funcionamento geral
Guia de configuração inicial
As definições estão em WooCommerce > Definições > Avançadas > Códigos Postais Portugueses para WooCommerce.
1. Activar a licença
Introduza a chave de licenciamento e grave. Se a activação falhar, a chave é removida e é apresentado um aviso no painel de administração. Só depois de a licença estar activa é que as restantes definições aparecem.
Na primeira activação, a base de dados de códigos postais é importada para uma tabela própria. Em sites com muitos plugins ou com pouca memória disponível, esta importação pode demorar alguns segundos.
2. Escolher o modo
São dois, e ambos preenchem a localidade assim que o cliente escreve um código postal completo:
- Autocomplete, o recomendado, sugere códigos postais a partir do terceiro carácter, o que evita que o cliente se engane logo à partida
- Sem sugestões não mostra a lista, e no checkout clássico evita também o carregamento da biblioteca jQuery UI Autocomplete
3. Escolher o modo de autocompletar
Aplica-se apenas quando escolheu o modo Autocomplete:
- Apenas localidade, o recomendado, actualiza o código postal e a localidade
- Endereço completo, experimental, actualiza também os dois campos de morada e o distrito, quando disponíveis, mas nunca o número de porta
Se escolher Endereço completo, preencha a mensagem para o cliente na definição seguinte. Ela é apresentada quando os campos são preenchidos, para que o cliente confirme e complete a morada com o número de porta, andar ou outros dados em falta.
4. Activar as validações
- Validar código postal impede a finalização da compra se a parte numérica do código postal não existir na base de dados
- Validar distrito compara o código postal com o distrito seleccionado, e só aparece se tiver o plugin Portugal States (Distritos) for WooCommerce activo
Ambas as validações funcionam no checkout clássico e no checkout de blocos.
5. Avisos no backoffice
Por omissão, o ecrã de gestão de cada encomenda assinala códigos postais cuja localidade não corresponde à dos CTT. Pode desligar estes avisos na última definição.
Em que ecrãs é que o plugin actua?
- Finalização da compra, no checkout clássico e no checkout de blocos
- Edição de moradas na área de cliente
- Ecrã de gestão de encomendas, com ou sem HPOS
- Ecrã de gestão de subscrições, se tiver o WooCommerce Subscriptions
O checkout de blocos é suportado?
Sim, e de forma nativa. No checkout de blocos o plugin lê e escreve as moradas através dos data stores do próprio WooCommerce, em vez de escrever nos campos a partir de fora, o que mantém os valores, as validações e o cálculo de portes sincronizados.
A lista de sugestões é apresentada com navegação por teclado e leitores de ecrã, e a mensagem do modo Endereço completo aparece como um aviso junto à morada.
De onde vêm os códigos postais?
Directamente dos ficheiros oficiais dos CTT, que incluem os códigos postais e os apartados. São mais de 316 mil registos, guardados numa tabela própria na base de dados do seu site, o que significa que nenhuma consulta sai do seu servidor e que o preenchimento não depende de nenhum serviço externo.
A base de dados é actualizada por nós periodicamente e chega ao seu site nas actualizações normais do plugin.
Porque é que a localidade preenchida não é a que eu esperava?
A localidade é a designação postal oficial dos CTT para aquele código postal, que nem sempre coincide com o nome que se usa no dia a dia nem com a freguesia ou o concelho. É esse o valor correcto para efeitos de entrega.
O que acontece se o cliente escrever o código postal sem o traço?
É reconhecido à mesma, e não é só o traço. Espaços a mais, um espaço no meio ou um traço diferente do habitual, o que costuma acontecer quando o código postal é copiado de um Word, de um PDF ou dos contactos do telemóvel, deixam de impedir o cliente de finalizar a encomenda: sempre que tem sete dígitos, é corrigido para o formato 1234-567. Acontece nos dois checkouts, na morada da área de cliente e nas encomendas no WP Admin, e já não depende de o código postal existir na base de dados.
Integração com outros plugins
Portugal States (Distritos) for WooCommerce
Com o plugin gratuito Portugal States (Distritos) for WooCommerce activo, fica disponível a validação do distrito e, no modo Endereço completo, o distrito passa a ser preenchido automaticamente a partir do código postal.
Stripe Express Checkout, Apple Pay e Google Pay
O endereço devolvido pelo Stripe não inclui o distrito, o que provocava erros na finalização da compra em sites com o plugin de distritos activo. Este plugin corrige o endereço recebido, acrescentando o distrito correcto a partir do código postal.
Requer o plugin WooCommerce Stripe Payment Gateway na versão 10.2.0 ou superior e o plugin de distritos activo.
Developer hooks disponíveis
Tal como indicado na nossa política, a utilização de developer hooks não está abrangida pelo suporte técnico, mas deixamos abaixo um exemplo de utilização.
Filter: portuguese_postcodes_for_woocommerce_autocomplete_limit
Número máximo de sugestões devolvidas de cada vez pela pesquisa de códigos postais. Por omissão, 10.
add_filter(
'portuguese_postcodes_for_woocommerce_autocomplete_limit',
function ( $limit ) {
return 20;
}
);