# MHD Assistent Lite v1.1.0 - Installationsanleitung

## 🚀 Schnellstart

### Voraussetzungen prüfen
Bevor du beginnst, stelle sicher, dass dein System die folgenden Anforderungen erfüllt:

- ✅ WordPress 6.0 oder höher
- ✅ WooCommerce 7.0 oder höher  
- ✅ PHP 8.1 oder höher
- ✅ Aktive WooCommerce-Installation

## 📥 Installation

### Option 1: Automatische Installation (Empfohlen)

1. **Plugin-Bereich aufrufen**
   - Logge dich in dein WordPress-Dashboard ein
   - Navigiere zu **Plugins** → **Installieren**

2. **Plugin suchen**
   - Gebe "MHD Assistent Lite" in das Suchfeld ein
   - Klicke auf **Suchen**

3. **Plugin installieren**
   - Finde das Plugin in den Suchergebnissen
   - Klicke auf **Jetzt installieren**
   - Warte, bis die Installation abgeschlossen ist
   - Klicke auf **Aktivieren**

### Option 2: Manuelle Installation

1. **Plugin-Datei herunterladen**
   - Lade die ZIP-Datei des Plugins herunter
   - Entpacke die Datei **nicht** auf deinem Computer

2. **Plugin hochladen**
   - Gehe zu **Plugins** → **Installieren**
   - Klicke auf **Plugin hochladen**
   - Wähle die ZIP-Datei aus
   - Klicke auf **Jetzt installieren**
   - Nach der Installation auf **Plugin aktivieren** klicken

### Option 3: FTP-Upload

1. **Dateien entpacken**
   - Entpacke die Plugin-ZIP-Datei auf deinem Computer
   - Du erhältst einen Ordner namens `mhd-assistent-lite`

2. **FTP-Upload**
   - Verbinde dich per FTP mit deinem Server
   - Navigiere zu `/wp-content/plugins/`
   - Lade den `mhd-assistent-lite` Ordner hoch

3. **Plugin aktivieren**
   - Gehe zu **Plugins** → **Installierte Plugins**
   - Finde "MHD Assistent Lite" und klicke auf **Aktivieren**

##⚙️ Grundkonfiguration

### 1. Darstellung anpassen

1. **Einstellungen öffnen**
   - Gehe zu **WooCommerce** → **MHD Einstellungen**
   - Hier findest du alle Anpassungsmöglichkeiten

