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 do seu sistema POS. Você pode acessar o editor de modelos navegando até: 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 excluídos, 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 de administração do WordPress
  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 os modelos de recibo de três fontes:

Fontes de Modelos​

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

Ações do Modelo​

Para cada modelo padrão, você pode:

  • Visualizar: Ver como o modelo aparece com dados de amostra
  • 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 um 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 seu modelo personalizado
  4. Clique em Copiar Modelo
  5. Edite o novo modelo personalizado criado

Método 2: Criar do Zero​

  1. Clique em Adicionar Novo Modelo na parte superior 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​

  • Idioma: Defina como PHP para realce de sintaxe adequado
  • Tipo de Modelo: Escolha entre modelos de Recibo ou Relatório
  • Status: Gerenciamento de status de Publicado/Rascunho
  • Visibilidade: Controle a visibilidade do modelo

Ações do Modelo​

  • Visualizar: Veja como seu modelo é renderizado com dados de amostra
  • Definir como Ativo: Faça deste modelo o padrão para seu POS
  • Atualizar: Salve suas alterações
  • Mover para a Lixeira: Exclua modelos personalizados

Estrutura do Modelo​

Os modelos de recibo 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' ) - Tagline da loja
  • get_bloginfo( 'url' ) - URL da loja

Dados do Pedido​

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

Funções do WCPOS​

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

Melhores 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 ativá-lo
  3. Mantenha Backups: Exporte seus modelos personalizados ou mantenha cópias do seu código
  4. Compatível com Dispositivos 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 a Saída: Use funções de escape do WordPress para segurança
  3. Tratamento de Erros: Inclua verificação de erros adequada em seu código PHP
  4. Comentários: Documente suas personalizações para referência futura

Desempenho​

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

Solução de Problemas​

Problemas Comuns​

Modelo não mostrando alterações
  • Certifique-se de que você clicou em "Atualizar" para salvar suas alterações
  • Verifique se o modelo está definido como "Ativo"
  • Limpe qualquer plugin de cache
Erros de sintaxe
  • Use o realce de sintaxe para identificar problemas
  • Verifique se faltam ponto e vírgula, colchetes ou aspas
  • Valide sua sintaxe PHP
Problemas de estilização
  • 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á como "Publicado"
  • Certifique-se de que você tenha permissões adequadas

Obtendo Ajuda​

Se você encontrar problemas com a personalização de modelos:

  1. Verifique a visualização do modelo para mensagens de erro
  2. Revise o log de depuração do WordPress para erros PHP
  3. Teste com uma cópia do modelo padrão primeiro
  4. Assistência de IA: Ferramentas modernas de IA como Gemini, ChatGPT e Claude são excelentes para ajudar com modelos simples do WordPress como este. Você pode colar seu código de modelo e descrever o que deseja realizar.
  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 com o Tema​

Você pode substituir o modelo padrão colocando um arquivo receipt.php personalizado em 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.