Verwendungsscan

Der Verwendungsscan erstellt einen lokalen Index für Bildreferenzen, die FG Media Audit zuverlässig erkennen kann. Er wird ausschließlich manuell im WordPress-Backend gestartet.

Warum gibt es einen eigenen Scan?

WordPress speichert Bildverwendungen nicht an einer einzigen zentralen Stelle. Ein Bild kann beispielsweise als Beitragsbild, Gutenberg-Block, klassische HTML-Referenz oder ACF-Wert eingebunden sein.

FG Media Audit fasst erkannte Verwendungen in der Tabelle {prefix}fg_media_audit_usage zusammen. Die eigentlichen Attachment-Metadaten werden dort nicht dupliziert.

Ablauf

1. Im Tab Audit auf Verwendung scannen klicken.
2. Das Plugin erzeugt eine neue scan_id.
3. Beiträge werden in Batches mit jeweils 75 Datensätzen verarbeitet.
4. Währenddessen bleibt der vorherige vollständig abgeschlossene Index aktiv.
5. Erst nach erfolgreichem Abschluss ersetzt der neue Scan den bisherigen Index.

Damit wird ein halbfertiger Scan nicht als vollständige Grundlage für die Audit-Anzeige oder Dateiumbenennung verwendet.

Gescannt werden

Der Code ermittelt Post Types, die entweder show_ui => true oder public => true verwenden. Ausgeschlossen sind:

• attachment
• revision
• nav_menu_item
• custom_css
• customize_changeset
• oembed_cache
• user_request

Beiträge im Papierkorb und Auto-Drafts werden nicht gescannt.

Erkannte WordPress-Quellen

FG Media Audit erkennt unter anderem:

• Beitragsbilder über _thumbnail_id
• klassische wp-image-{ID}-Referenzen
• data-attachment-id
• Gallery-Shortcodes mit ids
• auflösbare <img>-URLs aus src und srcset
• Core/Gutenberg-Blöcke core/image
• core/cover
• core/gallery
• core/media-text

Bei Bild-URLs versucht das Plugin zusätzlich, WordPress-Suffixe wie Größenangaben oder -scaled auf die ursprüngliche Attachment-URL zurückzuführen.

Erkannte ACF-Quellen

ACF wird nur berücksichtigt, wenn acf_get_field() verfügbar ist. Unterstützt werden im aktuellen Code:

• ACF Image
• ACF Gallery
• ACF WYSIWYG

Die Erkennung basiert auf ACF-Feldreferenzen im Post Meta und den Feldtypen image, gallery und wysiwyg.

Was bedeutet „Keine erkannte Verwendung“?

Die Aussage bedeutet ausschließlich, dass im zuletzt vollständig abgeschlossenen Scan keine unterstützte Referenz gefunden wurde.

Nicht vollständig abgedeckt sind beispielsweise:

• Fremdtabellen
• WordPress-Optionen und Theme-Optionen
• CSS-Dateien oder CSS-Werte
• JavaScript
• externe Systeme
• hart codierte URLs außerhalb der unterstützten Inhaltsquellen

Deshalb ist „Keine erkannte Verwendung“ keine Garantie dafür, dass eine Datei technisch unbenutzt ist.

Bedeutung für Dateiumbenennungen

Ein abgeschlossener Scan ist Voraussetzung für Dateiumbenennungen. Nur unterstützte direkte URL-Referenzen aus post_content und ACF-WYSIWYG können dabei automatisch aktualisiert werden.