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 di modelli fornisce due tipi di modelli:

  • Modelli Predefiniti: Riconosciuti automaticamente dai file del plugin e del 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 > Modelli
  3. Vedrai un elenco dei 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 principale incluso in WCPOSSempre disponibile
Pro PluginModello avanzato da WCPOS 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 i 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. Fai clic sul pulsante Copia
  3. Inserisci un nome per il tuo modello personalizzato
  4. Fai clic su Copia Modello
  5. Modifica il modello personalizzato appena creato

Metodo 2: Crea da Zero​

  1. Fai clic su Aggiungi Nuovo Modello nella parte superiore della pagina
  2. Inserisci un nome per il modello
  3. Seleziona Ricevuta come tipo di modello
  4. Inizia a scrivere il tuo modello nell'editor

Funzioni 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
  • Modifica 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: Guarda come viene visualizzato il tuo modello con i 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 WCPOS​

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

Migliori Pratiche​

Sviluppo del Modello​

  1. Inizia con una Copia: Inizia sempre copiando un modello predefinito anziché creando da zero
  2. Testa a Fondo: Usa la funzione di anteprima per testare il tuo modello prima di attivarlo
  3. Mantieni Backup: Esporta i tuoi modelli personalizzati o conserva copie del tuo codice
  4. Mobile-Friendly: 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 formattato
  2. Escape 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 riferimenti futuri

Performance​

  1. Ottimizza CSS: Mantieni stili minimi ed efficienti
  2. Minimizza PHP: Evita logica complessa nei modelli
  3. Test Stampa: Verifica che i modelli funzionino bene con le tue stampanti di 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"
  • Cancella eventuali plugin di caching
Errori di sintassi
  • Usa l'evidenziazione della sintassi per identificare problemi
  • Controlla eventuali punti e virgola, parentesi o virgolette mancanti
  • Valida la sintassi del tuo PHP
Problemi di stile
  • Prova il tuo CSS in modalità 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 giuste autorizzazioni

Ricevere Aiuto​

Se riscontri problemi con la personalizzazione del modello:

  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 modello e descrivere cosa vuoi raggiungere.
  5. Consulta la documentazione di WCPOS per personalizzazioni avanzate

Personalizzazione Avanzata​

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

Integrazione nel Tema​

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

your-theme/woocommerce-pos/receipt.php

Hook e Filtri​

WCPOS 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 funzioni appropriate di WordPress e WooCommerce.