wp-md-rest-import/DOCUMENTATION-DE.md

Markdown Parser WP - Dokumentation der Aktualisierungen

Übersicht der Verbesserungen

Diese Aktualisierung des Markdown Parser WP Plugins enthält folgende Verbesserungen:

1. Korrekte Behandlung relativer Bildpfade im Fließtext
2. Import von Bildern aus dem Fließtext in die WordPress-Mediathek
3. Konfigurierbare Feldzuordnung zwischen YAML/JSON und WordPress-Feldern

1. Relative Bildpfade im Fließtext

Problem

Bilder im Fließtext mit relativen Pfaden (z.B. ![Alt Text](bild.jpg)) wurden nicht korrekt aufgelöst und importiert.

Lösung

Das Plugin löst jetzt relative Bildpfade korrekt auf, indem es den Pfad der Markdown-Datei als Basis verwendet. Beispiel:

• Markdown-URL: https://example.com/posts/artikel/index.md
• Relatives Bild im Text: ![Alt Text](bild.jpg)
• Aufgelöster Bildpfad: https://example.com/posts/artikel/bild.jpg

Implementierung

Die BlocksConverter-Klasse wurde aktualisiert, um relative Pfade zu erkennen und aufzulösen:

private static function process_images_in_html($html, $original_url = '') {
    // ...
    foreach ($images as $img) {
        $src = $img->getAttribute('src');
        
        // Handle relative URLs
        if (!filter_var($src, FILTER_VALIDATE_URL) && !empty($original_url)) {
            // If the src doesn't start with http/https, it's likely a relative path
            if (strpos($src, 'http') !== 0) {
                $base_url = dirname($original_url) . '/';
                $src = $base_url . ltrim($src, '/');
            }
        }
        
        // Import external image
        $attachment_id = PostCreator::import_external_image($src);
        // ...
    }
    // ...
}

2. Import von Bildern aus dem Fließtext

Problem

Bilder im Fließtext wurden nicht in die WordPress-Mediathek importiert und als Gutenberg-Blöcke mit korrekten Attachment-IDs dargestellt.

Lösung

Das Plugin importiert jetzt alle Bilder aus dem Fließtext in die WordPress-Mediathek und erstellt korrekte Gutenberg-Bild-Blöcke mit den entsprechenden Attachment-IDs.

Implementierung

Die BlocksConverter-Klasse wurde verbessert, um Bilder zu importieren und korrekte Gutenberg-Blöcke zu erstellen:

private static function create_image_block($src, $alt = '', $attachment_id = '') {
    $block_attrs = [
        'url' => $src,
        'alt' => $alt
    ];
    
    if ($attachment_id) {
        $block_attrs['id'] = (int) $attachment_id;
        
        // Get image dimensions if available
        $image_meta = wp_get_attachment_metadata($attachment_id);
        if ($image_meta && isset($image_meta['width']) && isset($image_meta['height'])) {
            $block_attrs['width'] = $image_meta['width'];
            $block_attrs['height'] = $image_meta['height'];
            $block_attrs['sizeSlug'] = 'full';
        }
        
        // Get caption if available
        $attachment = get_post($attachment_id);
        if ($attachment && !empty($attachment->post_excerpt)) {
            $block_attrs['caption'] = $attachment->post_excerpt;
        }
    }
    
    // Create the image block with proper figure and figcaption if needed
    $figure_html = '<figure class="wp-block-image';
    
    // Add size class if available
    if (isset($block_attrs['sizeSlug'])) {
        $figure_html .= ' size-' . $block_attrs['sizeSlug'];
    }
    
    $figure_html .= '">';
    
    // Add image tag
    $figure_html .= '<img src="' . esc_url($src) . '" alt="' . esc_attr($alt) . '"';
    
    // Add width and height if available
    if (isset($block_attrs['width']) && isset($block_attrs['height'])) {
        $figure_html .= ' width="' . esc_attr($block_attrs['width']) . '"';
        $figure_html .= ' height="' . esc_attr($block_attrs['height']) . '"';
    }
    
    // Add class and close img tag
    $figure_html .= ' class="wp-image-' . esc_attr($attachment_id) . '"/>';
    
    // Add caption if available
    if (isset($block_attrs['caption'])) {
        $figure_html .= '<figcaption>' . esc_html($block_attrs['caption']) . '</figcaption>';
    }
    
    $figure_html .= '</figure>';
    
    return '<!-- wp:image ' . json_encode($block_attrs) . ' -->' . 
           $figure_html . 
           '<!-- /wp:image -->';
}

