Pular para o conteúdo principal
Versão: 1.x

Modelos de Recibo

O editor de modelos de recibo permite que você personalize a aparência e o conteúdo dos recibos impressos a partir do seu sistema POS. Você pode acessar o editor de modelos navegando para: WP Admin > POS > Modelos

Visão Geral​

O sistema de modelos fornece dois tipos de modelos:

  • Modelos Padrão: Detectados automaticamente a partir dos arquivos do seu plugin e tema. Estes não podem ser deletados, mas podem ser copiados para criar versões personalizadas.
  • Modelos Personalizados: Modelos criados pelo usuário que você pode personalizar, editar e gerenciar totalmente.

Acessando o Editor de Modelos​

  1. Navegue até o painel do seu WordPress Admin
  2. Vá para POS > Modelos
  3. Você verá uma lista de modelos disponíveis organizados em duas seções:
    • Modelos Padrão (dos arquivos do plugin/tema)
    • Modelos Personalizados (suas criações personalizadas)

Modelos Padrão​

O sistema detecta automaticamente modelos de recibo de três fontes:

Fontes de Modelo​

FonteDescriçãoStatus
PluginModelo de recibo padrão incluído com o WooCommerce POSSempre disponível
Plugin ProModelo aprimorado do WooCommerce POS ProDisponível com licença ativa
TemaModelo personalizado do seu tema ativoDisponível se o tema incluir modelo

Ações do Modelo​

Para cada modelo padrão, você pode:

  • Visualizar: Ver como o modelo fica com dados de exemplo
  • Copiar: Criar uma cópia personalizada que você pode editar
  • Ativar: Definir como o modelo ativo para seu POS

Criando Modelos Personalizados​

Método 1: Copiar de Modelo Padrão​

  1. Na seção Modelos Padrão, encontre o modelo que você deseja personalizar
  2. Clique no botão Copiar
  3. Digite um nome para o seu modelo personalizado
  4. Clique em Copiar Modelo
  5. Edite o modelo personalizado recém-criado

Método 2: Criar do Zero​

  1. Clique em Adicionar Novo Modelo no topo da página
  2. Digite um nome para o modelo
  3. Selecione Recibo como o tipo de modelo
  4. Comece a codificar seu modelo no editor

Recursos do Editor de Modelos​

O editor de modelos fornece:

Editor de Código​

  • Realce de Sintaxe: Realce de sintaxe PHP para melhor legibilidade do código
  • Números de Linha: Navegação e depuração fáceis
  • Edição em Tela Cheia: Ambiente de edição sem distrações

Painel de Configurações do Modelo​

  • Linguagem: Definir como PHP para realce de sintaxe adequado
  • Tipo de Modelo: Escolher entre modelos de Recibo ou Relatório
  • Status: Gerenciamento de status Publicado/Borrão
  • Visibilidade: Controle de visibilidade do modelo

Ações do Modelo​

  • Visualizar: Veja como seu modelo é renderizado com dados de exemplo
  • Definir como Ativo: Tornar este modelo o padrão para seu POS
  • Atualizar: Salvar suas alterações
  • Mover para a Lixeira: Deletar modelos personalizados

Estrutura do Modelo​

Modelos de recibos são arquivos PHP que geram saída HTML. Aqui está a estrutura básica:

<?php
/**
 * Custom Receipt Template
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo( 'charset' ); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        /* Your custom CSS styles */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Add more styles as needed */
    </style>
</head>
<body>
    <!-- Your receipt content -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Order details, items, totals, etc. -->

</body>
</html>

Variáveis de Modelo Disponíveis​

Ao criar modelos personalizados, você tem acesso a várias funções e dados do WordPress e WooCommerce:

Informações da Loja​

  • get_bloginfo( 'name' ) - Nome da loja
  • get_bloginfo( 'description' ) - Slogan da loja
  • get_bloginfo( 'url' ) - URL da loja

Dados do Pedido​

Os dados do pedido atual estão disponíveis através das funções padrão de pedidos do WooCommerce quando o modelo é renderizado.

Funções WCPOS​

Você pode usar funções específicas do WCPOS (prefixadas com wcpos_) para acessar dados e funcionalidades relacionados ao POS.

Melhor Práticas​

Desenvolvimento de Modelos​

  1. Comece Com uma Cópia: Sempre comece copiando um modelo padrão em vez de criar do zero
  2. Teste Minuciosamente: Use a função de visualização para testar seu modelo antes de ativar
  3. Mantenha Backups: Exporte seus modelos personalizados ou mantenha cópias do seu código
  4. Amigável para Móveis: Certifique-se de que seus modelos funcionem bem em diferentes tamanhos de tela

Qualidade do Código​

  1. Valide HTML: Certifique-se de que seu HTML esteja bem formado
  2. Escape Saída: Use funções de escapamento do WordPress para segurança
  3. Tratamento de Erros: Inclua verificações de erro adequadas em seu código PHP
  4. Comentários: Documente suas personalizações para referência futura

Desempenho​

  1. Otimize CSS: Mantenha os estilos mínimos e eficientes
  2. Minimize PHP: Evite lógica complexa em modelos
  3. Teste de Impressão: Verifique se os modelos funcionam bem com suas impressoras de recibos

Solução de Problemas​

Problemas Comuns​

Modelo Não Mostra Alterações

  • Certifique-se de que você clicou em "Atualizar" para salvar suas alterações
  • Verifique se o modelo está definido como "Ativo"
  • Limpe quaisquer plugins de cache

Erros de Sintaxe

  • Use o realce de sintaxe para identificar problemas
  • Verifique se há ponto e vírgula, colchetes ou aspas ausentes
  • Valide sua sintaxe PHP

Problemas de Estilo

  • Teste seu CSS no modo de visualização
  • Certifique-se de que os estilos sejam compatíveis com impressoras de recibo
  • Mantenha princípios de design amigáveis para impressão em mente

Modelo Não Disponível

  • Verifique se o tipo de modelo está definido como "Recibo"
  • Verifique se o status do modelo está "Publicado"
  • Certifique-se de ter as permissões adequadas

Obter Ajuda​

Se você encontrar problemas com a personalização do modelo:

  1. Verifique a visualização do modelo para mensagens de erro
  2. Revise o log de depuração do WordPress para erros de PHP
  3. Teste com uma cópia do modelo padrão primeiro
  4. Assistência de IA: Ferramentas de IA modernas como Gemini, ChatGPT e Claude são excelentes para ajudar com modelos simples do WordPress como estes. Você pode colar seu código de modelo e descrever o que deseja alcançar.
  5. Consulte a documentação do WooCommerce POS para personalização avançada

Personalização Avançada​

Para usuários avançados que precisam de mais controle sobre os modelos de recibo:

Integração de Tema​

Você pode substituir o modelo padrão colocando um arquivo receipt.php personalizado no seu tema:

your-theme/woocommerce-pos/receipt.php

Hooks e Filtros​

O WooCommerce POS fornece vários hooks e filtros para personalização de modelos. Consulte a documentação do desenvolvedor para opções disponíveis.

Campos Personalizados​

Você pode incluir campos de pedido personalizados, atributos de produtos e outros metadados em seus modelos de recibo usando funções apropriadas do WordPress e WooCommerce.