# Extensões

O WCPOS oferece suporte a extensões que adicionam novas funcionalidades ao seu ponto de venda. O diretório de extensões permite navegar pelas extensões disponíveis, instalá-las diretamente nas configurações do POS e gerenciar atualizações.

Recurso Pro

A instalação e o gerenciamento de extensões requerem o [WCPOS Pro](/pt-BR/getting-started/pro-license.md). A versão gratuita exibe o catálogo de extensões, mas desabilita os controles de instalação e ativação.

## Extensões Disponíveis[​](#available-extensions "Link direto para Extensões Disponíveis")

### Gateways de Pagamento[​](#payment-gateways "Link direto para Gateways de Pagamento")

Gateways de checkout personalizados projetados para uso presencial no POS.

[PT-BR: Stripe TerminalPT-BR: Pagamentos presenciais com cartão em hardware Stripe Terminal (S700, WisePOS E). Compatível com MOTO e modo simulador.](/pt-BR/payment/gateways/stripe-terminal.md)

[PT-BR: SumUp TerminalPT-BR: Aceite pagamentos com cartão por meio de leitores de cartão SumUp.](/pt-BR/payment/gateways/sumup-terminal.md)

[PT-BR: Vipps MobilePayPT-BR: Pagamentos por celular via QR code ou notificação push. Vipps (Noruega), MobilePay (Dinamarca, Finlândia).](/pt-BR/payment/gateways/vipps-mobilepay.md)

[PT-BR: Fatura por E-mailPT-BR: Envie ao cliente um link de pagamento por e-mail para finalizar o pedido online.](/pt-BR/payment/gateways/email-invoice.md)

Quer criar o seu próprio? Comece pelo [Modelo de Gateway](/pt-BR/reference/gateway-template.md) — ou consulte a [visão geral de Gateways Personalizados](/pt-BR/payment/gateways/.md) para a lista completa.

### Multilíngue[​](#multilingual "Link direto para Multilíngue")

Filtre produtos do POS por idioma para que duplicatas traduzidas não apareçam na busca do caixa e na grade de catálogo.

[PT-BR: WCPOS PolylangPT-BR: Integração com Polylang — sincronização de produtos por idioma e seleção de idioma por loja para o WCPOS Pro.](/pt-BR/extensions/polylang.md)

[PT-BR: WCPOS WPMLPT-BR: Integração com WPML — filtre os produtos do POS para um único idioma.](/pt-BR/extensions/wpml.md)

[PT-BR: WCPOS WP MultilangPT-BR: Integração com WP Multilang — filtre os produtos do POS para um único idioma.](/pt-BR/extensions/wp-multilang.md)

### Cupons e Crédito de Loja[​](#coupons-and-store-credit "Link direto para Cupons e Crédito de Loja")

[PT-BR: WCPOS StoreApps Smart CouponsPT-BR: Resgate créditos de loja do StoreApps Smart Coupons no WCPOS, com rótulos de saldo no recibo e histórico de auditoria nas notas do pedido.](/pt-BR/extensions/storeapps-smart-coupons.md)

### Estoque[​](#inventory "Link direto para Estoque")

[PT-BR: Integração WCPOS com ATUMPT-BR: Vincule as lojas do WCPOS Pro aos locais do ATUM Multi-Inventory para estoque, preços e SKUs por localização.](/pt-BR/extensions/atum.md)

## Explorar Extensões[​](#browsing-extensions "Link direto para Explorar Extensões")

Abra o diretório de extensões em `POS Settings > Extensões` (também chamado de **Plugins** em algumas versões).

O diretório exibe uma grade de cartões com as extensões disponíveis. Cada cartão mostra:

* **Ícone** (ou um ícone de peça de quebra-cabeça como substituto, caso a extensão não forneça um)
* **Nome e versão**
* **Descrição**
* **Selo de categoria**
* **Status** — ativo, inativo, atualização disponível ou não instalado

### Filtros e Pesquisa[​](#filtering-and-search "Link direto para Filtros e Pesquisa")

Use os **botões de categoria** no topo para filtrar extensões por categoria. Você também pode usar o **campo de pesquisa** para encontrar extensões por nome, descrição ou tags.

## Instalando uma Extensão[​](#installing-an-extension "Link direto para Instalando uma Extensão")

1. Abra `POS Settings > Extensões`.
2. Encontre a extensão desejada e clique em **Instalar**.
3. A extensão é baixada e instalada usando o instalador de plugins do WordPress.
4. Após a instalação, clique em **Ativar** para habilitá-la.

Internamente, o WCPOS utiliza o `Plugin_Upgrader` nativo do WordPress para gerenciar a instalação, portanto as extensões seguem o mesmo processo de qualquer plugin do WordPress.

## Ativando e Desativando[​](#activating-and-deactivating "Link direto para Ativando e Desativando")

