115 lines
4.5 KiB
Markdown
115 lines
4.5 KiB
Markdown
# 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 (``) → 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.
|