Shortcode

Plugin-Wechsel geplant?

Wir suchen vorher heraus, wo überall Shortcodes des alten Plugins stecken — damit nach der Umstellung keine eckigen Klammern im Text stehen.

Ein Shortcode ist ein Platzhalter in eckigen Klammern, den WordPress beim Ausliefern einer Seite durch dynamisch erzeugten Inhalt ersetzt — etwa [kontaktformular] oder [galerie id="5"]. Er erlaubt es, Funktionen in Beiträge und Seiten einzubauen, ohne Programmcode in den Inhalt zu schreiben. Seit der Einführung des Blockeditors ist er kein Mittel der ersten Wahl mehr, aber weiterhin überall im Einsatz.

Kurz zusammengefasst:

• Platzhalter in eckigen Klammern, wird beim Ausliefern ersetzt.
• Kommt fast immer aus einem Plugin oder dem Theme.
• Bindet an die Quelle: Wird das Plugin deaktiviert, steht der Code als Text auf der Seite.
• Für neue Projekte sind Blöcke die bessere Wahl.
• Funktioniert nicht überall — Widgets und Vorlagendateien brauchen einen Zusatzschritt.

Wie er funktioniert

Ein Plugin meldet bei WordPress an, dass es für ein bestimmtes Stichwort zuständig ist. Findet WordPress dieses Stichwort in eckigen Klammern im Inhalt, ruft es die zugehörige Funktion auf und setzt deren Rückgabe an die Stelle.

Shortcodes können Attribute tragen, mit denen sich das Verhalten steuern lässt — etwa eine Anzahl, eine Kennung oder eine Darstellungsvariante. Manche umschließen zusätzlich Inhalt, der dann mit verarbeitet wird.

Der wunde Punkt

Ein Shortcode ist nur so lange etwas wert, wie der Code existiert, der ihn kennt. Wird das Plugin deaktiviert oder entfernt, verschwindet die Funktion — und übrig bleibt der Platzhalter als sichtbarer Text mitten im Beitrag.

Das ist der Hauptgrund, warum Shortcodes als problematisch gelten: Sie erzeugen eine harte Bindung zwischen Inhalt und Erweiterung. Bei einem Plugin-Wechsel oder einem Relaunch müssen alle betroffenen Beiträge einzeln angefasst werden.

Blöcke haben dasselbe Problem in abgeschwächter Form — sie hinterlassen bei fehlendem Plugin wenigstens keinen Klartext im Seitentext, sondern eine Fehlermeldung im Editor.

Shortcode oder Block?

Für neue Projekte spricht alles für Blöcke. Bestehende Shortcodes deshalb auszutauschen, lohnt sich aber selten — solange das Plugin gepflegt wird, funktionieren sie zuverlässig. Sinnvoll ist die Umstellung im Rahmen eines ohnehin geplanten Relaunches.

Praktische Hinweise

• Nicht überall aktiv. In manchen Bereichen — etwa Text-Widgets oder Theme-Vorlagen — werden Shortcodes nicht automatisch verarbeitet; dort braucht es einen Zusatzschritt.
• Nicht verschachteln, sofern das Plugin es nicht ausdrücklich vorsieht. Das Ergebnis ist sonst schwer vorhersagbar.
• Anführungszeichen prüfen. Typografische Anführungszeichen aus einem Textprogramm brechen Attribute — ein häufiger und schwer zu findender Fehler.
• Vor dem Deaktivieren suchen. Bevor ein Plugin entfernt wird, sollte der Bestand nach seinen Shortcodes durchsucht werden.
• Bei Seitenbaukästen aufpassen: Wer viele Inhalte in Shortcodes eines Baukastens hält, macht einen späteren Wechsel sehr aufwendig.

Häufige Fragen

Was passiert, wenn ich das Plugin deaktiviere?

Der Shortcode wird nicht mehr ersetzt und erscheint als Text in eckigen Klammern auf der Seite. Vor dem Deaktivieren sollte deshalb geprüft werden, wo er überall verwendet wird.

Sind Shortcodes veraltet?

Nicht veraltet, aber nicht mehr erste Wahl. Für neue Funktionen sind Blöcke besser, weil sie eine Vorschau bieten und sich über die Oberfläche einstellen lassen. Bestehende Shortcodes funktionieren weiter.

Warum wird mein Shortcode als Text angezeigt?

Entweder ist das zuständige Plugin nicht aktiv, oder er steht an einer Stelle, an der WordPress Shortcodes nicht verarbeitet — etwa in bestimmten Widgets. Auch typografische Anführungszeichen in den Attributen können die Ursache sein.

Kann ich Shortcodes selbst erstellen?

Ja, mit wenigen Zeilen PHP. Der Code gehört allerdings nicht in die Theme-Datei, sondern in ein eigenes kleines Plugin — sonst verschwindet die Funktion beim nächsten Theme-Wechsel.

Wie finde ich alle verwendeten Shortcodes?

Über eine Suche im Beitragsbestand nach dem jeweiligen Stichwort. Bei größeren Websites ist eine Datenbankabfrage der schnellere Weg, weil die Bordsuche nicht alle Inhaltsfelder erfasst.

Funktionieren Shortcodes im Blockeditor?

Ja, es gibt einen eigenen Shortcode-Block. Eine Vorschau des Ergebnisses bietet er nicht — sichtbar wird es erst im Frontend.