VibeFox GLS ParcelShop for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não é ativado sem ele.
PHP: 8.0 ou superior.
GLS: o plugin não usa nem precisa de conta na GLS ou de chave de API. O mapa dos ParcelShop é público. Você precisa de um contrato com a GLS para enviar as encomendas aos ParcelShop escolhidos.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No WordPress, vá em Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_gls_parcelshop para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, ou clique em Settings embaixo do nome do plugin na página Plugins.
4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Defina o nome e os seus preços: pelo menos uma linha de Country prices (por exemplo * Default) ou um Fallback cost (veja Configuração).
6. Adicione o VibeFox GLS ParcelShop a uma zona de envio em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones.
Configuração
Todas as configurações ficam em uma única página: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Elas valem para todas as zonas de envio. Quando você adiciona o método a uma zona, a janela da zona tem apenas um campo:
Title (zone): o nome do método de envio que o cliente vê nesta zona. Deixe em branco para usar o Name geral.
Avisos no topo da página de configurações apontam problemas de configuração, por exemplo quando nenhum preço está definido ou quando nenhum dos países selecionados é coberto pelo mapa da GLS. Números inválidos são recusados com uma mensagem, e o valor anterior é mantido.
Geral
A seção lista os países cobertos pelo mapa da GLS. O método não é oferecido para outros países de destino.
Enable/Disable: ativa ou desativa o método em todas as zonas de uma vez. Padrão: ativado.
Name: o nome do método de envio exibido ao cliente. Uma zona pode substituí-lo pelo seu próprio Title. Padrão: GLS ParcelShop.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio, None não adiciona. Padrão: Taxable.
Preços
Os preços são informados na moeda da sua loja. Os decimais podem usar vírgula ou ponto (4,99 ou 4.99).
Calculation type: como o preço é aplicado.
Country prices: uma tabela com uma linha por país de destino. Clique em + Add country para adicionar uma linha e no X para remover uma. Cada linha tem um Country, um Price e cinco colunas de peso: XS até 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg e XL acima de 5 kg. Usa-se a coluna correspondente ao peso do carrinho. Uma coluna de peso deixada em 0 usa a coluna Price. A linha * Default é usada para os países que não têm linha própria. Novas linhas começam com 0 em todas as colunas, e uma linha com todos os preços em 0 significa entrega grátis, então preencha os preços antes de salvar.
Fallback cost: o preço usado quando a tabela não tem linha para o país de destino e não há linha * Default. Deixe em branco para ocultar o método para esses países.
Free shipping from: o subtotal do carrinho (após descontos, sem impostos) a partir do qual a entrega no GLS ParcelShop é grátis. Deixe em branco se a entrega nunca for grátis.
Disponibilidade
Minimum weight (kg): oculta o método quando o carrinho pesa menos. O peso é convertido da unidade de peso da sua loja. Vazio ou 0 significa sem limite.
Maximum weight (kg): oculta o método quando o carrinho pesa mais. Padrão: 20. Os GLS ParcelShop costumam aceitar pacotes de até 20 kg, então confira no seu contrato com a GLS. Vazio ou 0 significa sem limite.
Minimum cart subtotal: oferece o método somente quando o subtotal do carrinho (após descontos, sem impostos) atinge este valor. Deixe em branco para não ter mínimo.
Excluded shipping classes: oculta o método quando o carrinho tem um produto de uma destas classes de envio do WooCommerce.
Ignore shipping zones: quando ativado, o método é oferecido para os países selecionados abaixo, mesmo que não esteja adicionado à zona de envio correspondente. Quando desativado, é oferecido somente nas zonas às quais foi adicionado. Padrão: desativado.
Countries (ignore zones mode): os países de destino para esse modo. Deixe em branco para usar todos os países do mapa da GLS. Países que não estão no mapa da GLS são ignorados. Este campo é usado somente quando Ignore shipping zones está ativado.
Avançado
Debug log: registra o cálculo das tarifas e as escolhas de ParcelShop em WooCommerce > Status > Logs (origem vfd-gls-parcelshop). Nenhum dado pessoal do cliente é registrado. Desative o log quando terminar.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações e as instâncias de zona deste método. Desativar o plugin nunca exclui nada. O ParcelShop salvo nos pedidos é sempre mantido.
Como funciona na finalização de compra
Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin verifica primeiro as condições: país de entrega coberto pelo mapa da GLS, peso do carrinho, subtotal mínimo do carrinho e classes de envio excluídas. Se o subtotal do carrinho atingir Free shipping from, a entrega é grátis. Caso contrário, o preço vem da linha do país (ou da linha * Default) e da coluna de peso, ou de Fallback cost. Se nenhum preço for encontrado, o método fica oculto.
Quando o cliente seleciona o GLS ParcelShop, aparece um botão Select GLS ParcelShop abaixo do método. Ele abre o mapa oficial dos GLS ParcelShop para o país de entrega. Depois que um ParcelShop é escolhido, seu nome e endereço são exibidos e o botão muda para Change ParcelShop. A escolha é guardada na sessão do cliente, então permanece após uma atualização da finalização de compra ou um recarregamento da página.
Ao fazer o pedido, o plugin verifica se um ParcelShop foi escolhido e se ele está no país de entrega. Caso contrário, o cliente vê Por favor, selecione um GLS ParcelShop. ou O GLS ParcelShop selecionado não está no seu país de entrega. Por favor, escolha um ParcelShop novamente., e o pedido não é feito. Se o script do mapa da GLS não puder ser carregado, o cliente vê uma mensagem pedindo para recarregar a página ou escolher outro método de envio.
O mapa da GLS roda no navegador do cliente. Na página de finalização de compra, o plugin carrega o script do mapa da GLS a partir de map.gls-croatia.com, e o mapa carrega da GLS os dados dos ParcelShop e os blocos do mapa. A GLS recebe os dados habituais da requisição do visitante (endereço IP, navegador). Nada é enviado do seu servidor para a GLS.
O método funciona na finalização de compra clássica e nos blocos de Carrinho e de Finalização de compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS).
O plugin não obtém tarifas ao vivo da GLS, não cria envios da GLS, não imprime etiquetas e não rastreia encomendas. Ele não tem uma lista de ParcelShop no seu servidor, então não consegue verificar o ID do ParcelShop junto à GLS. Informe o ID do ParcelShop do pedido à GLS do modo habitual (MyGLS, seu software da GLS ou outro plugin).
Pontos de retirada
O ParcelShop escolhido é salvo com o pedido: o seu ID, o seu nome com o endereço e o seu país.
Tela de pedidos do administrador: o nome e o endereço do ParcelShop, com o ID e o país do ParcelShop, são exibidos abaixo do endereço de entrega. Se um pedido do GLS ParcelShop não tiver um ParcelShop, a tela mostra Nenhum ParcelShop foi selecionado para este pedido.
Páginas do cliente: o ParcelShop é exibido na página de agradecimento e na página de visualização do pedido na conta do cliente.
E-mails: o ParcelShop é adicionado aos e-mails do pedido, em HTML e em texto simples. Os e-mails enviados ao administrador da loja também incluem o ID do ParcelShop.
Os desenvolvedores podem ler o ParcelShop a partir dos metadados do pedido _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name e _vfd_glps_parcelshop_country.
Chave de licença
O plugin funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Cole a chave em License key e clique em Activate. O bloco mostra o status, por exemplo a data até a qual a licença está ativa e o seu domínio. Use Check now para verificar o status novamente, Change key para digitar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta na vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga de domínio. Libere a vaga na sua conta na vibefox.net.
Sem uma chave ativa, o GLS ParcelShop não é exibido aos clientes na finalização de compra. Os gerentes da loja que estiverem logados ainda o veem, marcado como (sem licença — visível somente para administradores), para que você possa configurar e testar o plugin antes de comprar uma chave. Um lembrete aparece na página Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado de novo automaticamente em segundo plano.
Solução de problemas
O GLS ParcelShop não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se o método foi adicionado à zona do país do cliente (ou se Ignore shipping zones está ativado e o país é permitido). Confirme que o país de destino está entre os países do mapa da GLS e que tem um preço (uma linha do país, a linha * Default ou Fallback cost). Confira os limites de peso, Minimum cart subtotal e Excluded shipping classes. Ative o Debug log para ver o motivo em WooCommerce > Status > Logs.
O mapa não abre: o cliente vê «Não foi possível carregar o mapa do GLS ParcelShop...» quando o script da GLS é bloqueado, por exemplo por um bloqueador de anúncios ou de privacidade, por uma política de segurança de conteúdo ou por uma queda da GLS. Permita map.gls-croatia.com na sua política de segurança de conteúdo.
A entrega está grátis para um país por engano: verifique a linha desse país em Country prices. Uma linha em que o Price e todas as colunas de peso são 0 dá entrega grátis.
A tabela ou um campo não foi salvo: um valor não é um número válido. A mensagem no topo da página indica o valor. Use dígitos com vírgula ou ponto como separador decimal.
Filtros para desenvolvedores: vfd_glps_map_countries altera a lista de países do mapa da GLS, vfd_glps_widget_url altera a URL do script do mapa da GLS.
O bloco de licença mostra um erro: siga a mensagem do bloco. Por exemplo, se a chave já estiver em uso em outro domínio, libere uma vaga na sua conta na vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave no novo domínio. Se o servidor de licenças não puder ser acessado, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todos os dados. Para removê-lo, desative e exclua-o na página Plugins. A chave de licença e o status de licença deste plugin são sempre removidos, junto com caches antigos e o arquivo de log da versão 1.0. As configurações e as instâncias de zona do método só são removidas se Remove data on uninstall estiver ativado. Caso contrário, ficam guardadas para uma reinstalação futura. O ParcelShop salvo nos pedidos é sempre mantido, e os pedidos existentes mantêm suas linhas de envio.
GLS é uma marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pela GLS.