Matthias Altmann
Systemberater

Blocktypen in Gutenberg Inhalten erkennen

MA Block Detector
MA Block Detector
Aktuelle Version: 2.0.0 (18. Mai 2026)

Einführung

Bei der Erstellung und Pflege Inhalten in Gutenberg werden oft Gutenberg Blöcke von Drittanbietern eingesetzt.
Sollen solche Blöcke irgendwann durch Lösungen von anderen Anbietern ersetzt werden, ist es meist recht aufwändig herauszufinden, auf welchen Seiten und in welchen Beiträgen diese Blöcke verwendet werden.

Lösung

MA Block Detector ermöglicht eine schnelle Suche nach Vorkommen bestimmter Blöcke.
Nach der Auswahl, welche Inhaltstypen durchsucht, und welche Blocktypen erkannt werden sollen, scant MA Block Detector diese Inhalte und gibt die Fundstellen aus. Per Klick gelangt man direkt auf die Bearbeitungsseite des jeweiligen Inhalts.

Die Prüfung

Der Aufruf erfolgt über Werkzeuge > MA Block Detector in der deutschen Oberfläche, bzw. Tools > MA Block Detector in der englischen Oberfläche.

Unterstützte Inhaltstypen

MA Block Detector erkennt prüfbare Inhaltstypen nach folgenden Kriterien:

  • Ist kein ausgeschlossener Inhaltstyp
    WordPress selbst registriert einige Inhaltstypen wie „oEmbed Response“ (oembed_cache) und „Global Styles“ (wp_global_styles), die definitiv keine Blöcke enthalten können. Diese müssen nicht überprüft werden.
  • Inhalte (egal welcher Status) existieren
    Wenn keine Inhalte dieses Inhaltstype existieren, ist keine Prüfung erforderlich.
  • Inhaltstyp unterstützt den Gutenberg Editor
    Inhalte, die gemäß Registrierung den Gutenberg Editor nicht unterstützen, müssen nicht geprüft werden.

Benutzerdefinierte Inhaltstypen (Custom Post Types) werden ausdrücklich unterstützt, sofern sie ordnungsgemäß registriert sind und den oben genannten Kriterien entsprechen.

Unterstützte Status

MA Block Detector unterstützt die Standard WordPress Status „Entwurf“, „Ausstehende Überprüfung“, „Privat“und „Veröffentlicht“.
Daneben werden auch Status erkannt, die möglicherweise durch Drittanbieter-Lösungen hinzugefügt wurden und ordnungsgemäß in WordPress registriert sind.

Unterstützte Blocktypen

MA Block Detector erlaubt neben der Suche nach Standard WordPress Blocktypen auch die gezielte Suche nach Blocktypen von Drittanbietern. Da Drittanbieter in ihren Plugins oft zahlreiche Blöcke registrieren, beschränkt sich die Auswahlmöglichkeit auf die Kennung der Drittanbieter.

Die Anzahl der registrierten Blocktypen wird jeweils in Klammern angezeigt.

Einige Drittanbieter registrieren Blocktypen dynamisch zur Laufzeit, falls in Gutenberg verwendet. Diese fasst MA Block Detector in der Rubrik „unknown / unregistered“ zusammen.

MA Block Detector - Vendor Selection

Prüfung ausführen

Die Prüfung selbst wird in einer Stapelverarbeitung (Gruppen von mehreren Posts) ausgeführt.
Die Größe der Stapel kann über das Eingabefeld „Bulk size“ festgelegt werden.
Der Button „Scan“ Startet die Überprüfung.

MA Block Detector - Bulk size and Scan

Anzeige der Ergebnisse

Nach der Prüfung aller Inhalte wird das Ergebnis angezeigt.

Die Liste enthält den Titel des Inhalts, den Inhaltstyp, die ID, und die gefundenen Blöcke inklusive der Anzahl.

Ein Klick auf den Titel des Inhaltes führt direkt zur Bearbeitungsseite.

MA Block Detector - Results

Software Installation und Aktualisierung

Installation

Die Installation der Software kann mit unterschiedlichen Verfahren erfolgen:

Plugin:
Die Software steht als Plugin (ZIP Archiv) zur Verfügung und kann in WordPress als Plugin installiert werden.

Code Snippet:
Die Software ist als Code Snippet lauffähig.
Für die Plugins „Code Snippets“ und „Advanced Scripts“ wird eine JSON Datei zum Download angeboten, die dort direkt importiert werden kann.

