Zum Hauptinhalt springen
Version: 1.x

Belegvorlagen

Der Belegvorlagen-Editor ermöglicht es Ihnen, das Aussehen und den Inhalt der Belege, die von Ihrem POS-System gedruckt werden, anzupassen. Sie können auf den Vorlagen-Editor zugreifen, indem Sie navigieren zu: WP Admin > POS > Vorlagen

Ü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 Vorlagen-Editor​

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

Standardvorlagen​

Das System erkennt Belegvorlagen automatisch aus drei Quellen:

Vorlagenquellen​

QuelleBeschreibungStatus
PluginKern-Belegvorlage, die mit WooCommerce POS geliefert wirdImmer verfügbar
Pro PluginErweiterte Vorlage von WooCommerce POS ProVerfügbar mit aktivem Lizenz
ThemeBenutzerdefinierte Vorlage von 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: Diese Vorlage als aktive Vorlage für Ihr POS festlegen

Erstellen benutzerdefinierter Vorlagen​

Methode 1: Kopieren von der Standardvorlage​

  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 oben auf der Seite auf Neue Vorlage hinzufügen
  2. Geben Sie einen Vorlagennamen ein
  3. Wählen Sie Beleg als Vorlagentyp aus
  4. Beginnen Sie mit dem Codieren Ihrer Vorlage im Editor

Funktionen des Vorlagen-Editors​

Der Vorlagen-Editor bietet:

Code-Editor​

  • Syntaxhervorhebung: PHP-Syntaxhervorhebung für bessere Lesbarkeit des Codes
  • Zeilennummern: Einfache Navigation und Fehlersuche
  • Vollbildbearbeitung: Ablenkungsfreie Bearbeitungsumgebung

Einstellungsfeld für Vorlagen​

  • Sprache: Auf PHP einstellen, um eine ordnungsgemäße Syntaxhervorhebung zu ermöglichen
  • Vorlagentyp: Wählen Sie zwischen Beleg- oder Berichtsvorlagen
  • Status: Verwalten des Veröffentlicht-/Entwurf-Status
  • Sichtbarkeit: Steuerung der Sichtbarkeit der Vorlage

Vorlagenaktionen​

  • Vorschau: Sehen Sie, 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​

Belegvorlagen 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​

Beim Erstellen benutzerdefinierter Vorlagen haben Sie Zugriff auf verschiedene WordPress- und WooCommerce-Funktionen und -Daten:

Shop-Informationen​

  • get_bloginfo( 'name' ) - Shop-Name
  • get_bloginfo( 'description' ) - Shop-Slogan
  • get_bloginfo( 'url' ) - Shop-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 (mit wcpos_ Präfix) verwenden, um auf POS-bezogene Daten und Funktionen zuzugreifen.

Best Practices​

Vorlagenentwicklung​

  1. Beginnen Sie mit einer Kopie: Beginnen Sie immer mit einer Kopie einer Standardvorlage, anstatt von Grund auf neu zu erstellen
  2. Gründlich testen: Verwenden Sie die Vorschaufunktion, um Ihre Vorlage vor der Aktivierung zu testen
  3. Backups 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 formatiert ist
  2. Ausgabe escapen: Verwenden Sie die Escaping-Funktionen von WordPress aus Sicherheitsgründen
  3. Fehlerbehandlung: Integrieren Sie eine ordnungsgemäße Fehlersuche in Ihren PHP-Code
  4. Kommentare: Dokumentieren Sie Ihre Anpassungen für spätere Referenz

Leistung​

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

Fehlersuche​

Häufige Probleme​

Vorlage zeigt keine Änderungen an

  • Stellen Sie sicher, dass Sie auf "Aktualisieren" geklickt haben, um Ihre Änderungen zu speichern
  • Überprüfen Sie, ob die Vorlage als "Aktiv" festgelegt ist
  • Leeren Sie alle Caching-Plugins

Syntaxfehler

  • Verwenden Sie die Syntaxhervorhebung, um Probleme zu identifizieren
  • Überprüfen Sie auf fehlende Semikolons, Klammern oder Anführungszeichen
  • Validieren Sie Ihre PHP-Syntax

Styling-Probleme

  • Testen Sie Ihr CSS im Vorschau-Modus
  • Stellen Sie sicher, dass die Stile mit Belegdruckern kompatibel sind
  • Achten Sie auf druckfreundliche Designprinzipien

Vorlage nicht verfügbar

  • Überprüfen Sie, ob der Vorlagentyp auf "Beleg" festgelegt ist
  • Vergewissern Sie sich, dass der Status der Vorlage "Veröffentlicht" ist
  • Stellen Sie sicher, dass Sie über die entsprechenden Berechtigungen verfügen

Hilfe holen​

Wenn Sie Probleme mit der Anpassung von Vorlagen haben:

  1. Überprüfen Sie die Vorschau der Vorlage auf Fehlermeldungen
  2. Überprüfen Sie das WordPress-Debugprotokoll auf PHP-Fehler
  3. Testen Sie zunächst mit einer Kopie der Standardvorlage
  4. AI-Unterstützung: Moderne KI-Tools wie Gemini, ChatGPT und Claude sind hervorragend geeignet, um mit 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 WooCommerce POS-Dokumentation für erweiterte Anpassungen

Erweiterte Anpassung​

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

Theme-Integration​

Sie können die Standardvorlage überschreiben, indem Sie eine benutzerdefinierte Datei receipt.php in Ihr Theme einfügen:

your-theme/woocommerce-pos/receipt.php

Hooks und Filter​

WooCommerce POS bietet verschiedene Hooks und Filter zur Anpassung von Vorlagen. Konsultieren Sie die Entwicklerinformationen für verfügbare Optionen.

Benutzerdefinierte Felder​

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