Nesta página
Plug-ins necessários e configuração
Adição de um alternador de moeda
Configuração de gateways de pagamento
Definição de taxas de câmbio automáticas
Opções de formatação de moeda e regras de arredondamento
Configuração de preços personalizados para diferentes moedas
Definição de taxas de envio diferentes para cada moeda
Filtragem de pedidos e análises WooCommerce por moeda
Informações para desenvolvedores – Configurando sua própria lógica de várias moedas
Plug-ins necessários e configuração
Versão autônoma gratuita do WooCommerce Multilingual
Se você estiver interessado em usar a versão gratuita e independente do WooCommerce Multilingual, instale e ative:
- WooCommerce
- WooCommerce Multilingual
Configuração da versão autônoma
Depois que você tiver instalado e ativado os plug-ins, vá para WooCommerce → WooCommerce Multilingual & Multicurrency para ativar o modo de várias moedas.
WooCommerce Multilingual com WPML
Para criar uma loja multilíngue e em várias moedas com o WooCommerce Multilingual e WPML, consulte nossa página de documentação sobre o WooCommerce Multilingual.
Configuração de moedas
Há duas maneiras de você configurar as moedas: com base no idioma ou com base na localização do cliente.
Moedas por idioma
Essa opção requer um WPML Multilingual CMS ou conta de agência .
Você pode optar por mostrar moedas específicas com base no idioma que o cliente selecionou. Isso ajuda em situações em que os produtos em determinados idiomas precisam ser pedidos apenas em uma moeda específica.
Você também pode configurar a moeda padrão para cada idioma. Dessa forma, os usuários veem os preços dos produtos em uma determinada moeda quando mudam para um idioma diferente no front-end.
Para definir as moedas a serem usadas em cada idioma, acesse WooCommerce → WooCommerce Multilingual & Multicurrency e clique na guia Multicurrency.
Se você escolher a opção Manter para a moeda padrão em um determinado idioma, a moeda da loja não será alterada quando você mudar para esse idioma.
Quando uma nova moeda é adicionada, ela é incluída por padrão em todos os idiomas. Você pode ajustar isso usando as caixas de seleção apropriadas.
Moedas por local
Essa opção pode ser usada com ou sem WPML.
Se você tiver clientes em países que falam o mesmo idioma, mas usam moedas diferentes, talvez queira configurar suas moedas com base no endereço IP ou no endereço de cobrança dos clientes.
Isso é útil se você quiser:
- Aplicar determinadas moedas aos usuários com base em sua localização ou endereço de cobrança.
- Implemente uma política de preços com base na localização.
Por exemplo, você pode decidir definir um preço mais alto para alguém nos EUA (pagando em dólares americanos) do que para clientes no Reino Unido (pagando em libras esterlinas). Você pode configurá-lo para que os clientes não vejam os preços na moeda do outro país, mesmo que ambos os clientes falem inglês.
Para configurar moedas por local, vá para WooCommerce → WooCommerce Multilingual & Multicurrency e clique na guia Multicurrency.
WooCommerce usa o MaxMind Geolocation para determinar a localização de um cliente por meio do endereço IP. Para obter melhores resultados, crie uma conta gratuita do MaxMind e gere uma nova chave de licença para determinar a localização de um cliente.
Depois de inserir a chave nas configurações do Multicurrency, você estará pronto para personalizar suas moedas por país.
Clique em Adicionar moeda para adicionar outra moeda ao seu site. Você pode escolher para quais países deseja que essa moeda esteja disponível. Ou você pode excluir países específicos.
Depois que você ativar as moedas com base na localização do cliente, os clientes conectados verão as moedas com base no endereço de cobrança. Para outros clientes, WooCommerce Multilingual usará o endereço IP deles para exibir a moeda correta.
Observação: a exibição de moedas com base no endereço IP pode não funcionar perfeitamente. Isso se deve ao fato de que:
- O banco de dados do MaxMind determina a geolocalização do cliente. Os clientes verão a moeda padrão da sua loja se o endereço IP deles não corresponder a uma moeda no banco de dados da MaxMind.
- As sessões Transients e WooCommerce salvam endereços IP para mostrar conteúdo específico aos clientes em determinados locais. Como resultado, os preços podem aparecer na mesma moeda para usuários de VPN em vários países.
- Se você optou por limitar os locais de venda da sua loja a países específicos, WooCommerce mostrará aos clientes desses países as moedas atribuídas. Todos os outros clientes verão a moeda padrão de sua loja.
Você pode substituir o país geolocalizado WooCommerce Multilingual usando o gancho de filtro wcml_geolocation_get_user_country.
Adição de um alternador de moeda ao front-end
Depois de adicionar o suporte a várias moedas, você deverá exibir um alternador de moedas no tema do seu site. Você pode exibir o seletor de moeda com um shortcode ou como um gancho.
Widget de troca de moeda
O seletor de moeda pode ser adicionado a um modelo como um widget clássico WordPress. Observe que o alternador de moeda ainda não está disponível como um widget baseado em blocos.
Para configurá-lo, vá para WooCommerce → WooCommerce Multilingual & Multicurrency → guia Multicurrency .
As opções do alternador de moeda permitem que você:
- Mostrar um alternador de moeda no modelo da página do produto
- Visualize a aparência do switcher no front-end antes de aplicar as alterações
- Definir o estilo do switcher
- Arraste e solte a ordem das moedas no alternador
- Ajuste a saída do switcher
Você pode personalizar o modelo usado para o seletor de moeda usando quatro parâmetros:
- %name% – nome completo da moeda, por exemplo, “Euro”
- %symbol% – o símbolo padrão que representa a moeda, por exemplo, “$” ou “€”.
- %code% – o código padrão que representa a moeda, por exemplo, USD para dólar dos Estados Unidos.
- %subtotal% – custos totais do pedido atual (cesta), sem custos de envio e impostos adicionais. O subtotal é o preço formatado e inclui o símbolo de moeda posicionado de acordo com as opções de moeda definidas nas configurações WooCommerce.
WooCommerce Multilingual & Multicurrency também permite que você use as seguintes tags HTML para personalizar a saída do alternador: img, span, em, strong e u. Observe que essas tags só podem ser usadas quando o estilo do alternador de moedas estiver definido como Lista de moedas. Isso decorre dos padrões oficiais de HTML para a tag select .
Código curto de troca de moeda
Se quiser adicionar o seletor de moeda a outros locais do seu site, você poderá fazê-lo usando um shortcode.
Código curto: [currency_switcher]
Atributos: format (Tags disponíveis: %name%, %code%, %symbol%) Padrão: %name% (%symbol%)
Exemplo de uso: [currency_switcher format="%code% (%symbol%)"]
A versão de código curto é a mais conveniente quando você exibe o seletor de moeda em linha com o conteúdo WordPress, por exemplo, em um modelo de conteúdo pelo Toolset Blocks do plugin Toolset Blocks. Você deve usar o bloco Fields and Text para incluir o shortcode no modelo.
Alternador de moedas como código PHP
Você também pode adicionar e personalizar os seletores de moeda usando código PHP.
do_action('wcml_currency_switcher', array('format' => '%name% (%symbol%)'));
Além do formato, você pode usar o seguinte parâmetro:
switcher_style: wcml-dropdown, wcml-dropdown-click, wcml-horizontal-list, wcml-vertical-list
Isso gera um menu suspenso básico com códigos de moeda para valores de opção. A moeda atual do cliente ou a moeda padrão configurada para um idioma específico será selecionada automaticamente.
Uso de comutadores personalizados
Além dessas opções padrão de switcher_style, você também pode usar opções personalizadas, definidas pelo seletor de moeda personalizado que você projetou usando arquivos de modelo. Nesse caso, você precisa usar o slug correto que identifica o seletor de moeda personalizado.
O slug do seu alternador personalizado é gerado dependendo do nome higienizado do seu modelo, conforme definido no arquivo config.json, e da localização do modelo:
| Localização do seletor de moeda personalizado | Como o slug é gerado |
| Pasta de temas | Slug do tema + nome do switcher higienizado |
| Pasta de plugins | Slug do plug-in + nome do switcher higienizado |
| “Pasta “uploads | “uploads-” + nome do switcher higienizado |
Vamos considerar o seguinte exemplo:
- O nome do seu seletor de moeda personalizado é Meu seletor personalizado.
- Você está usando o tema Twenty Seventeen e os arquivos de modelo para seus switchers estão localizados na pasta do tema.
O slug a ser usado com seu alternador personalizado é twenty-seventeen-my-custom-switcher, conforme mostrado no exemplo a seguir.
Using custom currency switcher in PHP templates
do_action('wcml_currency_switcher', array(
'format' => '%name% (%symbol%)',
'switcher_style' => 'twenty-seventeen-my-custom-switcher'
));
A versão do código PHP é melhor quando você adiciona manualmente o seletor de moeda aos modelos PHP.
Configurações de gateways de pagamento
Você pode configurar gateways de pagamento para sua loja acessando WooCommerce → Configurações → Pagamentos. Por padrão, todos os gateways de pagamento que você configurar estarão disponíveis para todas as moedas do seu site.
WooCommerce Multilingual é compatível com o WooCommerce PayPal Payments, Stripe e transferência bancária direta.
Configuração de gateways de pagamento para cada moeda
Esse recurso requer um WPML Multilingual CMS ou conta de agência .
Você pode optar por definir gateways de pagamento específicos para cada uma das moedas do seu site. Você pode achar isso útil se, por exemplo:
- Sua loja usa transferências bancárias diretas e você deseja usar contas bancárias locais para cada moeda.
- Sua loja usa o PayPal e você deseja configurar contas diferentes do PayPal para cada moeda.
Para fazer isso:
- Ir para WooCommerce → WooCommerce Multilingual & Multicurrency e clique na guia Multicurrency.
- Clique no ícone de lápis ao lado de uma das moedas do seu site.
- Ative os gateways de pagamento. É exibida uma lista de todos os gateways de pagamento que você configurou.
Definição da moeda em que você receberá pagamentos
Esse recurso requer um WPML Multilingual CMS ou conta de agência .
WooCommerce Multilingual permite que você escolha em qual moeda cobrar dos clientes e receber pagamentos para cada gateway de pagamento.
Por exemplo, você pode configurar sua loja para que:
- Seus clientes podem fazer compras em libras esterlinas (GBP) e optar por pagar com o Stripe
- Você receberá o pagamento do Stripe em euros (EUR)
Quando você optar por receber o pagamento em uma moeda diferente da que seu cliente está usando, ele verá o valor total na moeda convertida durante o checkout.
Para configurar isso:
- Edite uma das moedas do seu site.
- Use a lista suspensa Currency (Moeda ) para selecionar a moeda em que você deseja que seus clientes sejam cobrados.
No exemplo abaixo, você pode ver que, para clientes que compram em libras esterlinas (GBP), temos transferências bancárias diretas e o Stripe como gateways de pagamento. Mas, no caso do Stripe, optamos por cobrar e receber pagamentos em euros (EUR).
Se quiser que todos os pagamentos sejam feitos em uma moeda padrão, você precisará editar cada moeda em seu site. Em seguida, você precisa definir sua moeda padrão como a moeda de transação para cada gateway de pagamento.
Escolha de quais gateways de pagamento exibir com base na localização do cliente
Esse recurso requer um WPML Multilingual CMS ou conta de agência .
Alguns gateways de pagamento estão disponíveis apenas em países específicos. Se você tiver a geolocalização configurada para exibir moedas por local do cliente, poderá determinar quais gateways de pagamento serão exibidos.
Para ajustar em quais países um determinado gateway de pagamento aparece, vá para WooCommerce → Configurações e clique na guia Pagamentos. Clique no método de pagamento que deseja ajustar e você verá a opção de alterar a disponibilidade do país.
Uso de outros plug-ins de gateway de pagamento
Se você quiser usar um plug-in de gateway de pagamento diferente, consulte nossa lista de plug-ins recomendados para obter informações sobre compatibilidade e documentação disponível.
Definição de uma taxa de câmbio automática
Esse recurso pode ser usado com ou sem WPML.
WooCommerce Multilingual permite que você configure taxas de câmbio automáticas para sua loja acessando WooCommerce → WooCommerce Multilingual tilingual & Multicurrency e clicando na guia Multicurrency. Marque a caixa para ativar as taxas de câmbio automáticas.
Há três configurações para esse recurso:
- Fonte de taxas de câmbio – Selecione a fonte dos dados das taxas de câmbio. Você pode escolher entre quatro serviços renomados: Fixer.io, currencylayer, Exchange Rates API e Open Exchange Rates.
- Taxa de elevação – Você pode definir uma porcentagem adicional para ajustar a taxa de câmbio final e efetiva. Isso é útil para transações internacionais que podem adicionar cobranças adicionais.
É assim que a taxa efetiva é calculada, com base na taxa de elevação definida:Taxa efetiva = Taxa de serviço x (1 + taxa de elevação / 100)
- Frequência de atualização – Defina a frequência com que as taxas de câmbio automáticas verificam e atualizam as taxas de câmbio de sua loja. Você pode fazer isso de hora em hora, diariamente, semanalmente ou mensalmente. Por padrão, isso é definido como atualização manual. Observação: a atualização das taxas de câmbio por hora gera cerca de 744 chamadas de API por mês. Verifique se sua fonte de taxas de câmbio pode acomodar esse uso maior.
Opções de moeda e regras de arredondamento
A formatação da moeda varia em diferentes países e idiomas. Por exemplo, enquanto alguns países usam uma vírgula para separar milhares, outros usam um ponto decimal.
Quando você adiciona uma moeda secundária, WooCommerce Multilingual lida automaticamente com a formatação da moeda para você. Ele define detalhes específicos da localidade, como a posição da moeda, o separador decimal e o número de decimais. Se quiser alterar essas predefinições, você poderá editar cada moeda de forma independente e definir suas configurações.
Na mesma tela de edição de moeda, WooCommerce Multilingual permite que você defina preços específicos para cada moeda, garantindo que os preços tenham uma aparência “limpa”. Os preços que são determinados automaticamente podem ser arredondados para o número inteiro mais próximo.
Veja como funciona o arredondamento para o número inteiro mais próximo:
- Se o valor do incremento for definido como 1, um preço como 1454,07 será arredondado para 1454.
- Se o valor do incremento for definido como 10, o mesmo preço de 1454,07 será arredondado para 1450.
- Se o valor do incremento for definido como 100, então 1454,07 se tornará 1500.
Valor de subtração automática: permite que você subtraia um determinado valor do valor arredondado anteriormente.
Para 1454,07, quando o incremento para o número inteiro mais próximo é 100 e o valor de subtração automática é 1, o valor final é 1499.
Configurar preços personalizados para diferentes moedas
Esse recurso pode ser usado com ou sem WPML.
Configuração de preços de produtos por moeda
WooCommerce Multilingual permite que você defina preços personalizados em diferentes moedas.
Você pode definir preços personalizados em diferentes moedas na tela de edição do produto, nos campos de Preço normal e Preço de venda (para a moeda padrão).
Eles são fixos e substituem os preços determinados automaticamente pela taxa de câmbio. Para voltar a usar os preços automáticos, você precisa remover os preços personalizados e atualizar o produto.
Existe uma interface semelhante na tela de edição de produtos variáveis.
Definição de taxas de envio por moeda
Você também pode configurar taxas de envio distintas por moeda para os seguintes métodos de envio padrão WooCommerce:
- Taxa fixa – Defina a taxa fixa principal e a taxa para a classe de envio (se houver alguma definida)
- Frete grátis – Defina o valor mínimo
- Coleta local – Defina a taxa de manuseio
Para definir taxas de remessa personalizadas:
- Vá para WooCommerce → Configurações e clique na guia Frete.
- Configure suas zonas de envio e adicione os métodos de envio que você deseja usar.
- Clique em Edit (Editar ) sob o método de envio que você deseja personalizar, e uma caixa de diálogo pop-up será exibida.
- Use o campo Custo para definir o custo de envio em sua moeda padrão.
- No menu suspenso Habilitar custos em moedas personalizadas, selecione Definir custos de envio em outras moedas manualmente.
- Digite os preços personalizados para o restante das moedas nos campos que aparecem.
Visualização de pedidos e análises por moeda
Esse recurso pode ser usado com ou sem WPML.
Os pedidos têm uma moeda específica associada a eles. É a moeda que o usuário estava usando ao fazer o pedido. Você pode visualizar os totais de cada pedido na moeda correspondente na seção WooCommerce → Orders (Pedidos ). Nessa página, também é possível filtrar os pedidos por moeda.
Como todos os pedidos criados têm uma moeda associada, WooCommerce Analytics pode ser dividido por moeda.
Informações para desenvolvedores – Usando ganchos de baixo nível para configurar sua própria lógica de várias moedas
WooCommerce Multilingual define um conjunto de filtros e ganchos que podem ser usados por plug-ins de terceiros para implementar a lógica de várias moedas quando WooCommerce e o WooCommerce Multilingual estão configurados e funcionando. Com isso, os usuários podem ver os preços na moeda de sua preferência (os valores dos preços são determinados com base na taxa de câmbio da moeda). Os pedidos são feitos na moeda que o usuário seleciona no front-end.
