Zum Hauptinhalt springen
Version: 1.x

Quittungsvorlagen

Der Quittungsvorlagen-Editor ermöglicht es Ihnen, das Erscheinungsbild und den Inhalt von Quittungen, die von Ihrem POS-System gedruckt werden, anzupassen. Sie können den Vorlageneditor aufrufen, indem Sie zu WP Admin > POS > Vorlagen navigieren.

Übersicht​

Das Vorlagensystem bietet zwei Arten von Vorlagen:

  • Standardvorlagen: Automatisch aus Ihren Plugin- und Theme-Dateien erkannt. Diese können nicht gelöscht, aber kopiert werden, um benutzerdefinierte Versionen zu erstellen.
  • Benutzerdefinierte Vorlagen: Vom Benutzer erstellte Vorlagen, die Sie vollständig anpassen, bearbeiten und verwalten können.

Zugriff auf den Vorlageneditor​

  1. Navigieren Sie zu Ihrem WordPress-Admin-Dashboard
  2. Gehen Sie zu POS > Vorlagen
  3. Sie sehen eine Liste verfügbarer Vorlagen, die in zwei Abschnitte organisiert ist:
    • Standardvorlagen (aus Plugin-/Theme-Dateien)
    • Benutzerdefinierte Vorlagen (Ihre benutzerdefinierten Kreationen)

Standardvorlagen​

Das System erkennt automatisch Quittungsvorlagen aus drei Quellen:

Vorlagenquellen​

QuelleBeschreibungStatus
PluginKernquittungsvorlage, die mit WCPOS geliefert wirdImmer verfügbar
Pro PluginVerbesserte Vorlage von WCPOS ProVerfügbar mit aktiver Lizenz
ThemeBenutzerdefinierte Vorlage aus Ihrem aktiven ThemeVerfügbar, wenn das Theme eine Vorlage enthält

Vorlagenaktionen​

Für jede Standardvorlage können Sie:

  • Vorschau: Sehen, wie die Vorlage mit Beispieldaten aussieht
  • Kopieren: Eine benutzerdefinierte Kopie erstellen, die Sie bearbeiten können
  • Aktivieren: Als aktive Vorlage für Ihr POS festlegen

Erstellen benutzerdefinierter Vorlagen​

Methode 1: Von der Standardvorlage kopieren​

  1. Suchen Sie im Abschnitt Standardvorlagen die Vorlage, die Sie anpassen möchten
  2. Klicken Sie auf die Schaltfläche Kopieren
  3. Geben Sie einen Namen für Ihre benutzerdefinierte Vorlage ein
  4. Klicken Sie auf Vorlage kopieren
  5. Bearbeiten Sie die neu erstellte benutzerdefinierte Vorlage

Methode 2: Von Grund auf neu erstellen​

  1. Klicken Sie auf Neue Vorlage hinzufügen oben auf der Seite
  2. Geben Sie einen Vorlagennamen ein
  3. Wählen Sie Quittung als Vorlagentyp aus
  4. Beginnen Sie mit dem Programmieren Ihrer Vorlage im Editor

Funktionen des Vorlageneditors​

Der Vorlageneditor bietet:

Code-Editor​

  • Syntaxhervorhebung: PHP-Syntaxhervorhebung für bessere Lesbarkeit des Codes
  • Zeilennummern: Einfache Navigation und Debugging
  • Vollbildbearbeitung: Ablenkungsfreies Bearbeitungsumfeld

Vorlageneinstellungen-Panel​

  • Sprache: Auf PHP einstellen für die richtige Syntaxhervorhebung
  • Vorlagentyp: Zwischen Quittungs- oder Berichtsvorlagen wählen
  • Status: Verwalten des Veröffentlichungs-/Entwurfsstatus
  • Sichtbarkeit: Steuerung der Sichtbarkeit der Vorlage

Vorlagenaktionen​

  • Vorschau: Sehen, wie Ihre Vorlage mit Beispieldaten gerendert wird
  • Als aktiv festlegen: Diese Vorlage als Standard für Ihr POS festlegen
  • Aktualisieren: Ihre Änderungen speichern
  • In den Papierkorb verschieben: Benutzerdefinierte Vorlagen löschen

Vorlagenstruktur​

Quittungsvorlagen sind PHP-Dateien, die HTML-Ausgaben generieren. Hier ist die grundlegende Struktur:

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

Verfügbare Vorlagenvariablen​

Bei der Erstellung benutzerdefinierter Vorlagen haben Sie Zugriff auf verschiedene WordPress- und WooCommerce-Funktionen und Daten:

Geschäftsinformationen​

  • get_bloginfo( 'name' ) - Geschäftsname
  • get_bloginfo( 'description' ) - Slogan des Geschäfts
  • get_bloginfo( 'url' ) - Geschäfts-URL

