=== MHD Assistent Lite ===
Contributors: rogerruckstuhl
Tags: mhd, Haltbarkeit, woocommerce, Ablaufdatum, Produkte
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.1.2
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Zeigt Mindesthaltbarkeitsdaten für einfache und variable Produkte im WooCommerce-Shop an. Ideal für Shops mit verderblichen Waren.

== Description ==

Der MHD Assistent Lite ermöglicht es Shopbetreibern, Mindesthaltbarkeitsdaten (MHD) für ihre Produkte anzuzeigen. Das Plugin ist besonders nützlich für Online-Shops, die Lebensmittel, Kosmetik, Nahrungsergänzungsmittel oder andere Produkte mit begrenzter Haltbarkeit verkaufen.

= Hauptfunktionen =

* **MHD-Anzeige für einfache Produkte** - Zeige ein Mindesthaltbarkeitsdatum für jedes einzelne Produkt
* **MHD-Anzeige für variable Produkte** - Zeige das passende MHD je nach gewählter Variation an
* **Vollständig anpassbare Darstellung** - Farben, Schriftgrößen, Schriftgewichte und Abstände individuell konfigurieren
* **Live-Vorschau** - Sehe sofort, wie deine Änderungen aussehen werden
* **Intelligente Positionierung** - Automatische Platzierung nach der Kurzbeschreibung oder anderen geeigneten Elementen
* **Shortcode-Unterstützung** - Flexible Platzierung mit `[mhd_anzeige]` für maximale Kompatibilität
* **Theme-kompatibel** - Funktioniert mit allen WooCommerce-Themes, einschließlich Elementor
* **Benutzerfreundliche Einrichtung** - Einfache Konfiguration direkt in den Produkteinstellungen
* **WordPress-Standard-konform** - Optimiert für Performance und Sicherheit
* **DACH-Lokalisierung** - Vollständige Übersetzungen für Deutschland, Österreich und Schweiz

= Darstellungsoptionen =

* Anpassbare Label- und Wert-Farben
* Konfigurierbare Schriftgrößen (10-24px)
* Verschiedene Schriftgewichte (Normal, Fett, Leicht)
* Individuelle Abstände oben und unten (0-50px)
* Live-Vorschau aller Änderungen

= Shortcode-Verwendung =

Verwende den Shortcode `[mhd_anzeige]` für maximale Flexibilität:
- Platziere das MHD genau dort, wo du es haben möchtest
- Ideal für Custom-Themes oder Page Builder
- Perfekte Lösung bei Darstellungsproblemen

= Premium-Version =

Die PRO-Version bietet erweiterte Funktionen und nahtlose Integration (in Entwicklung):

* **Erweiterte MHD-Verwaltung:**
  - Automatische MHD-Berechnung basierend auf Produkt-Kategorien
  - Multiple MHDs pro Produkt
  - Bulk-Bearbeitung von MHDs
  - Import/Export-Funktionen

* **Kundenfunktionen:**
  - Kundenseitige MHD-Filtermöglichkeiten
  - Erweiterte Sortierungsoptionen
  - MHD-basierte Produktsuche

* **Automatisierung:**
  - E-Mail-Benachrichtigungen bei ablaufenden MHDs
  - Automatische Produktverwaltung
  - Lagerbestandsintegration

* **Erweiterte Darstellung:**
  - Zusätzliche Positionierungsoptionen
  - Erweiterte Styling-Möglichkeiten
  - Custom Templates

* **Support & Updates:**
  - Prioritäts-Support
  - Regelmäßige Updates
  - Migrationshilfe von der Lite-Version

**Nahtloses Upgrade:** Die PRO-Version erkennt automatisch deine Lite-Version-Einstellungen und übernimmt sie vollständig.

