WordPress.org

Sprachen: Englisch – Français – 日本語 (Fügen Sie Ihre Sprache hinzu)

Seit Version 2.5 unterstützt WordPress so genannte Shortcodes. Sie wurden eingeführt, um Makros zu erstellen, die im Inhalt eines Beitrags verwendet werden können. Beispiele für Shortcodes und deren Verwendung finden Sie unter WordPress.com Shortcodes, wobei einige der dort vorgestellten Shortcodes exklusiv für WordPress.com sind.

Ein trivialer Shortcode für eine Galerie sieht so aus:

Shortcodes können auch mit zusätzlichen Attributen verwendet werden, wie das folgende Beispiel zeigt:

Beide Beispiele zeigen eine Bildergalerie an, die schwer zu pflegen wäre, wenn man das HTML-Markup dafür schreibt und es mit hochgeladenen Bildern synchron hält. Durch die Verwendung eines Shortcodes wird das Markup für die Galerie dynamisch und automatisch erstellt.

Eingebaute und zusätzliche Shortcodes

WordPress bietet einige der Shortcodes standardmäßig an (z.B. den für die Galerie) und Plugins können ihre eigenen über die Shortcode API hinzufügen.

Die folgenden Shortcodes sind im Lieferumfang von WordPress enthalten:

Escaping von Shortcodes

Manchmal möchten Sie vielleicht den Text, der normalerweise einen Shortcode darstellt, in Ihren Beiträgen verwenden. Um dies zu tun, müssen Sie den Shortcode ausblenden, indem Sie zwei Sätze von Klammern anstelle von nur einer verwenden. Um dies in Ihrem Beitrag anzuzeigen:

Sie würden dies schreiben:

]

Für Shortcodes, die einen Start- und einen End-Tag haben, müssen Sie nur die allererste und die allerletzte Klammer ausbrechen:

 ... ]

Beachten Sie, dass nur Shortcodes, die derzeit verfügbar sind, auf diese Weise escaped werden können. Die Verwendung von doppelten Klammern um Text, der nicht als Shortcode registriert ist, führt dazu, dass beide Klammersätze in Ihrem Beitrag angezeigt werden, nicht nur einer, wie beim Ausblenden von registrierten Shortcodes.

Shortcodes in Widgets

Standardmäßig unterstützt WordPress bis 4.9 keine Shortcodes in Sidebar-Widgets. Es erweitert die Shortcodes nur innerhalb des Inhalts eines Beitrags, einer Seite oder eines benutzerdefinierten Beitragstyps. Um Shortcode-Unterstützung zu Sidebar-Widgets hinzuzufügen, können Sie ein Plugin installieren, den unten stehenden Code verwenden oder sich die Widget-Verbesserungen in 4.9 ansehen:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Es ist wichtig, dass diese Zeilen in dieser Reihenfolge hinzugefügt werden. Die erste Zeile verhindert, dass WordPress Zeilenumbrüche in Absatz-Tags umwandelt, da dies verhindert, dass Shortcodes funktionieren. Die zweite Zeile sorgt dafür, dass die Shortcodes funktionieren.

Shortcodes für fehlende Plugins (nicht registrierte Namen)

Abgesehen von den eingebauten Shortcodes werden alle anderen durch Plugins hinzugefügt. Wenn das Plugin, das einen bestimmten Shortcode bereitstellt, fehlt oder deaktiviert ist, behandelt WordPress den gesamten Shortcode, seine Attribute und den Inhalt darin als normalen Klartext und behält die Sonderzeichen in der HTML-Ausgabe bei.

Yay!

<Yay>

<(^_^)>

<(^_^)> -- Yay!

<(^_^<) -- <Yay>

Yay!

<Yay>