Salta al contenuto principale
Versione: 1.x

Modelli di Ricevuta

L'editor del Modello di Ricevuta ti consente di personalizzare l'aspetto e il contenuto delle ricevute stampate dal tuo sistema POS. Puoi accedere all'editor dei modelli navigando in: WP Admin > POS > Templates

Panoramica​

Il sistema di modelli fornisce due tipi di modelli:

  • Modelli Predefiniti: Rilevati automaticamente dai file del tuo plugin e del tuo tema. Questi non possono essere eliminati ma possono essere copiati per creare versioni personalizzate.
  • Modelli Personalizzati: Modelli creati dall'utente che puoi personalizzare, modificare e gestire completamente.

Accesso all'Editor dei Modelli​

  1. Naviga al tuo dashboard di WordPress Admin
  2. Vai a POS > Templates
  3. Vedrai un elenco di modelli disponibili organizzato in due sezioni:
    • Modelli Predefiniti (da file plugin/tema)
    • Modelli Personalizzati (le tue creazioni personalizzate)

Modelli Predefiniti​

Il sistema rileva automaticamente i modelli di ricevuta da tre fonti:

Fonti dei Modelli​

FonteDescrizioneStato
PluginModello di ricevuta principale incluso con WooCommerce POSSempre disponibile
Pro PluginModello migliorato da WooCommerce POS ProDisponibile con licenza attiva
TemaModello personalizzato dal tuo tema attivoDisponibile se il tema include il modello

Azioni sui Modelli​

Per ciascun modello predefinito, puoi:

  • Anteprima: Visualizza come appare il modello con dati di esempio
  • Copia: Crea una copia personalizzata che puoi modificare
  • Attiva: Imposta come modello attivo per il tuo POS

Creazione di Modelli Personalizzati​

Metodo 1: Copia da Modello Predefinito​

  1. Nella sezione Modelli Predefiniti, trova il modello che desideri personalizzare
  2. Clicca sul pulsante Copia
  3. Inserisci un nome per il tuo modello personalizzato
  4. Clicca su Copia Modello
  5. Modifica il nuovo modello personalizzato creato

Metodo 2: Crea da Zero​

  1. Clicca su Add New Template in cima alla pagina
  2. Inserisci un nome per il modello
  3. Seleziona Receipt come tipo di modello
  4. Inizia a programmare il tuo modello nell'editor

Caratteristiche dell'Editor del Modello​

L'editor del modello fornisce:

Editor di Codice​

  • Evidenziazione della Sintassi: Evidenziazione della sintassi PHP per una migliore leggibilità del codice
  • Numeri di Riga: Navigazione e debug facili
  • Editing a Schermo Intero: Ambiente di editing senza distrazioni

Pannello delle Impostazioni del Modello​

  • Lingua: Imposta su PHP per una corretta evidenziazione della sintassi
  • Tipo di Modello: Scegli tra modelli di Ricevuta o Rapporti
  • Stato: Gestione dello stato Pubblicato/Bozza
  • Visibilità: Controlla la visibilità del modello

Azioni sui Modelli​

  • Anteprima: Vedi come il tuo modello viene visualizzato con dati di esempio
  • Imposta come Attivo: Fai di questo modello il predefinito per il tuo POS
  • Aggiorna: Salva le tue modifiche
  • Sposta nel Cestino: Elimina modelli personalizzati

Struttura del Modello​

I modelli di ricevuta sono file PHP che generano output HTML. Ecco la struttura di base:

<?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>

Variabili di Modello Disponibili​

Quando crei modelli personalizzati, hai accesso a varie funzioni e dati di WordPress e WooCommerce:

Informazioni sul Negozio​

  • get_bloginfo( 'name' ) - Nome del negozio
  • get_bloginfo( 'description' ) - Slogan del negozio
  • get_bloginfo( 'url' ) - URL del negozio

Dati dell'Ordine​

I dati dell'ordine corrente sono disponibili tramite le funzioni standard dell'ordine di WooCommerce quando il modello viene renderizzato.

Funzioni WCPOS​

Puoi utilizzare funzioni specifiche di WCPOS (prefissate con wcpos_) per accedere ai dati e alle funzionalità correlate al POS.

Migliori Pratiche​

Sviluppo del Modello​

  1. Inizia con una Copia: Inizia sempre copiando un modello predefinito piuttosto che creando da zero
  2. Testa a fondo: Usa la funzione di anteprima per testare il tuo modello prima di attivarlo
  3. Tieni i Backup: Esporta i tuoi modelli personalizzati o conserva copie del tuo codice
  4. Compatibile con Mobile: Assicurati che i tuoi modelli funzionino bene su diverse dimensioni di schermo

Qualità del Codice​

  1. Valida HTML: Assicurati che il tuo HTML sia ben formato
  2. Escape Output: Utilizza le funzioni di escaping di WordPress per la sicurezza
  3. Gestione degli Errori: Includi controlli di errore appropriati nel tuo codice PHP
  4. Commenti: Documenta le tue personalizzazioni per riferimenti futuri

Prestazioni​

  1. Ottimizza CSS: Mantieni gli stili minimi ed efficienti
  2. Minimizza PHP: Evita logica complessa nei modelli
  3. Testa la Stampa: Verifica che i modelli funzionino bene con le tue stampanti di ricevute

Risoluzione dei Problemi​

Problemi Comuni​

Modello Non Mostra Cambiamenti

  • Assicurati di aver cliccato su "Aggiorna" per salvare le tue modifiche
  • Controlla che il modello sia impostato come "Attivo"
  • Pulisci eventuali plugin di caching

Errori di Sintassi

  • Usa l'evidenziazione della sintassi per identificare problemi
  • Controlla la mancanza di punto e virgola, parentesi o virgolette
  • Valida la tua sintassi PHP

Problemi di Styling

  • Testa il tuo CSS nella modalità di anteprima
  • Assicurati che gli stili siano compatibili con le stampanti di ricevute
  • Tieni a mente i principi di design adatti alla stampa

Modello Non Disponibile

  • Controlla che il tipo di modello sia impostato su "Ricevuta"
  • Verifica che lo stato del modello sia "Pubblicato"
  • Assicurati di avere le autorizzazioni appropriate

Ottenere Aiuto​

Se incontri problemi con la personalizzazione dei modelli:

  1. Controlla l'anteprima del modello per messaggi di errore
  2. Rivedi il registro di debug di WordPress per errori PHP
  3. Testa prima con una copia del modello predefinito
  4. Assistenza AI: Strumenti AI moderni come Gemini, ChatGPT e Claude sono eccellenti nell'aiutare con modelli WordPress semplici come questi. Puoi incollare il tuo codice del modello e descrivere cosa vuoi ottenere.
  5. Consulta la documentazione di WooCommerce POS per personalizzazioni avanzate

Personalizzazione Avanzata​

Per utenti avanzati che necessitano di maggior controllo sui modelli di ricevuta:

Integrazione del Tema​

Puoi sovrascrivere il modello predefinito posizionando un file receipt.php personalizzato nel tuo tema:

your-theme/woocommerce-pos/receipt.php

Hook e Filtri​

WooCommerce POS fornisce vari hook e filtri per la personalizzazione dei modelli. Consulta la documentazione per sviluppatori per le opzioni disponibili.

Campi Personalizzati​

Puoi includere campi d'ordine personalizzati, attributi di prodotto e altri metadati nei tuoi modelli di ricevuta utilizzando le appropriate funzioni di WordPress e WooCommerce.