So erstellen Sie Ihre eigenen WordPress Shortcodes
In Version 2.5 hat WordPress Shortcodes eingeführt, und wir alle haben sie wahrscheinlich irgendwann benutzt. Sie werden normalerweise mit Plugins oder sogar Themes ausgeliefert, und was sie tun, wird beachtet, wenn Sie etwas in eckige Klammern einfügen und dann durch einen anderen Inhalt ersetzen. Es könnte ein einfacher Satz sein oder es könnte eine massive PHP-Funktion sein, alles hängt davon ab, was Sie WordPress angewiesen haben.
Gebündelte Shortcodes sind großartig und beschleunigen die Dinge beträchtlich, aber wäre es nicht toll zu wissen, wie man eigene Shortcodes erstellt?
In diesem Artikel werde ich Sie durch die Erstellung einiger einfacher WordPress-Shortcodes führen, damit Sie jede Funktionalität, die Sie mögen, erstellen können.
Ein einfacher Shortcode
Die Shortcode-API funktioniert sehr einfach: Zuerst müssen Sie eine Callback-Funktion erstellen, die jederzeit ausgeführt wird, wenn der Shortcode verwendet wird. Dann müssen Sie diese Funktion an einen bestimmten Kurzwahlcode binden, damit sie sofort verwendet werden kann. Der Code wird häufig in die Datei functions.php gestellt, aber wenn Sie viele Shortcodes haben möchten, ist es sinnvoll, eine separate Datei zu erstellen und diese Datei in Ihre functions.php-Datei aufzunehmen.
In unserem ersten Beispiel möchten wir einen Shortcode erstellen, der jedes Mal, wenn wir [Lorem] in den Editor eingeben , Lorem ipsum erzeugt . Zuerst müssen wir die Callback-Funktion erstellen, die das Lorem Ipsum zurückgibt (in Shortcodes geben wir nichts zurück, alles wird zurückgegeben):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Als nächstes müssen wir diesen Shortcode zu WordPress hinzufügen, indem wir die Funktion add_shortcode entweder in unserer functions.php-Datei oder in einer Datei verwenden, die darin enthalten ist. Diese Funktion fügt den Shortcode hinzu und bindet ihn auch an die soeben erstellte Funktion. add_shortcode benötigt nur zwei Argumente, wobei der erste der Name ist, den dieser Shortcode haben soll (was wir zwischen den eckigen Klammern eingeben ) und der zweite die Funktion, die wir an diesen Shortcode anhängen wollen:
add_shortcode('lorem', 'lorem_function');Das ist alles, was Sie brauchen, um einen einfachen Shortcode in WordPress zu erstellen.
Parameter hinzufügen
Um mit dieser Dummy-Idee fortzufahren, benötigen wir oft Bilder in unseren Inhalten, wenn wir unsere Modelle vorbereiten, und diese Bilder müssen unterschiedliche Größen haben. Deshalb erstellen wir nun einen Shortcode, um ein Bild wie folgt einzufügen:
[picture width="500" height="500"]Wenn WordPress darauf stößt, möchten wir eine Funktion, die ein Bild einfügen wird. Es muss die Attribute width und height lesen, aber nur für den Fall, dass wir auch Standardwerte angeben, damit es ohne die Attribute verwendet werden kann. Da wir möglicherweise kein Bild zur Verfügung haben, verwenden wir das Lorempixel.com Service, um uns mit einem zufälligen Bild zu versorgen.
Zuerst müssen wir die Funktion erstellen:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Wir haben diese Funktion random_picture genannt und da dieser Shortcode Argumente annehmen kann, haben wir ihm den Parameter $ atts gegeben . Um die Attribute zu verwenden, benötigen wir zwei Funktionen: die shortcode_atts, die eine WordPress-Funktion ist, die unsere Attribute mit bekannten Attributen kombiniert und bei Bedarf Standardwerte einfügt; und die PHP-Extraktfunktion, die, wie der Name schon sagt, die Attribute extrahiert, die wir für unseren Shortcode festgelegt haben. Schließlich gibt die Funktion den gewünschten Wert zurück, in diesem Fall den HTML-Code für unser Bild, kombiniert mit den Variablen width und height.
Das einzige, was noch zu tun ist, ist diesen Shortcode zu registrieren:
add_shortcode('picture', 'random_picture');Unser Shortcode ist komplett, wenn wir [Bild] eingeben, erhalten wir ein zufälliges Bild von 400 mal 200, und wenn wir die Attribute verwenden, können wir ein Bild jeder beliebigen Größe erstellen.
Fazit
Das Erstellen von kurzen Kurzwahlnummern für Dinge, die wir häufig verwenden, hilft uns beim Schreiben von Blogposts, weil Sie mit Kurzwahlcodes alles machen können, was Sie wollen, so einfach wie das Zurückgeben eines Satzes oder so komplex wie das Hinzufügen eines Formulars oder der neuesten nach Monat sortierten Beiträge.
Hast du hilfreiche Shortcodes für WordPress erstellt? Welche Shortcodes wünschten Sie? Lassen Sie es uns in den Kommentaren wissen.
Ausgewähltes Bild / Vorschaubild, Codebild über Marjan Krebelj.