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 de PDV. Você pode acessar o editor de modelos navegando até: WP Admin > PDV > 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. Esses 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 completamente.

Acessando o Editor de Modelos​

  1. Navegue até o painel do seu WordPress Admin
  2. Vá para PDV > 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 recibos a partir de três fontes:

Fontes de Modelo​

FonteDescriçãoStatus
PluginModelo de recibo padrão incluído com WCPOSSempre disponível
Plugin ProModelo aprimorado do WCPOS 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 o seu PDV

Criando Modelos Personalizados​

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

  1. Na seção Modelos Padrão, encontre o modelo que deseja personalizar
  2. Clique no botão Copiar
  3. Digite um nome para 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 livre de distrações

Painel de Configurações do Modelo​

  • Idioma: Definido como PHP para realce de sintaxe adequado
  • Tipo de Modelo: Escolha entre Modelos de Recibo ou Relatório
  • Status: Gerenciamento do status Publicado/Junção
  • Visibilidade: Controle sobre a 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 PDV
  • Atualizar: Salvar suas alterações
  • Mover para Lixeira: Excluir 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' ) - 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 do pedido 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 relacionadas ao PDV.

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 pré-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. Compatível com Dispositivos Móveis: Garanta que seus modelos funcionem bem em diferentes tamanhos de tela

Qualidade do Código​

  1. Valide o 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ções de erro adequadas no 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ógicas complexas em modelos
  3. Teste a Impressão: Verifique se os modelos funcionam bem com suas impressoras de recibo

Resolução de Problemas​

Problemas Comuns​

Modelo não está 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 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 faltando
  • Valide sua sintaxe PHP
Problemas de estilo
  • Teste seu CSS no modo de pré-visualização
  • Certifique-se de que os estilos sejam compatíveis com impressoras de recibo
  • Mantenha os princípios de design amigáveis à 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 é "Publicado"
  • Certifique-se de que você possui permissões adequadas

Obtendo Ajuda​

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

  1. Verifique a pré-visualização do modelo para mensagens de erro
  2. Revise o log de depuração do WordPress para erros PHP
  3. Teste primeiro com uma cópia do modelo padrão
  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 esses. Você pode colar seu código de modelo e descrever o que deseja alcançar.
  5. Consulte a documentação do WCPOS 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 em seu tema:

your-theme/woocommerce-pos/receipt.php

Hooks e Filtros​

O WCPOS 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.