2. **Label-Einstellungen**
   - **Beschriftung Farbe**: Wähle die Farbe für "MHD:" (Standard: #333333)
   - **Beschriftung Größe**: Setze die Schriftgröße (10-24px, Standard: 14px)
   - **Beschriftung Schriftschnitt**: Wähle zwischen Normal, Fett oder Leicht

3. **Wert-Einstellungen**
   - **Wert Farbe**: Farbe für das Datum selbst (Standard: #666666)
   - **Wert Größe**: Schriftgröße für das Datum (10-24px, Standard: 14px)
   - **Wert Schriftschnitt**: Schriftgewicht für das Datum

4. **Abstände anpassen**
   - **Abstand oben**: Platz über der MHD-Anzeige (0-50px, Standard: 5px)
   - **Abstand unten**: Platz unter der MHD-Anzeige (0-50px, Standard: 5px)

5. **Live-Vorschau nutzen**
   - Alle Änderungen werden sofort in der Vorschau angezeigt
   - Teste verschiedene Einstellungen, bevor du speicherst

6. **Einstellungen speichern**
   - Klicke auf **Einstellungen speichern**

### 2. MHD für einfache Produkte einrichten

1. **Produkt bearbeiten**
   - Gehe zu **Produkte** → **Alle Produkte**
   - Klicke auf das gewünschte Produkt oder erstelle ein neues

2. **MHD aktivieren**
   - Scrolle zu den **Produktdaten**
   - Finde die Checkbox **MHD aktivieren**
   - Setze den Haken

3. **Datum festlegen**
   - Das Feld **Mindesthaltbarkeitsdatum** erscheint
   - Wähle das entsprechende Datum aus dem Kalender
   - Das Datum wird automatisch im Format TT.MM.JJJJ angezeigt

4. **Produkt speichern**
   - Klicke auf **Aktualisieren** oder **Veröffentlichen**

### 3. MHD für variable Produkte einrichten

1. **Variables Produkt bearbeiten**
   - Öffne ein variables Produkt zur Bearbeitung
   - Gehe zum Tab **Variationen**

2. **Variation erweitern**
   - Klicke auf eine Variation, um sie zu erweitern
   - Scrolle nach unten zu den MHD-Einstellungen

3. **MHD pro Variation**
   - Aktiviere **MHD aktivieren** für diese Variation
   - Setze das **Mindesthaltbarkeitsdatum**
   - Wiederhole dies für alle gewünschten Variationen

4. **Speichern**
   - Klicke auf **Variationen speichern**

## 🎨 Erweiterte Anpassungen

### Shortcode verwenden

**Sollte das MHD nicht angezeigt werden, obwohl es korrekt eingestellt ist:**

Der Shortcode `[mhd_anzeige]` ist die universelle Lösung für alle Darstellungsprobleme!

**So verwendest du den Shortcode:**

1. **Im Theme einbinden**
   ```php
   <?php echo do_shortcode('[mhd_anzeige]'); ?>
   ```

2. **In Page Buildern**
   - Elementor: Füge ein "Shortcode"-Widget hinzu
   - Gutenberg: Nutze den "Shortcode"-Block
   - WPBakery: Verwende das "Raw HTML"-Element
   - Divi: Nutze das "Code"-Modul

3. **In der Produktbeschreibung**
   - Füge `[mhd_anzeige]` direkt in den Editor ein
   - Das MHD wird an dieser Stelle angezeigt

4. **In Widget-Bereichen**
   - Verwende ein "Text"- oder "HTML"-Widget
   - Füge den Shortcode ein

**Vorteile des Shortcodes:**
- ✅ Funktioniert mit jedem Theme
- ✅ Volle Kontrolle über die Position
- ✅ Keine JavaScript-Konflikte
- ✅ 100% kompatibel mit Page Buildern

### Darstellungslogik verstehen

**Bei wenigen Variationen (1-2):**
- Alle MHDs werden direkt angezeigt
- Format: "MHD-Variationsname: Datum"

**Bei vielen Variationen (3+):**
- MHD wird dynamisch basierend auf Kundenauswahl angezeigt
- Platzhaltertext bis zur Auswahl
- Automatisches Update bei Variation-Wechsel

### Positionierung der MHD-Anzeige

Das Plugin platziert die MHD-Anzeige automatisch in dieser Reihenfolge:

1. **Höchste Priorität**: Nach der Produktbeschreibung
2. **Zweite Priorität**: Nach dem Produktpreis  
3. **Fallback**: An anderen geeigneten Stellen

Die Positionierung funktioniert auch mit:
- Elementor-Themes
- Custom WooCommerce-Templates
- Page-Builder-Layouts

**Bei Problemen: Nutze den Shortcode `[mhd_anzeige]`!**

## 🔧 Fehlerbehebung

### MHD wird nicht angezeigt

**Schnellste Lösung: Shortcode verwenden!**

Wenn das MHD trotz korrekter Einstellungen nicht erscheint:

1. **Shortcode einsetzen**
   - Bearbeite deine Produktseiten-Vorlage
   - Füge `[mhd_anzeige]` an der gewünschten Stelle ein
   - Das MHD wird garantiert angezeigt

2. **Alternative Lösungsschritte:**
   - **MHD aktiviert?** Prüfe die Checkbox "MHD aktivieren"
   - **Datum gesetzt?** Stelle sicher, dass ein Datum eingetragen ist
   - **Cache leeren:** Browser- und WordPress-Cache
   - **Theme testen:** Wechsle temporär zu einem Standard-Theme
   - **Plugin-Konflikte:** Deaktiviere andere Plugins zum Test

**Der Shortcode `[mhd_anzeige]` löst 99% aller Anzeigeprobleme!**

### Darstellung stimmt nicht

**Problembehebung:**
1. Gehe zu **WooCommerce** → **MHD Einstellungen**
2. Überprüfe die Darstellungseinstellungen
3. Nutze die Live-Vorschau
4. Speichere die Einstellungen erneut

### JavaScript-Fehler

**Häufige Lösungen:**
1. Andere Plugins temporär deaktivieren
2. Theme auf ein Standard-Theme wechseln
3. Browser-Konsole auf Fehler prüfen
4. WordPress und WooCommerce aktualisieren
5. **Als letztes Mittel:** Shortcode verwenden

## 🚦 Funktionstest

### Testschritte durchführen

1. **Einfaches Produkt testen**
   - Erstelle ein Testprodukt
   - Aktiviere MHD und setze ein Datum
   - Besuche die Produktseite im Frontend
   - Überprüfe die Anzeige
   - Falls nicht sichtbar: Shortcode testen

2. **Variables Produkt testen**
   - Erstelle ein variables Testprodukt mit 2-3 Variationen
   - Setze für jede Variation ein anderes MHD
   - Teste die dynamische Anzeige im Frontend
   - Wechsle zwischen Variationen

3. **Shortcode testen**
   - Füge `[mhd_anzeige]` in die Produktbeschreibung ein
   - Prüfe, ob das MHD an der gewünschten Stelle erscheint
   - Teste in verschiedenen Bereichen (Widget, Page Builder, etc.)

4. **Darstellung testen**
   - Passe die Einstellungen an
   - Überprüfe die Live-Vorschau
   - Teste verschiedene Farben und Größen
   - Speichere und teste im Frontend

## 🔄 Update-Prozess

### Automatische Updates

WordPress benachrichtigt dich über verfügbare Updates:
1. Gehe zu **Dashboard** → **Updates**
2. Finde "MHD Assistent Lite" in der Liste
3. Klicke auf **Aktualisieren**

### Manuelle Updates

1. Deaktiviere das alte Plugin (nicht löschen!)
2. Lade die neue Version hoch
3. Aktiviere das Plugin erneut
4. Alle Einstellungen bleiben erhalten

### Upgrade zur PRO-Version

**Nahtloser Wechsel von Lite zu PRO:**

1. **PRO-Version installieren**
   - Lade die PRO-Version herunter
   - Installiere sie wie ein normales Plugin
   - **Wichtig:** Lösche die Lite-Version NICHT vorher

2. **Automatische Migration**
   - Die PRO-Version erkennt die Lite-Version automatisch
   - Alle Einstellungen werden übernommen
   - Alle MHDs bleiben erhalten
   - Die Lite-Version wird automatisch deaktiviert

3. **Sofort einsatzbereit**
   - Keine Neueinrichtung erforderlich
   - Alle PRO-Features sind sofort verfügbar
   - Bestehende Konfiguration bleibt vollständig erhalten

**Was passiert beim Upgrade:**
- ✅ Alle MHD-Einstellungen bleiben erhalten
- ✅ Alle Produktdaten bleiben unverändert
- ✅ Darstellungseinstellungen werden übernommen
- ✅ Automatische Deaktivierung der Lite-Version
- ✅ Sofortiger Zugriff auf PRO-Features

## 🎯 Beste Praktiken

### Performance-Optimierung

- Das Plugin lädt nur auf Produktseiten mit aktivierten MHDs
- Nutze Caching-Plugins für bessere Performance
- Halte WordPress und WooCommerce aktuell

### SEO-Überlegungen

- MHD-Informationen können das Kundenvertrauen stärken
- Strukturierte Daten werden nicht automatisch hinzugefügt
- Für erweiterte SEO-Features: PRO-Version nutzen

### Rechtliche Hinweise

- Informiere dich über lokale Gesetze zu MHD-Angaben
- Das Plugin ist ein Hilfsmittel - rechtliche Verantwortung liegt beim Shopbetreiber
- Teste die Anzeige vor dem Live-Betrieb

## 📞 Support

### Community-Support
- WordPress.org Plugin-Support-Forum
- Ausführliche Dokumentation in diesem readme

### Premium-Support
- Direkte Hilfe bei Problemen
- Erweiterte Funktionen
- Prioritäts-Support
- Nahtloses Upgrade von Lite zu PRO
- Vollständige Einstellungs-Migration

[Upgrade zur PRO-Version](https://rogerruckstuhl.ch/shop) noch nicht verfügbar, noch in Entwicklung.

## 🔗 Nützliche Links

- [WordPress.org Plugin-Seite](https://wordpress.org/plugins/mhd-assistent-lite/)
- [WooCommerce-Dokumentation](https://woocommerce.com/documentation/)
- [Entwickler-Website](https://rogerruckstuhl.ch)

---

*Diese Anleitung wurde für Version 1.1.0 des MHD Assistent Lite erstellt und enthält spezielle Informationen zum nahtlosen Upgrade zur PRO-Version sowie zur Verwendung des Shortcodes `[mhd_anzeige]` für maximale Kompatibilität.*