wordpress-plugin manus v1

README-ENHANCED.md

@@ -0,0 +1,115 @@
+# Markdown Parser WP - Erweiterte Version
+
+## Übersicht
+
+Markdown Parser WP ist ein WordPress-Plugin, das YAML-Metadaten aus Markdown-Dateien extrahiert und in JSON konvertiert. Die erweiterte Version kann nun auch WordPress-Beiträge direkt aus Markdown-Dateien erstellen, wobei die YAML-Metadaten als Beitragsfelder (Titel, Auszug, Tags, Bild, Autor, etc.) verwendet werden und der Markdown-Inhalt in Gutenberg-Blöcke konvertiert wird.
+
+## Neue Funktionen
+
+Die erweiterte Version bietet folgende neue Funktionen:
+
+1. **Automatische Beitragserstellung**: Erstellen Sie WordPress-Beiträge direkt aus Markdown-Dateien mit YAML-Frontmatter
+2. **Metadaten-Mapping**: YAML-Metadaten werden automatisch in WordPress-Beitragsfelder konvertiert:
+   - Titel (aus `title` oder `name`)
+   - Auszug (aus `summary` oder `description`)
+   - Veröffentlichungsdatum (aus `datePublished`)
+   - Slug/Permalink (aus `url`)
+   - Autor (wenn ein passender WordPress-Benutzer gefunden wird)
+3. **Taxonomie-Mapping**: Tags werden automatisch aus `keywords` erstellt
+4. **Gutenberg-Blöcke**: Markdown-Inhalt wird in native Gutenberg-Blöcke konvertiert:
+   - Überschriften
+   - Absätze
+   - Listen
+   - Bilder
+   - Zitate
+   - Code-Blöcke
+   - Tabellen
+5. **Bild-Import**: Bilder werden automatisch in die WordPress-Mediathek importiert
+6. **Beitragsbild**: Das Beitragsbild wird automatisch aus `image` oder `cover.image` gesetzt
+
+## Installation
+
+1. Laden Sie die Zip-Datei `markdown-parser-wp-enhanced.zip` herunter
+2. Loggen Sie sich in Ihren WordPress-Admin-Bereich ein
+3. Navigieren Sie zu "Plugins" > "Installieren"
+4. Klicken Sie auf "Plugin hochladen"
+5. Wählen Sie die heruntergeladene Zip-Datei aus und klicken Sie auf "Jetzt installieren"
+6. Nach der Installation klicken Sie auf "Plugin aktivieren"
+
+## Verwendung
+
+### Beiträge aus Markdown erstellen
+
+1. Nach der Aktivierung finden Sie im WordPress-Admin-Menü einen neuen Eintrag "Markdown Parser"
+2. Klicken Sie auf diesen Menüpunkt, um die Plugin-Oberfläche zu öffnen
+3. Geben Sie die URL zu einer Markdown-Datei mit YAML-Frontmatter ein
+4. Klicken Sie auf "Markdown parsen"
+5. Die extrahierten JSON-Metadaten und der Markdown-Inhalt werden angezeigt
+6. Im Abschnitt "WordPress-Beitrag erstellen" können Sie folgende Optionen wählen:
+   - Beitragstyp (Beitrag, Seite, etc.)
+   - Status (Entwurf, Veröffentlicht, Ausstehender Review)
+   - Kategorie
+   - Bilder importieren (ja/nein)
+7. Klicken Sie auf "Beitrag erstellen", um den Beitrag zu erstellen
+8. Nach erfolgreicher Erstellung wird ein Link zum Bearbeiten des Beitrags angezeigt
+
+### Metadaten-Mapping
+
+Das Plugin mappt YAML-Metadaten wie folgt auf WordPress-Beitragsfelder:
+
+| YAML-Feld | WordPress-Feld |
+|-----------|----------------|
+| title / name | post_title |
+| summary / description | post_excerpt |
+| datePublished | post_date |
+| url | post_name (Slug) |
+| keywords | Tags |
+| image / cover.image | Beitragsbild |
+| author / creator | Autor (wenn passender Benutzer gefunden wird) |
+
+Zusätzlich werden alle Metadaten als benutzerdefinierte Felder gespeichert, z.B.:
+- `_markdown_parser_license`
+- `_markdown_parser_original_id`
+- `_markdown_parser_status`
+- `_markdown_parser_type`
+- `_markdown_parser_language`
+- `_markdown_parser_date_published`
+- `_markdown_parser_authors`
+
+### Markdown zu Gutenberg-Blöcken
+
+Das Plugin konvertiert Markdown-Elemente in entsprechende Gutenberg-Blöcke:
+
+- Überschriften (`# Titel`) → Überschriften-Block
+- Absätze → Absatz-Block
+- Listen (`- Element`) → Listen-Block
+- Bilder (`![alt](url)`) → Bild-Block
+- Links (`[text](url)`) → Links im Absatz-Block
+- Zitate (`> Zitat`) → Zitat-Block
+- Code-Blöcke (``` code ```) → Code-Block
+- Tabellen → Tabellen-Block
+
+## Systemanforderungen
+
+- WordPress 5.0 oder höher
+- PHP 7.2 oder höher
+- PHP YAML-Erweiterung
+- PHP Parsedown-Bibliothek (wird automatisch installiert)
+
+## Fehlerbehebung
+
+Wenn das Plugin nicht korrekt funktioniert, überprüfen Sie Folgendes:
+
+1. Stellen Sie sicher, dass die URL zu einer gültigen Markdown-Datei mit YAML-Frontmatter führt
+2. Überprüfen Sie, ob die YAML-Syntax in der Markdown-Datei korrekt ist
+3. Stellen Sie sicher, dass Ihr Server auf externe URLs zugreifen kann
+4. Überprüfen Sie, ob die Berechtigungen zum Erstellen von Beiträgen vorhanden sind
+5. Stellen Sie sicher, dass der Upload-Ordner beschreibbar ist (für Bild-Imports)
+
+## Support
+
+Bei Fragen oder Problemen wenden Sie sich bitte an den Plugin-Autor.
+
+---
+
+Dieses Plugin wurde basierend auf dem bereitgestellten PHP-Code erstellt, der die Symfony YAML-Komponente verwendet.