Tutorial: Shortcodes in WordPress

in utopian-io •  7 years ago 
  • Language: German (Deutsch) ↓↓
  • Title: [de] Die Shortcodes in WordPress
  • Title: [en] Shortcodes in WordPress
  • Summary: In this article I will explain what the short codes in WordPress are, what role they have, what short codes already exist, how to create individual ones and how to include them in files of the theme?

Worum geht es?

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 = "WordPress-Makros"

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.

Einen einfachen Shortcode definieren

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.

Shortcodes auch in den Template-Dateien nutzen

Ü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]' ); ?>

Shortcodes in Code-Beispielen ausschreiben

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: &#91;gallery&#93;. In beiden Fällen würde der Besucher im Frontend folgendes als Text zu sehen bzw. zu lesen bekommen: [gallery].



Posted on Utopian.io - Rewarding Open Source Contributors

Authors get paid when people like you upvote their post.
If you enjoyed what you read here, create your account today and start earning FREE STEEM!
Sort Order:  

Thank you for the contribution. It has been approved.

You can contact us on Discord.
[utopian-moderator]

Thank you @ruah!

Hey @vladimir-simovic I am @utopian-io. I have just super-voted you at 3% Power!

Suggestions https://utopian.io/rules

  • Your contribution is less informative than others in this category.
  • Utopian has detected 1 bot votes. I am the only bot you should love!!

Achievements

  • Thanks for explaining to me how it works! Beep beep!
  • You have less than 500 followers. Just gave you a gift ;)
  • You are generating more rewards than average for this category. Super!
  • Seems like you contribute quite often. AMAZING!
    Up-vote this comment to grow my power and help Open Source contributions like this one. Want to chat? Join me on Discord https://discord.gg/Pc8HG9x