Shortcode
Was ist ein Shortcode?
Ein Shortcode ist ein kompakter Platzhalter, mit dem ein Content-Management-System vordefinierte Funktionen oder dynamische Inhalte in eine Seite einfügt. Beim Aufruf ersetzt das System den Shortcode durch den erzeugten HTML-Code. Typische Anwendungen sind Formulare, Galerien, Produktlisten, Tabellen oder interaktive Elemente.
Ein Shortcode, auf Deutsch Kurzcode, verbindet redaktionelle Inhalte mit programmierten Funktionen, ohne dass du den vollständigen HTML- oder PHP-Code in den Editor schreiben musst.
Wie funktioniert ein Shortcode?
Ein Shortcode besteht gewöhnlich aus einem Namen, optionalen Attributen und manchmal einem umschlossenen Inhalt. Ein einfaches Beispiel ist [kontaktformular]. Eine Variante mit Attributen könnte [produktliste kategorie='schuhe' limit='6'] lauten. Die Attribute bestimmen in diesem Beispiel, welche Produkte ausgegeben werden und wie viele Einträge erscheinen.
Das CMS sucht beim Verarbeiten des Seiteninhalts nach registrierten Shortcodes. Zu jedem registrierten Namen gehört eine Funktion, die Attribute auswertet, Daten abruft und eine Ausgabe erzeugt. Der Browser erhält normalerweise nicht den ursprünglichen Platzhalter, sondern das daraus generierte HTML.
Shortcodes in WordPress
WordPress verarbeitet Shortcodes über registrierte Funktionen. Plugins und Themes können eigene Befehle bereitstellen, beispielsweise für Formulare, Karten, Slider oder Produktübersichten. Erkennt WordPress einen Shortcode nicht, bleibt der Ausdruck häufig als normaler Text im Inhalt sichtbar.
Ein häufiger Denkfehler besteht darin, einen Shortcode mit einer eigenständigen Funktion gleichzusetzen. Der Platzhalter enthält die eigentliche Funktion nicht. Er ruft lediglich den PHP-Code eines Plugins, Themes oder einer individuellen Erweiterung auf. Wird diese Erweiterung deaktiviert, kann WordPress die Ausgabe nicht mehr erzeugen.
Shortcodes in CMS und Shopsystemen
Auch andere CMS und Shopsysteme verwenden Platzhalter, Makros, Template-Tags oder vergleichbare Einbettungsmechanismen. Die genaue Syntax ist systemspezifisch. Ein Shortcode aus WordPress lässt sich deshalb nicht automatisch in Shopware, TYPO3, Shopify oder einem anderen System verwenden.
In Onlineshops können vergleichbare Platzhalter Produktlisten, Filter, Varianten, Preise oder Aktionsflächen ausgeben. Vor einem Systemwechsel muss geprüft werden, welche Inhalte solche Befehle enthalten und wie die entsprechende Funktion im neuen System umgesetzt wird. Diese Prüfung gehört in die technische Planung eines SEO-sicheren Website-Relaunchs.
Shortcode und Block im Vergleich
Der Unterschied zwischen Shortcode und Block liegt vor allem in der Bearbeitung. Ein Shortcode ist eine textbasierte Anweisung, deren Ergebnis im Editor teilweise erst nach einer Vorschau sichtbar wird. Ein Block stellt Inhalt und Einstellungen meist direkt in einer grafischen Oberfläche dar.
| Merkmal | Shortcode | Block |
|---|---|---|
| Bearbeitung | Textbasierte Syntax | Grafische Oberfläche |
| Vorschau | Oft erst nach Verarbeitung | Meist direkt im Editor |
| Abhängigkeit | Registrierte Funktion erforderlich | Registrierter Block erforderlich |
| Typischer Einsatz | Bestehende Plugins und individuelle Funktionen | Moderne redaktionelle Seitenlayouts |
Shortcodes bleiben sinnvoll, wenn bestehende Erweiterungen darauf basieren oder eine kompakte Einbindung benötigt wird. Für umfangreiche Layouts bieten Blöcke häufig eine verständlichere Vorschau und klarere Einstellmöglichkeiten. Bei einem neuen Webdesign für Unternehmen sollte die Auswahl von der späteren Pflege durch Redakteure abhängen.
Welche SEO-Auswirkungen haben Shortcodes?
Für SEO zählt in erster Linie die erzeugte Ausgabe. Wird ein Shortcode serverseitig in sauberes HTML umgewandelt, können Suchmaschinen Überschriften, Texte, Links und strukturierte Elemente grundsätzlich wie normalen Seiteninhalt verarbeiten. Der Platzhalter allein verbessert oder verschlechtert kein Ranking.
Problematisch wird ein Shortcode, wenn die hinterlegte Funktion keinen Inhalt ausgibt, zentrale Texte erst nach einer fehleranfälligen Interaktion lädt oder ungültiges HTML erzeugt. Ein deaktiviertes Plugin kann außerdem sichtbare Befehle wie [produktliste] hinterlassen. Prüfe deshalb nach Plugin-Updates und Relaunches sowohl die sichtbare Seite als auch den ausgelieferten Quellcode.
Messbar ist das zum Beispiel so: Vergleiche die gerenderte Seite mit dem HTML-Quellcode, kontrolliere interne Links und teste die URL mit einem technischen SEO-Check. Eine umfassende SEO-Analyse der Website kann zusätzlich verwaiste Platzhalter, fehlerhafte Ausgaben und technische Abhängigkeiten erfassen.
Performance und Ladezeit prüfen
Ein Shortcode kann bei jedem Seitenaufruf Datenbankabfragen, externe Schnittstellen oder komplexe Berechnungen auslösen. Werden zehn identische Elemente eingebunden und startet jedes Element eine eigene Abfrage, kann sich der Aufwand entsprechend vervielfachen. Caching, gebündelte Abfragen und eine begrenzte Ergebnismenge reduzieren diese Belastung.
Die Dateigröße des Platzhalters sagt nichts über die Ladezeit seiner Ausgabe aus. Der wenige Zeichen lange Befehl [karte] kann mehrere Skripte, Stylesheets und externe Ressourcen nachladen. Prüfe deshalb die fertige URL mit einem Ladezeiten-Check, nicht nur den Inhalt im CMS-Editor.
Typische Shortcode-Fehler
Fehler entstehen häufig durch einen falschen Namen, fehlende Abschlusszeichen, ungültige Attribute oder eine deaktivierte Erweiterung. Auch verschachtelte Shortcodes können Probleme verursachen, wenn die aufgerufenen Funktionen keine Verschachtelung unterstützen.
Shortcodes sauber verwalten
Dokumentiere für jeden individuellen Shortcode den Namen, die zulässigen Attribute, ein funktionierendes Beispiel und die verantwortliche Erweiterung. Eine solche Übersicht verhindert, dass beim Wechsel eines Plugins oder Themes unbemerkt wichtige Seitenelemente ausfallen.
Für größere Websites empfiehlt sich zusätzlich eine Suche in der Inhaltsdatenbank oder im CMS-Export. So erkennst du, auf welchen Seiten ein bestimmter Shortcode verwendet wird. Vor Änderungen sollte mindestens eine Testseite alle Varianten und erlaubten Attribute abdecken.
Häufige Fragen zu Shortcodes
Wo füge ich einen Shortcode in WordPress ein?
Du kannst einen Shortcode in einen dafür vorgesehenen Shortcode-Block oder in ein Textfeld einfügen, das diese Verarbeitung unterstützt. Ob ein Widget, Template oder Seitenelement Shortcodes ausführt, hängt vom Theme und den aktiven Erweiterungen ab.
Warum wird mein Shortcode als Text angezeigt?
Der zugehörige Befehl ist wahrscheinlich nicht registriert. Prüfe, ob das benötigte Plugin oder Theme aktiv ist, ob der Name korrekt geschrieben wurde und ob das verwendete Inhaltsfeld Shortcodes verarbeitet.
Kann ich einen Shortcode mehrfach verwenden?
Ein Shortcode kann normalerweise mehrfach auf einer Seite oder auf verschiedenen Seiten eingesetzt werden. Bei datenintensiven Funktionen solltest du prüfen, ob jede Einbindung zusätzliche Datenbankabfragen oder externe Anfragen auslöst.
Kann ein Shortcode Attribute enthalten?
Attribute übergeben Einstellungen an die hinterlegte Funktion. Damit lassen sich beispielsweise eine Kategorie, eine Anzahl, eine Ausrichtung oder eine bestimmte Darstellungsvariante festlegen.
Funktionieren WordPress-Shortcodes in anderen CMS?
WordPress-Shortcodes funktionieren außerhalb von WordPress grundsätzlich nicht automatisch. Andere CMS und Shopsysteme verwenden eigene Erweiterungen, Template-Sprachen oder Platzhalter, weshalb die Funktion neu umgesetzt werden muss.
Sind Shortcodes schlecht für SEO?
Shortcodes sind nicht grundsätzlich schlecht für SEO. Relevant ist das erzeugte Ergebnis: Suchmaschinen benötigen zugänglichen Inhalt, gültiges HTML, funktionierende Links und eine angemessene Ladezeit.
Wenn Shortcodes, Plugins oder CMS-Abhängigkeiten die technische Qualität deiner Website beeinflussen, kann ein neutraler Potenzialcheck die nächsten Schritte klären.
Sie haben noch Fragen?