[Mehr zur PRO-Version erfahren](https://rogerruckstuhl.ch/plugins/mhd-assistent-pro/) (in Entwicklung)

== Installation ==

= Automatische Installation =

1. Gehe zu deinem WordPress-Dashboard
2. Navigiere zu **Plugins** > **Installieren**
3. Suche nach "MHD Assistent Lite"
4. Klicke auf **Jetzt installieren** und dann auf **Aktivieren**

= Manuelle Installation =

1. Lade die Plugin-Dateien in das Verzeichnis `/wp-content/plugins/mhd-assistent-lite/` hoch
2. Aktiviere das Plugin über das **Plugins**-Menü in WordPress
3. Stelle sicher, dass WooCommerce installiert und aktiviert ist

= Konfiguration =

1. **Darstellung anpassen:**
   - Gehe zu **WooCommerce** > **MHD Einstellungen**
   - Passe Farben, Schriftgrößen und Abstände nach deinen Wünschen an
   - Nutze die Live-Vorschau, um das Ergebnis zu sehen
   - Klicke auf **Einstellungen speichern**

2. **MHD für einfache Produkte festlegen:**
   - Bearbeite ein Produkt in WooCommerce
   - Scrolle zum Abschnitt **Produktdaten**
   - Aktiviere die Checkbox **MHD aktivieren**
   - Wähle das **Mindesthaltbarkeitsdatum** aus
   - Speichere das Produkt

3. **MHD für variable Produkte festlegen:**
   - Bearbeite ein variables Produkt
   - Gehe zum Tab **Variationen**
   - Erweitere eine Variation
   - Aktiviere **MHD aktivieren** für die gewünschte Variation
   - Setze das **Mindesthaltbarkeitsdatum** für diese Variation
   - Wiederhole dies für alle Variationen mit MHD
   - Speichere das Produkt

4. **Shortcode verwenden (optional):**
   - Nutze `[mhd_anzeige]` für flexible Platzierung
   - Ideal bei Darstellungsproblemen
   - Platziere den Shortcode im Theme oder Page Builder

= Theme-Kompatibilität =

Das Plugin ist mit allen Standard-WooCommerce-Themes kompatibel und funktioniert auch mit:
- Elementor-basierten Themes
- Custom WooCommerce-Templates
- Page-Builder-Themes

Bei Kompatibilitätsproblemen nutze einfach den Shortcode `[mhd_anzeige]`.

== Frequently Asked Questions ==

= Das MHD wird nicht angezeigt, was kann ich tun? =

Wenn das MHD trotz korrekter Einstellungen nicht angezeigt wird, haben wir eine einfache Lösung:

**Nutze den Shortcode `[mhd_anzeige]`:**
1. Bearbeite deine Produktseiten-Vorlage (Theme oder Page Builder)
2. Füge den Shortcode `[mhd_anzeige]` an der gewünschten Stelle ein
3. Das MHD wird nun genau dort angezeigt

**Weitere Lösungsansätze:**
- Cache leeren (Browser und WordPress)
- Prüfe, ob "MHD aktivieren" gesetzt und ein Datum eingetragen ist
- Teste mit einem Standard-Theme (z.B. Twenty Twenty-Four)
- Deaktiviere temporär andere Plugins

Der Shortcode ist die universelle Lösung für alle Theme-Kompatibilitätsprobleme!

= Kann ich mehrere MHDs pro Produkt anzeigen? =

In der Lite-Version kann für jedes einfache Produkt ein MHD und für jede Variation eines variablen Produkts ein eigenes MHD angegeben werden. Multiple MHDs pro Produkt sind in der PRO-Version verfügbar.

= Kann ich von der Lite- zur PRO-Version wechseln? =

Ja, das Upgrade ist nahtlos! Die PRO-Version erkennt automatisch deine Lite-Version und übernimmt alle Einstellungen:

1. **Automatische Erkennung:** Die PRO-Version erkennt die Lite-Version automatisch
2. **Einstellungs-Migration:** Alle deine Anpassungen werden übernommen
3. **Nahtlose Integration:** Keine Neueinrichtung erforderlich
4. **Lite-Version bleibt inaktiv:** Die PRO-Version übernimmt alle Funktionen

**Upgrade-Prozess:**
- Installiere die PRO-Version
- Die Lite-Version wird automatisch deaktiviert
- Alle Einstellungen und MHDs bleiben erhalten
- Sofortiger Zugriff auf alle PRO-Features

= Ist das Plugin mit meinem Theme kompatibel? =

Ja, das Plugin wurde für maximale Kompatibilität entwickelt. Es verwendet die Standard-WooCommerce-Hooks und injiziert die MHD-Anzeige intelligent an den passenden Stellen. Es funktioniert auch mit Elementor und anderen Page-Buildern.

Falls es dennoch Probleme gibt, nutze einfach den Shortcode `[mhd_anzeige]` für eine garantierte Anzeige.

= Wo wird das MHD auf der Produktseite angezeigt? =

Das Plugin verwendet eine intelligente Positionierung:
1. **Erste Priorität:** Nach der Kurzbeschreibung des Produkts
2. **Zweite Priorität:** Nach dem Produktpreis
3. **Fallback:** An anderen geeigneten Stellen der Produktzusammenfassung
4. **Manuell:** Mit dem Shortcode `[mhd_anzeige]` kannst du die Position selbst bestimmen

= Kann ich das Aussehen der MHD-Anzeige anpassen? =

Ja! Gehe zu **WooCommerce** > **MHD Einstellungen** und passe folgende Elemente an:
- Farben für Label und Werte
- Schriftgrößen (10-24px)
- Schriftgewichte
- Abstände oben und unten
- Live-Vorschau zeigt dir sofort das Ergebnis

= Funktioniert das Plugin mit variablen Produkten? =

Ja, das Plugin unterstützt variable Produkte vollständig:
- Bei 1-2 Variationen werden alle MHDs direkt angezeigt
- Bei mehr als 2 Variationen wird das MHD dynamisch basierend auf der Kundenauswahl angezeigt
- Jede Variation kann ein eigenes MHD haben

= Wie verwende ich den Shortcode? =

Der Shortcode `[mhd_anzeige]` kann überall eingefügt werden:
- In Produktbeschreibungen
- In Theme-Templates
- In Page-Builder-Elementen
- In Widget-Bereichen

Der Shortcode zeigt automatisch das MHD des aktuellen Produkts an.

= Ist das Plugin performance-optimiert? =

Ja, das Plugin ist für beste Performance entwickelt:
- Minimaler Code-Footprint
- Nur Inline-CSS und -JavaScript (keine externen Dateien)
- Lädt nur auf Produktseiten mit aktivierten MHDs
- WordPress-Standard-konforme Implementierung

= Kann ich das Plugin in anderen Sprachen verwenden? =

Das Plugin ist übersetzungsbereit und kommt mit vollständigen Übersetzungen für:
- Deutsch (Deutschland) - formell und informell
- Deutsch (Österreich) - formell und informell
- Deutsch (Schweiz) - informell

Du kannst weitere Übersetzungen über die Standard-WordPress-Lokalisierungsmethoden hinzufügen.

== Screenshots ==

1. **Anzeige auf der Produktseite mit einfachem Produkt** - MHD-Anzeige bei einfachen Produkten und variablen Produkten mit max. 2 Varianten
2. **Anzeige auf der Produktseite mit variablen Produkten** - Dynamische MHD-Anzeige bei mehr als 3 Variationen
3. **Adminmenü für die Darstellungseinstellungen** - Vollständige Kontrolle über Farben, Schriftgrößen und Abstände mit Live-Vorschau
4. **Einzelprodukt MHD festlegen** - Einfache Aktivierung und Datumsauswahl im Produktbearbeitungsbereich
5. **Variables Produkt MHD auf Variationsebene** - Individuelle MHD-Einstellungen für jede Produktvariation

== Changelog ==

= 1.1.2 =
* **NEU:** Prominenter orangefarbener Hinweiskasten für Shortcode-Verwendung in den Einstellungen
* **VERBESSERT:** Deutliche Erklärung warum MHD manchmal nicht automatisch angezeigt wird
* **VERBESSERT:** Shortcode-Hinweis direkt oben in den Einstellungen platziert
* **DOKUMENTATION:** Komplette Überarbeitung mit Fokus auf Shortcode als Universallösung
* **ÜBERSETZUNGEN:** Neue Strings für den prominenten Hinweiskasten
* **BENUTZERFREUNDLICHKEIT:** Klarere Kommunikation bei Theme-Kompatibilitätsproblemen
* **LOKALISIERUNG:** Aktualisierung der vollständigen Übersetzungen für DACH-Region (Deutschland, Österreich, Schweiz)

= 1.1.1 =
* **Lokalisierung:** Vollständige Übersetzungen für DACH-Region (Deutschland, Österreich, Schweiz)
* **Sprachvarianten:** Formelle und informelle Anrede für DE/AT, informelle Version für CH
* **Screenshot-Updates:** Verbesserte und korrekt beschriftete Screenshots
* **Dokumentation:** Erweiterte FAQ-Sektion mit Shortcode-Hinweisen
* **Link-Korrekturen:** Aktualisierte Links zur PRO-Version
* **Code-Optimierung:** Kleinere Verbesserungen für bessere Performance

= 1.1.0 =
* **Shortcode-Support:** Neuer Shortcode `[mhd_anzeige]` für flexible Platzierung
* **Hook-basierte Anzeige:** Umstellung von JavaScript auf WooCommerce-Hooks für bessere Kompatibilität
* **PHP 8.1+ Support:** Vollständige Kompatibilität mit PHP 8.1 und 8.2
* **PRO-Version Kompatibilität:** Optimierungen für nahtlose Integration mit der PRO-Version
* **Code-Architektur:** Verbesserte Plugin-Architektur für bessere Erweiterbarkeit
* **PRO-Erkennung:** Intelligente Erkennung und Koexistenz mit der PRO-Version
* **API-Verbesserungen:** Erweiterte Hooks und Filter für Plugin-Entwickler
* **Migrationssystem:** Automatische Einstellungs-Migration zwischen Versionen
* **Stabilität:** Verbesserte Plugin-Stabilität bei gleichzeitigem Betrieb mit anderen Extensions

= 1.0.2 =
* **WordPress-Standard-Konformität:** Vollständige Überarbeitung der CSS/JS-Einbindung für WordPress-Richtlinien-Konformität
* **Performance-Verbesserungen:** Optimierte Inline-Code-Implementierung ohne externe Dateien
* **Code-Qualität:** Beseitigung aller WordPress-Linter-Warnungen
* **Bessere Theme-Kompatibilität:** Verbesserte Kompatibilität mit Elementor und anderen Page-Buildern
* **Sicherheitsverbesserungen:** Verstärkte Nonce-Überprüfungen und Input-Validierung
* **Live-Vorschau:** Erweiterte Live-Vorschau-Funktionalität in den Einstellungen
* **Intelligente Positionierung:** Verbesserte automatische Platzierung der MHD-Anzeige
* **Code-Optimierung:** Schlankerer und wartungsfreundlicherer Code

= 1.0.1 =
* Fehlerbehebungen und Verbesserungen
* Kompatibilität mit WordPress 6.5
* Verbesserte Variation-Handhabung

= 1.0.0 =
* Erstveröffentlichung
* Grundfunktionen für einfache und variable Produkte
* Anpassbare Darstellung
* Admin-Interface

== Upgrade Notice ==

= 1.1.1 =
Neue Version mit vollständigen DACH-Übersetzungen, verbesserten Screenshots und optimierter Dokumentation. Empfohlenes Update für alle deutschsprachigen Nutzer.

= 1.1.0 =
**Wichtiges Update:** Neuer Shortcode `[mhd_anzeige]` für maximale Theme-Kompatibilität. Hook-basierte Anzeige und PHP 8.1+ Support. Empfohlenes Update für alle Nutzer.

= 1.0.2 =
**Wichtiges Update:** Dieses Update verbessert die WordPress-Standard-Konformität erheblich und behebt alle Linter-Warnungen. Empfohlenes Update für alle Nutzer.

= 1.0.1 =
Dieses Update enthält wichtige Fehlerbehebungen und Kompatibilitätsverbesserungen.

== Support ==

Bei Fragen oder Problemen:

* **Dokumentation:** Vollständige Anleitung in diesem readme
* **Support-Forum:** WordPress.org Plugin-Support
* **Premium-Support:** Verfügbar mit der PRO-Version (in Entwicklung)
* **Website:** [rogerruckstuhl.ch](https://rogerruckstuhl.ch)

== Technische Anforderungen ==

* WordPress 6.0 oder höher
* WooCommerce 7.0 oder höher  
* PHP 8.1 oder höher
* Moderne Browser mit JavaScript-Unterstützung