Zum Hauptinhalt springen
Version: 1.x

Belegvorlagen

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

Überblick​

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 Varianten 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 verfügbarer Vorlagen, die in zwei Abschnitte unterteilt ist:
    • 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 PluginErweiterte Vorlage von WooCommerce POS ProVerfügbar bei 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 Sie sich an, wie die Vorlage mit Beispieldaten aussieht
  • Kopieren: Erstellen Sie eine benutzerdefinierte Kopie, die Sie bearbeiten können
  • Aktivieren: Als aktive Vorlage für Ihr POS festlegen

Erstellung benutzerdefinierter Vorlagen​

Methode 1: Kopie von der Standardvorlage​

  1. Finden 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 Vorlagenart
  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 eine bessere Lesbarkeit des Codes
  • Zeilennummern: Einfache Navigation und Fehlersuche
  • Vollbildbearbeitung: Ablenkungsfreier Bearbeitungsmodus

Vorlagen-Einstellungsfeld​

  • Sprache: Auf PHP setzen für ordnungsgemäße Syntaxhervorhebung
  • Vorlagentyp: Wählen Sie zwischen Beleg- oder Berichtsvorlagen
  • Status: Verwaltung des Veröffentlichungs-/Entwurfsstatus
  • Sichtbarkeit: Kontrolle über die Sichtbarkeit der Vorlage

Vorlagenaktionen​

  • Vorschau: Sehen Sie, wie Ihre Vorlage mit Beispieldaten gerendert wird
  • Als aktiv festlegen: Machen Sie diese Vorlage zur Standardvorlage für Ihr POS
  • Aktualisieren: Speichern Sie Ihre Änderungen
  • In den Papierkorb verschieben: Löschen Sie benutzerdefinierte Vorlagen

Vorlagenstruktur​

Belegvorlagen sind PHP-Dateien, die HTML-Ausgaben erzeugen. Hier ist die Grundstruktur:

<?php
/**
 * Benutzerdefinierte Belegvorlage
 */

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 hinzufügen nach Bedarf */
    </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, Summen usw. -->

</body>
</html>

Verfügbare Vorlagenvariablen​

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

Geschäftsinformationen​

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

Bestelldaten​

Die aktuellen Bestelldaten sind über die Standard-WooCommerce-Bestellfunktionen verfügbar, wenn die Vorlage gerendert wird.

WCPOS-Funktionen​

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

Beste Praktiken​

Vorlagenentwicklung​

  1. Beginnen Sie mit einer Kopie: 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 anfertigen: Exportieren Sie Ihre benutzerdefinierten Vorlagen oder erstellen 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-Entwertungsfunktionen für Sicherheit
  3. Fehlerbehandlung: Fügen Sie in Ihrem PHP-Code eine ordnungsgemäße Fehlerüberprüfung ein
  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 Belegdruckern 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
  • Leeren Sie alle Caching-Plugins
Syntaxfehler
  • Verwenden Sie die Syntaxhervorhebung, um Probleme zu identifizieren
  • Überprüfen Sie 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
  • Halten Sie druckfreundliche Designprinzipien im Auge
Vorlage nicht verfügbar
  • Überprüfen Sie, ob der Vorlagentyp auf "Beleg" festgelegt 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 Probleme mit der Anpassung von Vorlagen haben:

  1. Überprüfen Sie die Vorlage-Vorschau auf Fehlermeldungen
  2. Überprüfen Sie das WordPress-Debug-Log auf PHP-Fehler
  3. Testen Sie zuerst mit einer Kopie der Standardvorlage
  4. KI-Unterstützung: 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 Dokumentation von WooCommerce POS für erweiterte Anpassungen

Erweiterte Anpassungen​

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 Ihr Theme legen:

your-theme/woocommerce-pos/receipt.php

Hooks und Filter​

WooCommerce POS 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 Ihre Belegvorlagen einfügen, indem Sie die entsprechenden WordPress- und WooCommerce-Funktionen verwenden.