Salta al contenuto principale
Versione: 1.x

Modelli di Ricevuta

L'editor dei modelli di ricevuta consente di personalizzare l'aspetto e il contenuto delle ricevute stampate dal tuo sistema POS. Puoi accedere all'editor dei modelli navigando su: 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 dagli utenti che puoi personalizzare, modificare e gestire completamente.

Accesso all'Editor dei Modelli​

  1. Naviga nella tua dashboard di WordPress Admin
  2. Vai su POS > Templates
  3. Vedrai un elenco di modelli disponibili organizzati 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 core incluso in WooCommerce POSSempre disponibile
Pro PluginModello avanzato da WooCommerce POS ProDisponibile con licenza attiva
TemaModello personalizzato dal tuo tema attivoDisponibile se il tema include il modello

Azioni sui Modelli​

Per ogni modello predefinito, puoi:

  • Anteprima: Visualizzare come appare il modello con dati di esempio
  • Copia: Creare una copia personalizzata che puoi modificare
  • Attiva: Impostare 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 modello personalizzato appena creato

Metodo 2: Crea da Zero​

  1. Clicca su Aggiungi Nuovo Modello in cima alla pagina
  2. Inserisci un nome per il modello
  3. Seleziona Ricevuta come tipo di modello
  4. Inizia a codificare il tuo modello nell'editor

Caratteristiche dell'Editor dei Modelli​

L'editor dei modelli offre:

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 Report
  • Stato: Gestione dello stato Pubblicato/Bozza
  • Visibilità: Controlla la visibilità del modello

Azioni sui Modelli​

  • Anteprima: Vedi come si presenta il tuo modello con dati di esempio
  • Imposta come Attivo: Rendi questo modello il predefinito per il tuo POS
  • Aggiorna: Salva le tue modifiche
  • Sposta nel Cestino: Elimina i 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 degli ordini di WooCommerce quando il modello viene renderizzato.

Funzioni di WCPOS​

Puoi utilizzare funzioni specifiche di WCPOS (prefissate con wcpos_) per accedere ai dati e alle funzionalità relative 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 anteprima per testare il tuo modello prima di attivarlo
  3. Tieni Copie di Backup: Esporta i tuoi modelli personalizzati o conserva copie del tuo codice
  4. Ottimizzato per Mobile: Assicurati che i tuoi modelli funzionino bene su diverse dimensioni di schermo

Qualità del Codice​

  1. Valida l'HTML: Assicurati che il tuo HTML sia ben formato
  2. Escapa l'Output: Usa 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 riferimento futuro

Prestazioni​

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

Risoluzione dei Problemi​

Problemi Comuni​

Il modello non mostra le modifiche
  • Assicurati di aver cliccato "Aggiorna" per salvare le tue modifiche
  • Controlla che il modello sia impostato come "Attivo"
  • Svuota eventuali plugin di cache
Errori di sintassi
  • Usa l'evidenziazione della sintassi per identificare i problemi
  • Controlla le virgolette, i punti e virgola o le parentesi mancanti
  • Valida la sintassi PHP
Problemi di stile
  • Testa il tuo CSS nella modalità anteprima
  • Assicurati che gli stili siano compatibili con le stampanti per ricevute
  • Mantieni 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

Ricevere Aiuto​

Se riscontri problemi con la personalizzazione dei modelli:

  1. Controlla l'anteprima del modello per messaggi di errore
  2. Controlla 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 per aiutarti con semplici modelli WordPress 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 maggiore controllo sui modelli di ricevuta:

Integrazione del Tema​

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

your-theme/woocommerce-pos/receipt.php

Hooks e Filtri​

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

Campi Personalizzati​

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