WP Merge Fixer – Helferlein

Tab: Featured Images

Titelbilder der Beiträge

Der Featured Images-Tab dient zur Analyse und Reparatur von Beitrags-Vorschaubildern (Post Thumbnails) nach einem WordPress-Merge.

Typische Einsatzszenarien:

• Nach SQL-Merges mit ID-Offsets
• Nach Export/Import mehrerer Blogs
• Wenn Beiträge plötzlich kein Titelbild mehr anzeigen
• Wenn _thumbnail_id zwar existiert, aber ins Leere zeigt

Technischer Hintergrund

WordPress speichert das Featured Image eines Beitrags in der Tabelle:

wp_postmeta
meta_key = '_thumbnail_id'
meta_value = <attachment_id>

Nach einem Merge können folgende Fehler auftreten:

Der Featured Images-Tab setzt gezielt an dieser Stelle an.

Funktionsprinzip

Der Tab arbeitet in zwei Stufen:

1. Dry-Run (Analyse)
   → Es werden keine Änderungen vorgenommen
2. Reparatur-Lauf
   → Korrigiert ausschließlich die erkannten Problemfälle

Typische SQL-Logik (vereinfacht)

SELECT p.ID, pm.meta_value AS thumbnail_id
FROM wp_posts p
JOIN wp_postmeta pm
  ON pm.post_id = p.ID
 AND pm.meta_key = '_thumbnail_id'
LEFT JOIN wp_posts a
  ON a.ID = pm.meta_value
WHERE p.post_type = 'post'
  AND a.ID IS NULL;

Ergebnis des Dry-Runs

• Anzahl geprüfter Beiträge
• Anzahl ungültiger Featured Images
• Liste der betroffenen Post-IDs (begrenzt)

Reparatur: Featured Images fixen

Was passiert?

Je nach Plugin-Konfiguration:

• ungültige _thumbnail_id werden:
  • entfernt oder
  • (bei bekannten Offsets) korrekt neu gesetzt
• Beiträge bekommen wieder:
  • ein korrektes Featured Image oder
  • einen sauberen Zustand ohne defekte Referenz

Zusammenspiel mit Attachments-Tab

Wichtig:
Der Featured Images-Tab setzt existierende Attachments voraus.

Wenn nach dem Fix:

• das Featured Image im Backend erscheint
• aber im Frontend nicht rendert

Attachments-Tab → „nur fehlende Metadaten regenerieren“ ausführen.

Typische Workflows

Szenario 1 – Nach SQL-Merge mit Offset

1. Featured Images → Dry-Run
2. Prüfen, wie viele _thumbnail_id ungültig sind
3. Reparatur ausführen
4. Attachments → Metadaten regenerieren

Szenario 2 – Nur einzelne Beiträge betroffen

1. Featured Images → Dry-Run
2. Betroffene Post-IDs identifizieren
3. Reparatur ausführen
4. Beiträge visuell prüfen

Sicherheit & Hinweise

• Änderungen wirken sofort
• Kein Undo / kein Rollback
• Immer vorher:
  • Datenbank-Backup
  • ggf. Medien-Backup

Zusammenfassung