VibeFox Mondial Relay for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. O plugin não ativa sem ele.
PHP: 8.0 ou superior.
Conta Mondial Relay: o código de marca (Enseigne) e a Private Key vêm com uma conta empresarial da Mondial Relay: veja a seção para profissionais em mondialrelay.fr, sua área do cliente "Connect" ou seu contato comercial. O seletor de mapa precisa apenas do código de marca. A lista dos pontos mais próximos precisa dos dois. Para testes, a Mondial Relay fornece o código de marca BDTEST13 com a Private Key PrivateK.
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_mondialrelay para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox Mondial Relay, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Insira sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Insira seu código de marca (Enseigne) e, para o modo de lista, a Private Key. Preencha Country prices.
6. Adicione VibeFox Mondial Relay às zonas dos seus países de entrega em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones.
Configuração
Todas as configurações estão em uma única página: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. 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 desta opção na finalização de compra. Deixe vazio para usar o Name global.
Os avisos no topo da página mostram problemas que ocultam o método: código de marca ausente, Private Key ausente no modo de lista e nenhum preço para a França, a Bélgica ou a Espanha.
Geral
Enable/Disable: ativa ou desativa a Mondial Relay globalmente.
Name: o nome do método de envio exibido aos clientes na finalização de compra. Padrão: Mondial Relay Point Relais.
Tax status: Taxable adiciona o imposto do WooCommerce ao custo de envio; None não adiciona.
Conta Mondial Relay
Brand code (Enseigne): obrigatório, até 8 caracteres, por exemplo BDTEST13 para testes. Usado pelo mapa de pontos de retirada e pelo Web Service. Sem ele, os clientes não conseguem escolher um Point Relais, então o método não aparece na finalização de compra.
Private Key: necessária apenas para o seletor List of nearest points. Quando o código de marca e a Private Key estão preenchidos, a conexão com o Web Service da Mondial Relay é testada sempre que você salva as configurações, e uma mensagem mostra se eles são válidos.
Seletor de ponto de retirada
Selector: como o cliente escolhe um Point Relais.
Tarifas (na moeda da sua loja)
Country prices: preço por país de destino e peso da encomenda. Clique em + Add country para adicionar uma linha e no X para remover uma. Use a linha * Default para todos os outros países. Cada linha tem um Price e 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. Uma coluna de peso vazia ou igual a 0 usa a coluna Price. Decimais com ponto ou vírgula (4.90 ou 4,90). Linhas sem nenhum preço são removidas ao salvar, e valores que não são números são informados e deixados em branco.
Fallback cost: usado para países sem linha na tabela. Deixe vazio para ocultar o método nesses países.
Calculation type: como o preço é calculado.
Free shipping from: o subtotal do carrinho (após descontos, sem impostos) a partir do qual o envio é grátis. Deixe vazio para não ter envio grátis.
Disponibilidade
Min weight (kg): oculta o método quando o carrinho pesa menos. 0 significa sem limite.
Max weight (kg): oculta o método quando o carrinho pesa mais. A Mondial Relay aceita encomendas de até 30 kg nos Points Relais. Padrão: 30. 0 significa sem limite.
Minimum subtotal: mostra o método somente quando o subtotal do carrinho é pelo menos este valor. Deixe vazio para mostrá-lo sempre.
Disabled shipping classes: oculta o método quando o carrinho contém itens dessas classes de envio do WooCommerce.
Ignore shipping zones: oferece o método para os países abaixo, ou para todos os países suportados quando a lista está vazia, mesmo que nenhuma zona de envio os contenha.
Countries (ignore zones): os países de destino para esse modo. Este campo só é usado quando Ignore shipping zones está ativado.
Avançado
Debug log: registra o cálculo de tarifas e as chamadas ao Web Service em WooCommerce > Status > Logs (origem vfd-mondialrelay). Os erros são sempre registrados, mesmo com esta opção desativada. Nenhuma chave nem dado de cliente é registrado.
Remove data on uninstall: quando ativado, excluir o plugin remove as configurações e os métodos das zonas. A desativação nunca apaga nada. Os pontos de retirada salvos nos pedidos são mantidos.
Como funciona na finalização de compra
O método é oferecido somente para países com Points Relais: França, Bélgica, Luxemburgo, Espanha, Portugal e Países Baixos. Ele fica oculto quando o cliente não poderia escolher um ponto: sem código de marca, ou no modo de lista sem a Private Key.
Quando o cliente informa um endereço de entrega, o WooCommerce pede uma tarifa ao plugin. O plugin verifica o peso do carrinho, o subtotal mínimo e as classes de envio excluídas. O preço vem da linha do país (ou da linha *): a coluna de peso; se não houver, Price. Sem linha, usa-se o custo alternativo. Se não houver preço, o método fica oculto. Se o subtotal atingir Free shipping from, o preço passa a ser 0.
O método funciona na finalização de compra clássica e nos blocos de Carrinho e Finalização de compra. É compatível com o High-Performance Order Storage (HPOS) do WooCommerce.
O plugin não consulta tarifas em tempo real: a Mondial Relay não tem uma API pública de tarifas. Ele não cria envios, não imprime etiquetas nem rastreia encomendas. Crie os envios no seu espaço "Connect" da Mondial Relay usando o número do Point Relais exibido no pedido. A entrega em domicílio (Domicile) não é oferecida.
Pontos de retirada
Modo mapa: quando o cliente seleciona a Mondial Relay, o botão Choose a Point Relais aparece abaixo do método. Ele abre o mapa oficial da Mondial Relay para o país de entrega, o CEP e o peso da encomenda. Depois que o cliente escolhe um ponto, ele é exibido como Selected: e o botão muda para Change Point Relais. O widget do mapa é carregado de widget.mondialrelay.com e a biblioteca do mapa de unpkg.com somente quando o cliente abre o mapa. Mencione isso na sua política de privacidade.
Modo lista: uma lista suspensa - Choose a Point Relais - mostra os 10 pontos mais próximos do CEP de entrega, com a distância. O ponto escolhido é exibido com o horário de funcionamento. A lista é carregada pelo seu servidor, então nenhum script de terceiros é executado no navegador. As listas ficam em cache por 12 horas, uma resposta vazia por 1 hora, e uma requisição com falha fica registrada por 5 minutos. O tempo limite do Web Service é de 10 segundos. Se a lista não estiver disponível, o cliente vê "The list of pickup points is not available right now. Please use the map." e o mapa é oferecido.
Um ponto é obrigatório. Sem ele, o cliente vê Please choose a Mondial Relay pickup point. e o pedido não é concluído. Um ponto em outro país que o do endereço de entrega é recusado. No modo de lista, o ponto também é conferido com a lista do endereço.
O número do Point Relais, o país, o nome e o endereço são salvos no pedido. Eles aparecem na tela do pedido abaixo do endereço de entrega (com o número do Point Relais), na página de agradecimento, em My account > Orders e nos e-mails do pedido (HTML e texto simples) como Mondial Relay pickup point.
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 Mondial Relay. 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 informar 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 na sua conta na vibefox.net.
Sem uma chave ativa, a Mondial Relay não é exibida aos clientes na finalização de compra. Os gerentes da loja conectados ainda a veem, marcada como (unlicensed — visible to admins only), 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 exigem renovação. O status é verificado novamente de forma automática em segundo plano.
Solução de problemas
A Mondial Relay não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado 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). Confira os avisos no topo da página de configurações: o método fica oculto sem código de marca, no modo de lista sem a Private Key, para um país sem preço, fora dos limites de peso e subtotal, e para países sem Points Relais.
O teste do Web Service falhou após salvar: a mensagem mostra o erro da Mondial Relay, por exemplo um código de marca ou uma chave de segurança inválidos. Confira o código de marca e a Private Key com a Mondial Relay.
A lista de pontos está vazia ou indisponível: o cliente precisa informar um CEP primeiro. Se o Web Service falhar, o mapa é oferecido no lugar. Ative o Debug log e abra WooCommerce > Status > Logs, origem vfd-mondialrelay, para ver o motivo.
O mapa não abre: o mapa é carregado de widget.mondialrelay.com e unpkg.com. Verifique se algum bloqueador de privacidade ou de scripts não os está bloqueando. Desenvolvedores podem alterar as URLs dos scripts com os filtros vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url e vfd_mrel_leaflet_style_url. A lista de países suportados pode ser alterada com o filtro vfd_mrel_supported_countries.
O bloco de licença mostra um erro: siga a mensagem exibida no 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 todas as configurações. Somente as listas de pontos de retirada em cache são limpas. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status da licença deste plugin, assim como os caches, são sempre removidos. As configurações e os métodos das zonas são removidos somente se Remove data on uninstall estava ativado. Caso contrário, ficam guardados para uma futura reinstalação. Os pontos de retirada salvos nos pedidos são mantidos, e os pedidos existentes mantêm suas linhas de envio.
A Mondial Relay é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela Mondial Relay.