Einen eigenen WordPress-Shortcode erstellen und an der richtigen Stelle ausgeben

Shortcodes sind meiner Ansicht nach Fluch und Segen zugleich. Zum einen sind sie eine wirklich prima Möglichkeit komplexe Inhalte “einfach” in einem Artikel oder auf einer Seite einzufügen. Sehr viele Plugins bieten die Möglichkeit an ihre Inhalte per Shortcode einzubinden.

Die Kehrseite der Medaille ist allerdings, dass der Shortcode nicht mehr funktioniert, wenn man das Plugin deaktiviert oder sogar entfernt, weil man vielleicht einen besseren Ersatz gefunden hat. Es kann somit sehr mühsam sein “alte” Shortcodes zu entfernen oder aber — die andere Alternative — man schleppt Altlasten-Plugins mit, nur damit die Shortcodes in alten Artikeln noch weiter funktionieren.

Trotzdem gibt es Situationen, in denen Shortcodes sehr hilfreich sind, gerade auch für Redakteure, die ihre Arbeit beim Erstellen von Artikeln möglichst “simpel” halten möchten. Es gibt aber auch andere Situationen, in denen Shortcodes einfach eine prima hilfreiche Sache sind.

Ein sinnvoller Einsatz ist z. B. die Nutzung von Shortcodes mit Textbausteinen — ja, ich weiß es gibt dafür auch andere Möglihchkeiten. Aber mit einem Shortcode kann man sich diese — relativ einfach — selber machen.

Dafür erweitert man seine functions.php um folgenden Code:

function textbaustein() {
    return '<h3>Mein immer gleicher Text</h3>
    Er kann sogar HTML enthalten.';
}

add_shortcode('tbs', 'textbaustein')

Man nutzt hierbei die Funktion add_shortcode, wobei man das ganze auch noch (bei Bedarf) mit Variablen ergänzen kann. Wichtig ist hierbei übrigens das return als Ausgabe und nicht echo, damit der Text auch wirklich erst an der Stelle ausgegeben wird, an der der Shortcode [tbs] eingefügt wurde. Er landet nämlich andernfalls vor dem Inhalt.

Und genau das passiert auch wenn man anstatt eines Textes z. B. per PHP ein Plugin oder aber auch eine WordPress-Funktion aufrufen möchte. Deswegen muss man hierbei eine Ausgabepufferung mit einbauen:

function eine_funktion() {
  ob_start();
  wp_funktion();
  return ob_get_clean();
  }
add_shortcode('funktion', 'eine_funktion');

Code via Konstantin Kovshenin

Nur so erfolgt die Ausgabe an der Stelle des eingefügten Shortcodes und nicht unmittelbar vor dem Inhalt.

Wir arbeiten seit 20 Jahren mit WordPress und bieten diverse Dienstleistungen rund um das System an. Kontaktiere uns für weitere Informationen oder für ein Angebot.