Salta al contenuto principale
Versione: 1.x

Modelli di Ricevuta

L'editor del Modello 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 > Modelli

Panoramica​

Il sistema dei modelli fornisce due tipi di modelli:

  • Modelli Predefiniti: Rilevati automaticamente dai file del tuo plugin e 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 nel tuo cruscotto WordPress Admin
  2. Vai su POS > Modelli
  3. Vedrai un elenco di modelli disponibili organizzati in due sezioni:
    • Modelli Predefiniti (dai file del plugin / tema)
    • Modelli Personalizzati (le tue creazioni personalizzate)

Modelli Predefiniti​

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

Fonti del Modello​

FonteDescrizioneStato
PluginModello di ricevuta core incluso con 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 del Modello​

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 vuoi 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: Creare 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 fornisce:

Editor di Codice​

  • Evidenziazione della Sintassi: Evidenziazione della sintassi PHP per una migliore leggibilità del codice
  • Numeri di Riga: Navigazione e debug facili
  • Modifica a Schermo Intero: Ambiente di modifica privo di 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 Rapporto
  • Stato: Gestione dello stato Pubblicato / Bozza
  • Visibilità: Controlla la visibilità del modello

Azioni del Modello​

  • Anteprima: Vedi come il tuo modello si presenta 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 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 WCPOS​

Puoi utilizzare funzioni specifiche di WCPOS (prefissate con wcpos_) per accedere ai dati e alla funzionalità relativi 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. Conserva Backup: Esporta i tuoi modelli personalizzati o conserva copie del tuo codice
  4. Ottimizzato per Dispositivi Mobili: 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. Escape l'Output: Usa le funzioni di escaping di WordPress per la sicurezza
  3. Gestione degli Errori: Includi un'adeguata verifica degli errori nel tuo codice PHP
  4. Commenti: Documenta le tue personalizzazioni per riferimento futuro

Performance​

  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 di ricevuta

Risoluzione dei Problemi​

Problemi Comuni​

Template che non Mostra Modifiche

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

Errori di Sintassi

  • Utilizza l'evidenziazione della sintassi per identificare i problemi
  • Controlla eventuali punti e virgola, parentesi o virgolette mancanti
  • Valida la tua sintassi PHP

Problemi di Stile

  • Testa il tuo CSS in modalità anteprima
  • Assicurati che gli stili siano compatibili con le stampanti di ricevuta
  • Tieni a mente i principi di design ottimizzati per la 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 riscontri problemi con la personalizzazione del modello:

  1. Controlla l'anteprima del modello per eventuali messaggi di errore
  2. Rivedi il log di debug di WordPress per errori PHP
  3. Testa prima con una copia del modello predefinito
  4. Assistenza AI: Strumenti moderni di AI come Gemini, ChatGPT e Claude sono eccellenti per aiutare con modelli WordPress semplici come questi. Puoi incollare il tuo codice modello e descrivere cosa vuoi realizzare.
  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 collocando 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 del modello. 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.