WP Merge Fixer – Helferlein

Tab: Attachments

Kernfunktion für Galerien

Der Attachments-Tab ist der technische Kern des WP Merge Fixers.
Er dient zur Analyse und Reparatur von Medien-Einträgen (Attachments) nach einem WordPress-Merge.

Typische Einsatzszenarien:

• Galerien (v. a. gekachelte Galerien) brechen im Editor ab
• Bilder sind vorhanden, aber:
  • nicht editierbar
  • ohne Größen/Thumbnails
  • ohne Vorschau
• _wp_attachment_metadata fehlt oder ist inkonsistent
• Mediathek wirkt „halb kaputt“ nach SQL-Merge

Technischer Hintergrund

Jedes Bild in WordPress besteht aus zwei Ebenen:

1. Datei im Dateisystem wp-content/uploads/...
2. Attachment-Post in der Datenbank wp_posts (post_type = 'attachment') wp_postmeta (_wp_attachment_metadata)

Nach Merges fehlen häufig:

• _wp_attachment_metadata
• Bilddimensionen (width, height)
• generierte Größen (thumbnail, medium, large, …)

Aufgaben des Attachments-Tabs

Der Tab bietet:

1. Analyse (Dry-Run)
2. Gezielte Regeneration fehlender Metadaten
3. Batch-Verarbeitung ohne WP-CLI

Eingabefelder & Parameter

Attachment IDs (optional)

• Kommagetrennte Liste
  Beispiel: 9334,9147,10745
• Wenn leer:
  • Aktion bezieht sich auf ALLE Attachments

Typischer Einsatz:

• gezielte Reparatur einer einzelnen Galerie
• Testlauf vor Massenaktion

Batch Size

• Anzahl Attachments pro Lauf
• Verhindert PHP-Timeouts

Start ID / last_attachment_id

• Ermöglicht fortsetzbare Verarbeitung
• Nach jedem Lauf ausgegeben
• Muss beim nächsten Lauf manuell wieder eingesetzt werden

Dry-Run: Fehlende Metadaten prüfen

Ausgabe

• Anzahl geprüfter Attachments
• Anzahl fehlender Metadaten
• Liste betroffener IDs (begrenzt)

Nur fehlende Metadaten regenerieren

Was passiert?

• Regeneriert ausschließlich Attachments:
  • ohne _wp_attachment_metadata
  • mit existierender Datei im uploads/-Verzeichnis
• Nutzt intern: wp_generate_attachment_metadata() wp_update_attachment_metadata()

Was passiert nicht?

• Keine Dateien werden gelöscht
• Keine bestehenden Metadaten überschrieben
• Keine Post-Inhalte verändert

Typische Anwendungsfälle

Beispiel 1 – Gekachelte Galerie bricht ab

Symptom:

„In diesem Block ist ein Fehler aufgetreten…“

Lösung:

1. Attachments → Dry-Run
2. „Nur fehlende regenerieren“
3. Galerie erneut öffnen / speichern

Beispiel 2 – Bilder nicht editierbar

Symptom:

• „Bild bearbeiten“ fehlt
• nur „löschen“ möglich

Ursache:

• _wp_attachment_metadata fehlt

Lösung:

• Attachments → „nur fehlende regenerieren“

Beispiel 3 – Große Mediathek nach SQL-Merge

Workflow:

1. Dry-Run
2. Batch Size setzen
3. Regeneration starten
4. last_attachment_id übernehmen
5. Wiederholen bis 0 fehlen

Zusammenfassung