VibeFox LP Express 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.

LP Express: não é necessária uma conta de API. A LP Express não tem uma API pública de preços. A API da Unisend está disponível apenas para clientes com contrato e não é usada por este plugin, então você insere seus próprios preços (contratuais). Crie os pacotes na sua conta Unisend ("Mano siuntos").

Lista de terminais de pacotes: o plugin usa a lista pública de terminais LP Express, a mesma que os plugins antigos da LP Express utilizavam. Na data do lançamento da versão 1.1.0, essa lista online estava indisponível. Enquanto estiver indisponível, o plugin usa a última cópia baixada, se houver, ou então a sua própria lista. Esteja preparado para inserir sua própria lista (veja Configuração).

Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.

Instalação

1. No WordPress, acesse Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta vfd_lp_express para /wp-content/plugins/ por FTP.

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Shipping > VibeFox LP Express, 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. Preencha a tabela de preços (pelo menos uma linha) ou um custo alternativo. Verifique a linha de status sobre os terminais de pacotes no topo da página e adicione sua própria lista de terminais se a lista online não estiver disponível.

6. Adicione VibeFox LP Express à sua zona da Lituânia em WooCommerce > Settings > Shipping > Shipping zones, ou ative Ignore shipping zones e escolha os países.

Configuração

Todas as configurações estão em uma única página: WooCommerce > Settings > Shipping > VibeFox LP Express. 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 que os clientes veem nesta zona. Deixe vazio para usar o Method title global.

No topo da página, avisos mostram problemas e o status dos terminais. Um aviso vermelho aparece quando nenhum preço está definido ou nenhum terminal de pacotes está disponível, porque então o método não é exibido na finalização de compra. Uma linha informativa mostra quantos terminais de pacotes em quantas cidades estão disponíveis e de qual fonte: a lista online, uma cópia salva da lista online (com a data) ou a sua própria lista.

Geral

Enable/Disable: ativa ou desativa a LP Express em todas as zonas ao mesmo tempo.

Method title: o nome do método de envio exibido aos clientes. O título de um método de zona o substitui. Padrão: LP Express parcel terminal.

Tax status: Taxable adiciona o imposto do WooCommerce ao custo do envio; None não adiciona.

Preços (na moeda da sua loja; decimais podem ser escritos como 2.99 ou 2,99)

Price table: uma linha por país de destino. Clique em + Add country para adicionar uma linha e no x para remover uma. Escolha * Any other country para qualquer país sem linha própria. Cada linha tem um Base price e colunas de peso: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) e XL (>5 kg). O peso é o do carrinho, ou o de um item com Per item. Uma coluna vazia usa o preço base da linha. 0 significa grátis. Preços que não são números são informados após salvar e ficam vazios.

Fallback cost: usado quando a tabela de preços não tem linha para o país de destino. Deixe vazio para ocultar o método nesses países.

Calculation: como o preço é calculado.

Per order (tier by total cart weight): um preço para o carrinho, com a coluna de peso escolhida pelo peso total do carrinho. É o padrão.

Per item (each item priced by its own weight x quantity): cada item é precificado pelo próprio peso multiplicado pela quantidade, e os valores são somados.

Free shipping from: o valor do carrinho (após descontos, como exibido no carrinho) a partir do qual a LP Express é grátis. Deixe vazio para não ter frete grátis.

Disponibilidade

Minimum weight (kg): oculta o método quando o carrinho é mais leve. Vazio ou 0 significa sem limite.

Maximum weight (kg): oculta o método quando o carrinho é mais pesado. Os terminais LP Express aceitam pacotes de até 30 kg. Padrão: 30. 0 significa sem limite.

Minimum cart total: exibe o método somente a partir deste valor do carrinho. Deixe vazio para exibi-lo sempre.

Excluded shipping classes: oculta o método quando o carrinho contém produtos dessas classes de envio do WooCommerce.

Ignore shipping zones: oferece a LP Express para os países abaixo sem adicioná-la a uma zona. Quando está desativado, os países são definidos pelas zonas de envio onde o método foi adicionado. Isso é recomendado.

Countries (without zones): os países de destino para esse modo. Este campo só é usado quando Ignore shipping zones está ativado. Deixe vazio para oferecer o método para qualquer destino.

Terminais de pacotes

Terminal list: de onde vêm os terminais.

LP Express online list: a lista online é baixada uma vez por dia. Quando não puder ser carregada, usa-se a última cópia baixada e, depois, a sua própria lista abaixo. É o padrão.