Cada extensão instalada possui os botões **Ativar** e **Desativar** em seu cartão.

* **Ativar** habilita a extensão para que ela funcione no POS.
* **Desativar** desabilita a extensão sem desinstalá-la. Os arquivos da extensão permanecem no servidor e podem ser reativados a qualquer momento.

## Atualizando Extensões[​](#updating-extensions "Link direto para Atualizando Extensões")

Quando uma versão mais recente de uma extensão instalada está disponível, o cartão exibe um selo **Atualização Disponível** e um botão **Atualizar**.

### Atualizações Automáticas[​](#auto-updates "Link direto para Atualizações Automáticas")

As extensões instaladas a partir do diretório têm a **atualização automática habilitada por padrão**. É possível ativar ou desativar as atualizações automáticas por extensão a partir de seu cartão no diretório. Quando a atualização automática está ativada, o WordPress aplica as novas versões automaticamente, da mesma forma que faz com plugins que possuem a atualização automática habilitada.

## Solução de Problemas[​](#troubleshooting "Link direto para Solução de Problemas")

### Mensagem "Requer Pro" nos Botões[​](#requires-pro-message-on-buttons "Link direto para Mensagem \"Requer Pro\" nos Botões")

Os botões de instalação, ativação e atualização estão desabilitados na versão gratuita do WCPOS. Faça o upgrade para o [WCPOS Pro](/pt-BR/getting-started/pro-license.md) para gerenciar extensões.

### Falha na Instalação da Extensão[​](#extension-fails-to-install "Link direto para Falha na Instalação da Extensão")

* Verifique se o servidor WordPress possui permissões de escrita no diretório `wp-content/plugins`.
* Verifique se o servidor consegue realizar requisições HTTPS de saída (alguns provedores de hospedagem bloqueiam downloads externos).
* Consulte os detalhes do erro em `WP Admin > POS > Suporte > Logs`.

### Extensão Não Aparece Após a Instalação[​](#extension-not-appearing-after-install "Link direto para Extensão Não Aparece Após a Instalação")

* Atualize o POS — a lista de extensões fica em cache por até 12 horas.
* Confirme se a extensão está ativada (extensões instaladas mas inativas não serão executadas).

### Catálogo Não Carrega[​](#catalog-not-loading "Link direto para Catálogo Não Carrega")

O catálogo de extensões é obtido de uma fonte remota e armazenado em cache localmente por 12 horas. Se o catálogo não carregar:

* Verifique a conectividade com a internet do servidor.
* Tente novamente após o cache expirar, ou limpe o cache de transientes do servidor.

***

## Para Desenvolvedores[​](#for-developers "Link direto para Para Desenvolvedores")

### Criando uma Extensão para o POS[​](#creating-a-pos-extension "Link direto para Criando uma Extensão para o POS")

Uma extensão WCPOS é um plugin WordPress padrão que se integra ao POS por meio de hooks e APIs do WCPOS. Para criar uma:

1. **Comece com um plugin WordPress.** Sua extensão precisa de um cabeçalho de plugin padrão e um arquivo de entrada, assim como qualquer plugin WooCommerce ou WordPress.
2. **Integre com o WCPOS.** Utilize os hooks e filtros fornecidos pelo WCPOS para adicionar funcionalidades à interface ou ao backend do POS.
3. **Hospede os lançamentos no GitHub.** O diretório de extensões utiliza GitHub Releases para rastrear versões e disponibilizar atualizações.

### Enviando para o Diretório[​](#submitting-to-the-directory "Link direto para Enviando para o Diretório")

O catálogo de extensões é mantido no repositório GitHub [`wcpos/extensions`](https://github.com/wcpos/extensions). Para listar sua extensão:

1. Consulte o formato do catálogo e os requisitos de metadados no README do repositório.
2. Abra um pull request para adicionar os metadados da sua extensão ao `catalog.json`.
3. Após a aprovação, sua extensão aparecerá no diretório para todos os usuários WCPOS Pro.

### Convenções de GitHub Release[​](#github-release-conventions "Link direto para Convenções de GitHub Release")

O ciclo de atualização depende das GitHub Releases:

* **Versione as tags** usando versionamento semântico (ex.: `v1.0.0`, `v1.2.3`).
* **Anexe o zip do plugin** como asset da release — este é o arquivo que será baixado quando um usuário instalar ou atualizar.
* **Publique a release** (não como rascunho) para que o diretório possa detectá-la.

Quando você publicar uma nova release, os usuários que tiverem sua extensão instalada verão a atualização disponível no diretório de extensões. Se a atualização automática estiver habilitada, ela será aplicada automaticamente.

Para detalhes completos sobre o esquema do catálogo e o processo de submissão, consulte o repositório [`wcpos/extensions`](https://github.com/wcpos/extensions).