WordPress hat vor sechs Jahren mit der Veröffentlichung von WordPress 2.5 die Shortcode-API eingeführt. Shortcodes werden jetzt von einer großen Anzahl von WordPress-Plugins verwendet, damit Benutzer ihren Posts und Seiten Inhalte hinzufügen können.
Mit der Shortcode-API können Sie Ihre eigenen Shortcodes erstellen, indem Sie Ihren Themenfunktionen Funktionen hinzufügen.PHP-Vorlage (diese befindet sich unter www.yourwebsite.com/wp-content/themes/yourtheme /).
WordPress erstellt nicht nur Ihre eigenen Shortcodes, sondern enthält auch fünf Standard-Shortcodes mit dem WordPress-Kern:
- audio – Ermöglicht das Einbetten von Audiodateien.
- caption – Ermöglicht es Ihnen, Beschriftungen um Inhalte zu wickeln. Es wird häufig mit Bildern verwendet.
- einbetten – Ermöglicht das Einbetten einer Vielzahl von Inhalten wie Video, Audio und Tweets.
- Galerie – Ermöglicht das Einfügen von Bildergalerien.
- video – Ermöglicht das Einbetten von Videodateien.
Obwohl die Standard-WordPress-Shortcodes häufig verwendet werden, nutzen nur sehr wenige WordPress-Benutzer die Shortcode-API und entwerfen eindeutige Shortcodes für ihre Website. In diesem Tutorial möchte ich Ihnen zeigen, wie einfach es ist, Ihre Website mit benutzerdefinierten Shortcodes zu verbessern.
Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie eine Sicherungskopie der Funktionen erstellen.php und alle anderen Dateien, die Sie bearbeiten, bevor Sie Änderungen an Ihrer Live-Website vornehmen.
Erstellen eines Shortcodes – Ein grundlegendes Beispiel
Um Ihnen ein gutes Verständnis dafür zu vermitteln, wie die WordPress-Shortcode-API funktioniert, beginnen wir mit einer grundlegenden Shortcode-Funktion.
Bitte denken Sie daran, dass Shortcodes für Inhalte und Funktionen erstellt werden sollten, die Sie häufig verwenden. Der springende Punkt bei der Verwendung von Shortcodes ist, jemandem Zeit zu sparen. Wenn Sie etwas nur einmal verwenden, hat es nicht viel Sinn, einen Shortcode dafür zu erstellen.
Ich schreibe ungefähr ein Dutzend Artikel pro Woche. Eine Sache, die ich häufig tue, ist, diejenigen, die meine Artikel genossen haben, zu ermutigen, meinen Blog (oder den Blog, für den ich schreibe) zu abonnieren. Ich schreibe dies derzeit jedes Mal auf, aber ich könnte mir viel Zeit sparen, indem ich einen Shortcode für den Text erstelle.
Um dies zu tun, könnte ich eine Funktion wie diese zu den Funktionen meines Themas hinzufügen.php Vorlage:
Diejenigen unter Ihnen, die keine Programmiererfahrung haben, mögen den obigen Code ein wenig entmutigend finden, aber es ist leicht zu verstehen, wenn Sie den Code Zeile für Zeile aufschlüsseln.
Als erstes fügen wir einen Kommentar über unserer Funktion hinzu. Dies wird uns helfen, schnell zu sehen, wofür unsere Funktion ist, wenn wir den Code zu einem späteren Zeitpunkt anzeigen.
// Function to add subscribe text to posts and pages
Wir definieren dann unsere Funktion. Ich verwende gerne selbsterklärende Namen, daher habe ich meine Funktion „subscribe_link_shortcode“ aufgerufen.
function subscribe_link_shortcode() {
Als nächstes definieren wir unsere Nachricht. Die return-Anweisung zeigt unsere Nachricht an, wenn sie aufgerufen wird. Es speichert auch die Nachrichten (im Gegensatz zu echo , das sie druckt, aber nicht speichert).
Die Funktion wird dann geschlossen.
}
Wir definieren dann den Shortcode selbst mit der Funktion add_shortcode . Die erste angegebene Variable definiert den zu verwendenden Shortcode und die zweite Variable ruft unsere Funktion auf (dh die oben definierte).
add_shortcode('subscribe', 'subscribe_link_shortcode');
Nach dem Speichern der Funktionen.PHP-Vorlage, wir können jetzt unsere Nachricht jederzeit mit dem Shortcode subscribe aufrufen.
Wenn Sie den Shortcode abonnieren in einem Beitrag oder einer Seite verwenden, wird die folgende Meldung ausgegeben:
Wenn Ihnen dieser Artikel gefallen hat, empfehle ich Ihnen, den Blog von Elegant Themes per RSS zu abonnieren.
Ich habe in meinem Beispiel eine einfache Nachricht verwendet, die Sie jedoch ändern können, um viele andere Dinge anzuzeigen. Sie können beispielsweise einen Shortcode für die Anzeige von AdSense-Anzeigen oder ein Abonnementformular für Ihren Newsletter erstellen. und fügen Sie sie dann an einer beliebigen Stelle in Ihre Artikel ein.
Erstellen eines Shortcodes mit Attributen
Attribute können die Funktionalität von Shortcodes erweitern, indem Sie Daten über Ihre Shortcodes übergeben können.
Im folgenden Beispiel zeige ich Ihnen, wie Attribute verwendet werden können, um die zuvor erstellte Funktion zu erweitern. Wie Sie sehen, bleibt ein Großteil des Codes gleich.
$atts ist der Name unseres Attributarrays. Wir verwenden dann die extract-Funktion, um Variablen aus unserem Array zu importieren (über die WordPress-Funktion shortcode_atts).
Zwei Attribute werden dann definiert: subtype und und subtypeurl. Diese repräsentieren die Art des Abonnements und die Abonnement-URL. Diese Attribute werden dann in unserer Nachricht aufgerufen.
Unser Standard-Abonnementtyp ist RSS und unsere Standard-Abonnement-URL ist http://feeds.feedburner.com/ElegantThemes. Diese Informationen werden angezeigt, wenn keine Attribute definiert sind.
Wenn Sie also Folgendes zu einem Beitrag hinzufügen:
Wir erhalten die folgende Ausgabe:
Abonnieren Sie zukünftige Updates von Elegant Themes per RSS.
Wenn wir Attribute definieren, ist das Ergebnis anders. Der folgende Code:
Würde ausgeben:
Achten Sie darauf, zukünftige Elegant Themes Updates per RSS zu abonnieren.
Achten Sie darauf, um zukünftige Elegant Themes Updates von Twitter abonnieren.
Achten Sie darauf, zukünftige elegante Themen Updates von Facebook abonnieren.
Achten Sie darauf, um zukünftige Elegant Themes Updates von Google abonnieren.
Obwohl dies ein grundlegendes Beispiel für die Funktionsweise von Attributen war, ist es leicht zu erkennen, wie Plugin-Entwickler die Shortcode-API verwenden können, um komplizierte Funktionen benutzerfreundlicher für Benutzer zu gestalten.
Übersicht
Wenn Sie die in diesem Tutorial beschriebenen Schritte ausführen, sollten Sie nun ein grundlegendes Verständnis dafür haben, wie Sie Ihre eigenen benutzerdefinierten Shortcodes für Ihre Website erstellen können. Shortcodes sind eine großartige Möglichkeit, komplizierte Aufgaben zu vereinfachen, daher empfehle ich Ihnen, die WordPress-Shortcode-API in Zukunft im Auge zu behalten.
Machen Sie sich keine Sorgen, wenn dieses Tutorial für Sie etwas schwierig war. Alle Designs von Elegant Themes werden mit Shortcodes geliefert, die das Veröffentlichen schöner Inhalte vereinfachen. Die Shortcodes können verwendet werden, um Diashows, Spalten und Tabellen zu erstellen. Es ermöglicht Ihnen sogar, Ihre Inhalte mit einem Passwort zu schützen.
Ich hoffe, Ihnen hat dieses Tutorial zum Erstellen eines eindeutigen Shortcodes für Ihre WordPress-Website gefallen. Wenn ja, empfehle ich Ihnen, Elegant Themes zu abonnieren, da wir einige großartige Inhalte in der Pipeline haben 🙂
Außerdem erinnere ich Sie noch einmal daran, alle Dateien zu sichern, bevor Sie sie bearbeiten.