Comenius-Institut/wp-md-rest-import
11
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
wp-md-rest-import/README-ENHANCED.md

4.5 KiB
Raw Permalink Blame History

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.