StoreaBill Custom Shortcodes

Version: 1.8
Typ: WordPress MU-Plugin
Kompatibel mit: WooCommerce Germanized Pro, StoreaBill

Beschreibung

Dieses MU-Plugin erweitert StoreaBill (WooCommerce Germanized Pro) um benutzerdefinierte Shortcodes für Rechnungen und andere Dokumente.

Installation

1. Datei storeabill-custom-shortcodes.php hochladen nach:

   wp-content/mu-plugins/storeabill-custom-shortcodes.php

2. Fertig! MU-Plugins werden automatisch aktiviert.

Verfügbare Shortcodes

1. Lieferdatum

{order?data=lieferdatum}

• Zeigt das Lieferdatum der Bestellung
• Liest aus: Lieferdatum Meta oder _orddd_lite_timestamp
• Format: dd.mm.YYYY

2. Zeitfenster

{order?data=zeitfenster}

• Zeigt das gewählte Lieferzeitfenster
• Liest aus: Zeitfenster oder _orddd_time_slot
• "ASAP" wird zu "So schnell wie möglich" übersetzt

3. Kundennummer

{order?data=kundennummer}

• Zeigt die Kundennummer (WooCommerce Germanized)
• Liest aus: _customer_number (Order Meta) oder User Meta

4. NIE/NIF/CIF (Spanische Steuernummer)

{order?data=nif}

• Zeigt die spanische Steuernummer (NIE/NIF/CIF)
• Unterstützt Checkout Fields Plugin (Feldname: nie_)
• Sucht in vielen Meta-Keys automatisch

Verwendung im Template

1. Gehe zu StoreaBill → Rechnungen → Template bearbeiten
2. Füge an gewünschter Stelle ein:

<p>Kundennummer: {order?data=kundennummer}</p>
<p>NIE/NIF/CIF: {order?data=nif}</p>
<p>Lieferdatum: {order?data=lieferdatum}</p>
<p>Zeitfenster: {order?data=zeitfenster}</p>

Oder wähle die Shortcodes aus der Dropdown-Liste im Editor.

Unterstützte Meta-Keys

Kundennummer

• _customer_number (Order Meta - WooCommerce Germanized)
• billing_kundennummer_ (User Meta)
• kundennummer (User Meta)
• billing_kundennummer (User Meta)
• _kundennummer (Order/User Meta)
• customer_number (User Meta)

NIE/NIF/CIF

• nie_, _nie_ (Checkout Fields Plugin)
• _billing_nie_, billing_nie_
• nie, nif, cif, dni
• _billing_nie, _billing_nif, _billing_cif
• _billing_vat_id, billing_vat_id
• _billing_eu_vat_number, _eu_vat_number
• vat_number, vat_id, tax_id
• Und weitere Varianten...

Changelog

Version 1.8 (2025-12-13)

• KRITISCHER FIX: TypeError behoben - strtolower() erhielt Objekt statt String
• KRITISCHER FIX: ArgumentCountError behoben - get_meta() ohne Parameter
• Neue Helper-Funktionen für sichere Order-Extraktion
• Umfassende Type-Checks an allen kritischen Stellen
• Try-catch Blöcke für Error-Handling
• Kompatibilität mit StoreaBill/Germanized Pro Wrapper-Klassen

Version 1.7 (2025-12-13)

• NIE/NIF/CIF Shortcode hinzugefügt (nie_ Key für Checkout Fields)

Version 1.6 (2025-12-13)

• Erweiterte Meta-Key Suche für NIE/NIF

Version 1.5 (2025-12-13)

• NIE/NIF/CIF Shortcode initial hinzugefügt

Version 1.4 (2025-12-13)

• TypeError-Fix für strtolower() (erste Version)
• is_string() Check hinzugefügt

Version 1.0-1.3

• Initiale Implementierung
• Lieferdatum, Zeitfenster, Kundennummer Shortcodes

Fehlerbehebung

Fatal Error: strtolower() expects string

Problem: StoreaBill übergibt manchmal ein Order-Objekt statt String an den Filter.

Lösung: Version 1.8 prüft alle Parameter mit is_string() vor Verwendung.

Fatal Error: get_meta() too few arguments

Problem: Inkompatible Methoden-Aufrufe mit StoreaBill Order-Wrapper.

Lösung: Version 1.8 verwendet Helper-Funktion sab_custom_get_order_meta() mit Error-Handling.

Shortcode zeigt nichts an

1. Prüfe ob der Meta-Key korrekt ist
2. Prüfe Order Meta in WooCommerce → Bestellungen → [Bestellung] → Custom Fields
3. Füge ggf. den spezifischen Key zur $possible_keys Liste hinzu

Technische Details

Verwendete WordPress/WooCommerce Hooks

// Shortcodes im Editor-Dropdown registrieren
add_filter('storeabill_document_template_editor_available_shortcodes', ...);

// Shortcode-Werte auflösen (Methode 1)
add_filter('storeabill_order_data_shortcode_result', ...);

// Shortcode-Werte auflösen (Methode 2 - direkter Zugriff)
add_filter('storeabill_shortcode_get_object_data', ...);

Helper-Funktionen

// Sichere Extraktion der WC_Order aus StoreaBill-Objekten
function sab_custom_get_wc_order($document)

// Sicherer Meta-Zugriff mit Error-Handling
function sab_custom_get_order_meta($order, $key)

Dateien

• storeabill-custom-shortcodes.php - Das MU-Plugin (nach wp-content/mu-plugins/)
• README.md - Diese Dokumentation

Support

Bei Fragen oder Problemen: Issue erstellen oder Code anpassen.

Lizenz

Proprietär - Nur für entregamos-bebidas.es / test.entregamos-bebidas.es