Bestelldaten​

Die aktuellen Bestelldaten sind über die standardmäßigen WooCommerce-Bestellfunktionen verfügbar, wenn die Vorlage gerendert wird.

WCPOS-Funktionen​

Sie können WCPOS-spezifische Funktionen (beginnen mit wcpos_) verwenden, um auf POS-bezogene Daten und Funktionen zuzugreifen.

Beste Praktiken​

Vorlagenentwicklung​

  1. Mit einer Kopie beginnen: Beginnen Sie immer damit, eine Standardvorlage zu kopieren, anstatt von Grund auf neu zu erstellen
  2. Gründlich testen: Verwenden Sie die Vorschaufunktion, um Ihre Vorlage vor der Aktivierung zu testen
  3. Sicherungen aufbewahren: Exportieren Sie Ihre benutzerdefinierten Vorlagen oder behalten Sie Kopien Ihres Codes
  4. Mobilfreundlich: Stellen Sie sicher, dass Ihre Vorlagen auf verschiedenen Bildschirmgrößen gut funktionieren

Codequalität​

  1. HTML validieren: Stellen Sie sicher, dass Ihr HTML gut strukturiert ist
  2. Ausgabe entkommen: Verwenden Sie WordPress-Entkommensfunktionen zur Sicherheit
  3. Fehlerbehandlung: Fügen Sie in Ihrem PHP-Code eine ordnungsgemäße Fehlerüberprüfung hinzu
  4. Kommentare: Dokumentieren Sie Ihre Anpassungen für zukünftige Referenz

Leistung​

  1. CSS optimieren: Halten Sie die Stile minimal und effizient
  2. PHP minimieren: Vermeiden Sie komplexe Logik in Vorlagen
  3. Drucken testen: Überprüfen Sie, ob die Vorlagen gut mit Ihren Quittungsdruckern funktionieren

Fehlersuche​

Häufige Probleme​

Vorlage zeigt keine Änderungen
  • Stellen Sie sicher, dass Sie auf "Aktualisieren" geklickt haben, um Ihre Änderungen zu speichern
  • Überprüfen Sie, ob die Vorlage als "Aktiv" festgelegt ist
  • Löschen Sie alle Caching-Plugins
Syntaxfehler
  • Verwenden Sie die Syntaxhervorhebung, um Probleme zu identifizieren
  • Überprüfen Sie auf fehlende Semikolons, geschweifte Klammern oder Anführungszeichen
  • Validieren Sie Ihre PHP-Syntax
Styling-Probleme
  • Testen Sie Ihr CSS im Vorschaumodus
  • Stellen Sie sicher, dass die Stile mit Quittungsdruckern kompatibel sind
  • Behalten Sie druckfreundliche Designprinzipien im Hinterkopf
Vorlage nicht verfügbar
  • Überprüfen Sie, ob der Vorlagentyp auf "Quittung" eingestellt ist
  • Vergewissern Sie sich, dass der Vorlagenstatus "Veröffentlicht" ist
  • Stellen Sie sicher, dass Sie über die richtigen Berechtigungen verfügen

Hilfe erhalten​

Wenn Sie auf Probleme mit der Anpassung von Vorlagen stoßen:

  1. Überprüfen Sie die Vorlagenvorschau auf Fehlermeldungen
  2. Überprüfen Sie das Debug-Log von WordPress auf PHP-Fehler
  3. Testen Sie zuerst mit einer Kopie der Standardvorlage
  4. KI-Hilfe: Moderne KI-Tools wie Gemini, ChatGPT und Claude sind hervorragend geeignet, um bei einfachen WordPress-Vorlagen wie diesen zu helfen. Sie können Ihren Vorlagen-Code einfügen und beschreiben, was Sie erreichen möchten.
  5. Konsultieren Sie die WCPOS-Dokumentation für erweiterte Anpassungen

Erweiterte Anpassungen​

Für erfahrene Benutzer, die mehr Kontrolle über Quittungsvorlagen benötigen:

Theme-Integration​

Sie können die Standardvorlage überschreiben, indem Sie eine benutzerdefinierte receipt.php-Datei in Ihrem Theme platzieren:

your-theme/woocommerce-pos/receipt.php

Hooks und Filter​

WCPOS bietet verschiedene Hooks und Filter für die Vorlagenanpassung. Konsultieren Sie die Entwicklerdokumentation für verfügbare Optionen.

Benutzerdefinierte Felder​

Sie können benutzerdefinierte Bestellfelder, Produktattribute und andere Metadaten in Ihren Quittungsvorlagen unter Verwendung der entsprechenden WordPress- und WooCommerce-Funktionen einfügen.