Zum Hauptinhalt springen
Version: 1.x

Belegvorlagen

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

Übersicht​

Das Templatesystem bietet zwei Arten von Vorlagen:

  • Standardvorlagen: Automatisch aus Ihren Plugin- und Theme-Dateien erkannt. Diese können nicht gelöscht werden, können jedoch 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 Template-Editor​

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

Standardvorlagen​

Das System erkennt automatisch Belegvorlagen aus drei Quellen:

Vorlagenquellen​

QuelleBeschreibungStatus
PluginKernbelegvorlage, die mit WooCommerce POS geliefert wirdImmer verfügbar
Pro PluginVerbesserte Vorlage von WooCommerce POS ProVerfügbar mit aktivem 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 von benutzerdefinierten 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: 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
  4. Beginnen Sie mit dem Codieren Ihrer Vorlage im Editor

Funktionen des Template-Editors​

Der Template-Editor bietet:

Code-Editor​

  • Syntax-Highlighting: PHP-Syntax-Hervorhebung für bessere Lesbarkeit des Codes
  • Zeilennummern: Einfache Navigation und Debugging
  • Vollbildbearbeitung: Ablenkungsfreie Bearbeitungsumgebung

Vorlagen-Einstellungsbereich​

  • Sprache: Auf PHP einstellen für korrektes Syntax-Highlighting
  • Vorlagentyp: Wählen Sie zwischen Beleg- oder Berichtsvorlagen
  • Status: Veröffentlichungs-/Entwurf-Statusverwaltung
  • Sichtbarkeit: Kontrolle über die Sichtbarkeit der Vorlage

Vorlagenaktionen​

  • Vorschau: Sehen, wie Ihre Vorlage mit Beispieldaten gerendert wird
  • Als aktiv festlegen: Diese Vorlage zur Standardvorlage für Ihr POS machen
  • 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>
        /* Ihre benutzerdefinierten CSS-Stile */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Weitere Stile nach Bedarf hinzufügen */
    </style>
</head>
<body>
    <!-- Ihr Beleginhalt -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Bestelldetails, Artikel, Gesamtbeträge usw. -->

</body>
</html>

Verfügbare Vorlagenvariablen​

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

Geschäftsinformationen​

  • get_bloginfo( 'name' ) - Geschäftsname
  • get_bloginfo( 'description' ) - Geschäftsslogan
  • 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 (mit dem Präfix 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. Backups aufbewahren: Exportieren Sie Ihre benutzerdefinierten Vorlagen oder halten 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 geformt ist
  2. Ausgabe escapen: Verwenden Sie WordPress-Escaping-Funktionen für Sicherheit
  3. Fehlerbehandlung: Fügen Sie eine ordnungsgemäße Fehlerüberprüfung in Ihrem PHP-Code ein
  4. Kommentare: Dokumentieren Sie Ihre Anpassungen für zukünftige Referenzen

Leistung​

  1. CSS optimieren: Halten Sie die Stile minimal und effizient
  2. PHP minimieren: Vermeiden Sie komplexe Logik in Vorlagen
  3. Druck testen: Überprüfen Sie, ob die Vorlagen mit Ihren Belegdruckern gut 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
  • Löschen Sie alle Caching-Plugins

Syntaxfehler

  • Verwenden Sie die Syntax-Hervorhebung, 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 Gestaltungsprinzipien

Vorlage nicht verfügbar

  • Überprüfen Sie, ob der Vorlagentyp auf "Beleg" eingestellt ist
  • Überprüfen Sie, ob der Vorlagenstatus "Veröffentlicht" ist
  • Stellen Sie sicher, dass Sie die richtigen Berechtigungen haben

Hilfe erhalten​

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

  1. Überprüfen Sie die Voransicht der Vorlage auf Fehlermeldungen
  2. Überprüfen Sie das WordPress-Debug-Protokoll 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 WooCommerce POS-Dokumentation für fortgeschrittene Anpassungen

Erweiterte Anpassung​

Für fortgeschrittene Benutzer, die mehr Kontrolle über Belegvorlagen 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​

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

Benutzerdefinierte Felder​

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