In diesem Beitrag werde ich erklären was die Shortcodes in WordPress sind, welche Rolle die haben, welche Shortcodes es schon gibt, wie man individuelle erstellt und wie man in die Themes-Dateien einfügt.
Shortcodes sind eine nützliche Sache, die man mit Makros in der Textverarbeitung vergleichen kann. Mit Shortcodes kann man nicht nur einfache Textbausteine sondern auch komplexere Szenarien umsetzen, wie zum Beispiel das Einbetten eines Videos. Der bekannteste Shortcode in der WordPress-Welt dürfte [gallery] sein, mit welchem man Bilder ausgeben kann, die mit einem Beitrag oder einer Unterseite verknüpft sind.
Hier ein Beispiel für einen einfachen Shortcode. Den folgenden Code in die functions.php des aktiven Themes einfügen:
function textbaustein() {
return '<strong>Hier kommt ein häufig benutzter Textbaustein.</strong>';
}
add_shortcode('tbs', 'textbaustein')
Nach dem Einbau des obigen Code-Fragments kannst du den Shortcode [tbs] im Editor eingeben und nach dem Veröffentlichen erscheint im Frontend an der Stelle von [tbs] dein Textbaustein mit dem hinterlegten Text.
Üblicherweise werden Shortcodes im Inhaltsbereich eingesetzt. Falls man aber Shortcodes auch in Template-Dateien nutzen möchte, zum Beispiel um eine Funktion ausgeben zu lassen, wo du mit dem Editor keinen Zugriff hast, dann suche zuerst nach der entsprechenden Stelle. An der gewünschten Stelle füge dann bitte den PHP-Code ein, der folgendermaßen aufgebaut ist:
<?php echo do_shortcode( '[der-shortcode]' ); ?>
Möchtest du beispielsweise das Bilder-Galerie-Shortcode einfügen, dann sieht der Code so aus:
<?php echo do_shortcode( '[gallery]' ); ?>
Wenn man innerhalb des Editors [gallery] oder den Namen eines anderen, vorher definierten Shortcodes reinschreibt, dann wird WordPress diesen auch brav ausführen. Allerdings möchte man dies in manchen Fällen nicht, zum Beispiel wenn man als Webentwickler häufig über Code bzw. Code-Beispiele schreibt.
Möchte man den Namen eines Shortcodes als Text ausgeben lassen, ohne das er ausgeführt wird, dann stehen dir zwei Möglichkeiten1 zur Verfügung. Zum einen kannst du einfach doppelte Klammern nutzen, im konkreten Beispiel wäre dies [[gallery]].
Die andere Möglichkeit wäre, dass man die Klammern mit Hilfe der Unicode-Zeichen "maskiert". Hierbei würde man folgendes im Editor notieren: [gallery]. In beiden Fällen würde der Besucher im Frontend folgendes als Text zu sehen bzw. zu lesen bekommen: [gallery].