3. Konfigurierbare Feldzuordnung

Problem

Die Zuordnung zwischen YAML/JSON-Feldern und WordPress-Feldern war fest codiert und konnte nicht angepasst werden.

Lösung

Das Plugin bietet jetzt eine benutzerfreundliche Oberfläche, mit der Sie die Zuordnung zwischen YAML/JSON-Feldern und WordPress-Feldern konfigurieren können. Sie können sehen, welche Felder in der Markdown-Datei verfügbar sind und wie sie auf WordPress-Felder abgebildet werden.

Implementierung

Eine neue Benutzeroberfläche wurde hinzugefügt, die Folgendes ermöglicht:

• Anzeige aller verfügbaren YAML/JSON-Felder
• Konfiguration der Zuordnung zu WordPress-Feldern
• Vorschau der Feldwerte vor dem Import
• Hinzufügen und Entfernen von Feldzuordnungen

Verwendung der neuen Funktionen

Relative Bildpfade und Bildimport

Die Funktionen für relative Bildpfade und Bildimport sind automatisch aktiviert. Sie können den Bildimport über die Option "Bilder importieren" in der Benutzeroberfläche aktivieren oder deaktivieren.

Konfigurierbare Feldzuordnung

1. Gehen Sie zu "Markdown Parser" im WordPress-Admin-Menü
2. Geben Sie die URL zu einer Markdown-Datei ein und klicken Sie auf "Markdown parsen"
3. Scrollen Sie zum Abschnitt "Feldzuordnung"
4. Hier sehen Sie die Standard-Feldzuordnungen:
   • WordPress-Feld "Titel" → YAML-Feld "title" oder "name"
   • WordPress-Feld "Auszug" → YAML-Feld "summary" oder "description"
   • WordPress-Feld "Datum" → YAML-Feld "datePublished"
   • WordPress-Feld "Slug" → YAML-Feld "url"
   • WordPress-Feld "Schlagwörter" → YAML-Feld "keywords"
5. Sie können diese Zuordnungen ändern, indem Sie andere YAML-Felder aus den Dropdown-Menüs auswählen
6. Sie können weitere Feldzuordnungen hinzufügen, indem Sie auf "Weitere Feldzuordnung hinzufügen" klicken
7. Für jede Feldzuordnung wird eine Vorschau des Wertes angezeigt
8. Wenn Sie mit den Zuordnungen zufrieden sind, klicken Sie auf "Beitrag erstellen"

Technische Details

Dateistruktur

• src/BlocksConverter.php: Enthält die Logik für die Konvertierung von Markdown zu Gutenberg-Blöcken und die Behandlung relativer Bildpfade
• src/PostCreator.php: Enthält die Logik für die Erstellung von WordPress-Beiträgen aus Markdown-Daten
• src/Admin.php: Enthält die Benutzeroberfläche und AJAX-Handler für die Feldzuordnung
• assets/js/admin.js: Enthält den JavaScript-Code für die dynamische Feldzuordnungs-UI
• assets/css/admin.css: Enthält die Styles für die Feldzuordnungs-UI

Hooks und Filter

Das Plugin bietet folgende Hooks und Filter für Entwickler:

• markdown_parser_wp_field_mapping: Filter zum Anpassen der Standard-Feldzuordnungen
• markdown_parser_wp_before_import_image: Action vor dem Import eines Bildes
• markdown_parser_wp_after_import_image: Action nach dem Import eines Bildes
• markdown_parser_wp_blocks_converter_options: Filter zum Anpassen der Optionen für die Konvertierung von Markdown zu Blocks