Only my own list: somente os terminais que você inserir abaixo são oferecidos.

Salvar as configurações recarrega a lista de terminais.

Avançado

Debug log: registra o cálculo de preços e os detalhes da lista de terminais em WooCommerce > Status > Logs (origem vfd-lp-express). Erros, como uma lista de terminais indisponível, são sempre registrados. Nenhum dado de cliente é registrado.

Remove data on uninstall: quando ativo, excluir o plugin remove as configurações, os métodos de zona e os terminais em cache. Desativar o plugin nunca apaga as configurações. O terminal salvo nos pedidos é 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 o peso do carrinho, o valor mínimo do carrinho e as classes de envio excluídas. Se nenhum terminal de pacotes estiver disponível, o método fica oculto, para que o cliente nunca veja uma finalização de compra que não possa ser concluída. Se o frete grátis se aplicar, o preço é 0. Caso contrário, o preço vem da linha do país (ou da linha *): a coluna de peso, senão o preço base, senão o custo alternativo. Se não houver preço, o método fica oculto.

A lista online de terminais fica em cache por 24 horas. Um download com falha fica registrado por 15 minutos, para que a finalização de compra não espere pela lista a cada atualização. O tempo limite do download é de 10 segundos. Somente terminais ativos da lista são oferecidos.

O método funciona na finalização de compra clássica e nos blocos Carrinho e Finalização de compra. É compatível com o WooCommerce High-Performance Order Storage (HPOS). Os preços estão na moeda da sua loja. O plugin não converte moedas.

O plugin não solicita preços da LP Express ou da Unisend, não cria envios, não imprime etiquetas, não chama um courier e não rastreia pacotes. Crie os pacotes na sua conta Unisend ("Mano siuntos"). A entrega porta a porta por courier não faz parte deste método.

Pontos de retirada

Quando o cliente seleciona a LP Express, duas listas aparecem abaixo do método: -- Select city -- e -- Select parcel terminal --. A cidade do endereço de entrega é pré-selecionada quando corresponde a uma cidade da lista. Cada terminal é exibido com nome, endereço e CEP. A escolha fica salva durante a finalização de compra, então não se perde quando a finalização é atualizada.

Um terminal é obrigatório. Na finalização de compra clássica, o cliente vê Please select an LP Express parcel terminal. Na finalização de compra em blocos, Place order fica bloqueado até que um terminal seja escolhido. Nos dois tipos de finalização de compra, o servidor verifica o terminal na lista novamente, então um ID de terminal falsificado ou desatualizado é recusado.

O ID, o nome e a cidade do terminal são salvos no pedido. Eles aparecem na tela do pedido abaixo do endereço de entrega (com o ID do terminal), na página de pedido recebido, em My account > Orders e nos e-mails do pedido (HTML e texto simples) como LP Express parcel terminal.

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 LP Express. 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 inserir outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre sua conta em 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 em vibefox.net.

Sem uma chave ativa, a LP Express 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 LP Express 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). Abra a página de configurações: um aviso vermelho explica se nenhum preço está definido ou se nenhum terminal de pacotes está disponível. Verifique também os limites de peso, o Minimum cart total e as Excluded shipping classes. Com o Debug log ativado, WooCommerce > Status > Logs (origem vfd-lp-express) mostra por que o método foi ocultado.

Nenhum terminal de pacotes: a lista online não pôde ser carregada, e não há cópia salva nem lista própria. O plugin tenta novamente a cada 15 minutos. Insira sua própria lista em Own terminal list, ou escolha Only my own list.

A lista de terminais está desatualizada: salve a página de configurações. Isso recarrega a lista de terminais. Com a sua própria lista, atualize as linhas manualmente.

O cliente não consegue finalizar o pedido: é preciso escolher um terminal de pacotes. Se o cliente vir "The LP Express parcel terminal list is temporarily unavailable", no momento não há terminais disponíveis. Adicione sua própria lista.

Em qual moeda estão os preços: na moeda da sua loja. O plugin não converte moedas.

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 em 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. Apenas a lista de terminais em cache é limpa. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença e o status de licença deste plugin, além dos caches, são sempre removidos. Configurações, métodos de zona e a cópia salva da lista de terminais são removidos somente se Remove data on uninstall estiver ativado. Caso contrário, permanecem para uma reinstalação futura. O terminal salvo nos pedidos nunca é excluído, e os pedidos existentes mantêm suas linhas de envio.

A LP Express é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela LP Express.