PHP:
Die Software kann als PHP Datei herunter geladen werden.
Diese PHP Datei kann in anderen Code Snippet Plugins verwendet werden (den Code per Copy & Paste einfügen), oder in ein eigenes WordPress Child Theme eingebunden werden (require_once('path/to/the.php');).

Aktualisierung

Die Software prüft selbständig, ob Aktualisierungen verfügbar sind:

Plugin:
Die Aktualisierung folgt den bekannten WordPress Methoden: Alle 12 Stunden wird geprüft, ob eine neue Version verfügbar ist.
Das Update kann dann manuell, oder auch automatisch erfolgen.

MA Software Plugin Update Notice

Code Snippet & PHP:
Die Software implementiert eine spezielle Methode, die auch bei der Installation als Snippet oder PHP Include eine Prüfung auf Aktualisierungen durchführt. Das Prüfintervall ist, wie bei Plugins, auf 12 Stunden festgelegt.
Steht eine neuere Version zur Verfügung, wird dies im Admin Bereich als Hinweis eingeblendet:

MA Software Update Admin Notice

Download

Version 2.0.0 (18. Mai 2026)
Verfügbare Downloads
Installation als WordPress-Plugin
Import in das Plugin "Code Snippets"
PHP für andere Snippet-Plugins oder zur Verwendung als Include

Spenden ❤️

Es macht mir viel Freude, Software zu entwickeln und damit typische Anforderungen zu lösen.
Die Software stelle ich kostenfrei zur Nutzung zur Verfügung.
Wenn Du möchtest, kannst Du meine vielen Stunden Arbeit mit einer kleinen Kaffee-Spende über PayPal honorieren.

Bei Klick auf den Button wird eine Verbindung zu PayPal aufgebaut.

Spenden werden selbstverständlich ordnungsgemäß durch mich versteuert.

Disclaimer

Diese Software habe ich nach bestem Wissen und Gewissen entwickelt und getestet.
Ich stelle die Software kostenfrei zur Nutzung zur Verfügung.
Eine Garantie für die Funktionalität in allen denkbaren WordPress Umgebungen kann ich nicht geben. 
Download und Nutzung dieser Software erfolgen auf eigene Gefahr und Verantwortung.

Change Log

  • Version 2.0.0
    Verfügbare Downloads
    18. Mai 2026
    Erfordert mindestens WordPress: 5.8
    Getestet bis WordPress: 6.9.4
    Erfordert PHP: 7.4

    New Features:

    • Now available as Code Snippet, Include, and Plugin with automatic update check.
      For snippet or include, checks for updates every 12 hrs (same frequency used by WP for plugin updates),
      and shows update notice in admin area, dismissible for 12 hrs. Can also be checked manually on the Settings page.
      For plugin, WordPress standard update mechanism is used.
    • Improved detection of scan-worthy post types by selection all and filtering all with no posts, no editor support,
      or included in the list of non-block content like oembed_cache, wp_global_styles, etc.

    Changes:

    • Renamed from "MA BlockFinder" to "MA Block Detector"
    • Reorganized HTML structure of tools page
    • Scan results now show post type and ID
  • Version 1.5

    Download nicht verfügbar.
    13. Februar 2026
    Erfordert mindestens WordPress: 5.3
    Getestet bis WordPress: 6.9.1
    Erfordert PHP: 7.4

    Changes:

    • Initial page: Post count now contains publish, draft, pending and private posts.

    Implemented scan_post_regex to compare speed parse_blocks vs. regex. Made no difference.

  • Version 1.4

    Download nicht verfügbar.
    11. Oktober 2025

    Changes:

    • Added detection of Bricks block components
  • Version 1.3

    Download nicht verfügbar.
    11. Juli 2025

    Changes:

    • Fixed "file not found" bug in ajax_scan() when trying to get plugin name from plugin file
  • Version 1.2

    Download nicht verfügbar.
    23. Juni 2025

    Changes:

    • Adapted version number to support deploy.php version detection
    • Added class constants for title, slug, code and version
    • Added Script Details method
    • Added statistics for runtime and scanned posts
    • Added block type labels filter
  • Version 1.1

    Download nicht verfügbar.
    3. Mai 2025

    UI improvements, added block vendor filter

  • Version 1.0

    Download nicht verfügbar.
    18. Dezember 2023

    Initial version

Download

Source Code