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.
A instalação e o gerenciamento de extensões requerem o WCPOS Pro. 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
Gateways de Pagamento
Gateways de checkout personalizados projetados para uso presencial no POS.
Quer criar o seu próprio? Comece pelo Modelo de Gateway — ou consulte a visão geral de Gateways Personalizados para a lista completa.
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.
Cupons e Crédito de Loja
Estoque
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
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
- Abra
POS Settings > Extensões. - Encontre a extensão desejada e clique em Instalar.
- A extensão é baixada e instalada usando o instalador de plugins do WordPress.
- 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
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
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
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
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 para gerenciar extensões.
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
- 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
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
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:
- 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.
- Integre com o WCPOS. Utilize os hooks e filtros fornecidos pelo WCPOS para adicionar funcionalidades à interface ou ao backend do POS.
- 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
O catálogo de extensões é mantido no repositório GitHub wcpos/extensions. Para listar sua extensão:
- Consulte o formato do catálogo e os requisitos de metadados no README do repositório.
- Abra um pull request para adicionar os metadados da sua extensão ao
catalog.json. - Após a aprovação, sua extensão aparecerá no diretório para todos os usuários WCPOS Pro.
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.