# Traduzido: WCPOS Polylang

Adiciona compatibilidade com o [Polylang](https://polylang.pro/) ao WCPOS para que o POS exiba apenas produtos de um único idioma — sem traduções duplicadas na busca de produtos, na grade do catálogo ou nos fluxos de caixa. Lojas WCPOS Pro podem fixar um idioma por loja; instalações gratuitas utilizam o idioma padrão do Polylang.

## O que faz[​](#what-it-does "Link direto para O que faz")

* Filtra consultas REST de produtos e variações do WCPOS por idioma.
* Intercepta as rotas de **sincronização rápida** do WCPOS (as requisições leves com `posts_per_page=-1` + `fields` que o POS usa para atualizar seu índice local) para que duplicatas traduzidas nunca cheguem ao cliente.
* Em instalações gratuitas, aplica o idioma padrão do Polylang.
* Em instalações Pro, cada loja pode escolher seu próprio idioma em uma nova seção **Idioma** no editor de lojas.
* Respeita a visibilidade de produto **Somente POS** do WCPOS ao construir o payload de sincronização rápida.

A integração é desativada automaticamente quando o Polylang não está ativo — é possível instalar o plugin antes de ativar o Polylang sem gerar erros.

## Instalação[​](#installation "Link direto para Instalação")

1

#### PT-BR: Instalar o Polylang

Instale o [Polylang](https://wordpress.org/plugins/polylang/) (ou Polylang Pro) e configure os idiomas do seu site normalmente. Certifique-se de que pelo menos um idioma esteja definido como padrão.

2

#### PT-BR: Instalar o WCPOS Polylang

Instale a partir do diretório de extensões do WCPOS em `WP Admin > POS > Configurações > Extensões`, ou baixe a versão mais recente na [página de releases do GitHub](https://github.com/wcpos/wcpos-polylang/releases) e envie via `Plugins > Adicionar novo > Enviar plugin`.

3

#### PT-BR: (Pro) Definir um idioma por loja

Se você utiliza [múltiplas lojas](/pt-BR/stores/.md) no WCPOS Pro, acesse `POS > Lojas`, edite uma loja e selecione o idioma na seção **Idioma** da barra lateral. Deixe como *Padrão* para utilizar o idioma padrão do Polylang.

## Idioma por Loja (Pro)[​](#per-store-language-pro "Link direto para Idioma por Loja (Pro)")

No WCPOS Pro, o plugin adiciona uma seção **Idioma** à barra lateral do editor de lojas. Cada loja pode ser vinculada a um único slug de idioma do Polylang — os produtos exibidos nessa loja são filtrados apenas para esse idioma. Lojas deixadas como *Padrão* utilizam o idioma padrão do Polylang.

O valor por loja é salvo no post da loja como meta `_wcpos_polylang_language` e é exposto pela API REST de lojas do WCPOS Pro (`/wcpos/v1/stores`), de modo que ele trafega pelo POS como qualquer outra configuração de loja.

## Notas de Compatibilidade[​](#compatibility-notes "Link direto para Notas de Compatibilidade")

* **Produtos exclusivos do POS:** quando o modo exclusivo do POS está ativado nas configurações do WCPOS, os IDs de produtos exclusivos da loja online são excluídos do payload de sincronização rápida para que não apareçam no POS.
* **Instalações gratuitas:** não há interface para alterar o idioma por loja — o plugin utiliza o idioma padrão do Polylang. Se você precisar de idiomas por loja, faça upgrade para o [WCPOS Pro](/pt-BR/getting-started/pro-license.md).
* **Plugin indisponível:** se o Polylang estiver desativado, o plugin não faz nada silenciosamente. Ele não gerará erros nem bloqueará o POS.

## Hooks para Desenvolvedores[​](#developer-hooks "Link direto para Hooks para Desenvolvedores")

Para uso avançado, o plugin expõe alguns filtros:

| Filtro                             | Finalidade                                                                                                     |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `wcpos_polylang_resolved_language` | Sobrescreve o idioma utilizado para uma determinada requisição. Recebe o slug resolvido e o `WP_REST_Request`. |
| `wcpos_polylang_default_language`  | Sobrescreve o idioma de fallback quando nenhum valor por loja está definido.                                   |
| `wcpos_polylang_is_supported`      | Força a ativação ou desativação do plugin independentemente da detecção do Polylang.                           |
| `wcpos_polylang_minimum_version`   | Exige uma versão mínima do Polylang (padrão: sem restrição de versão).                                         |

## Requisitos[​](#requirements "Link direto para Requisitos")

PT-BR: WooCommerce

<!-- -->

: WooCommerce instalado e ativado

PT-BR: Polylang

<!-- -->

: Polylang (gratuito ou Pro) com pelo menos um idioma configurado

PT-BR: WCPOS

<!-- -->

: A versão gratuita funciona; a seleção de idioma por loja requer o WCPOS Pro

## Relacionados[​](#related "Link direto para Relacionados")

* [WCPOS WPML](/pt-BR/extensions/wpml.md)
* [WCPOS WP Multilang](/pt-BR/extensions/wp-multilang.md)
* [Multiloja](/pt-BR/stores/.md)
* Código-fonte: [github.com/wcpos/wcpos-polylang](https://github.com/wcpos/wcpos-polylang)