Share
In diesem Artikel erhalten Sie eine detaillierte Erläuterung der Shortcode-API von WordPress und erfahren, wie Sie einen Shortcode erstellen. der richtige Weg. Sie erhalten dann einige nützliche Beispiele für fortgeschrittenere Kurzcodes und wie Sie Ihre eigenen Variationen programmieren können! Sind Sie bereit, Ihrer Trickkiste eine neue Fähigkeit hinzuzufügen? Lass uns anfangen!
Shortcodes wurden in WordPress 2.5 eingeführt. Kurz gesagt, ein Shortcode ist a Abkürzung. Es handelt sich um WordPress-spezifische Codeteile, mit denen Sie Zeit sparen und Dinge tun können, für die ansonsten technisches Wissen und möglicherweise eine große Menge an Code erforderlich sind. Durch das Hinzufügen von Kurzwahlen zu Ihren Designs oder Plugins können Sie die Verwendung dieser Funktionen so viel einfacher und intuitiver gestalten. Sie könnten beispielsweise einen Kurzcode haben [most_popular_post] das, wenn man es ausgibt genau wie das würde den beliebtesten Beitrag auf Ihrer WordPress-Site anzeigen. Wenn Sie dies manuell tun möchten, müssen Sie HTML-Code schreiben und diesen manuell ändern, wenn sich die Beliebtheit der Beiträge ändert. Ein Shortcode macht das unnötig und vereinfacht die Arbeit für Sie.
Ein Shortcode ist ein WordPress-spezifischer Code, mit dem Sie mit wenig Aufwand einfache Dinge erledigen können. Shortcodes können Dateien einbetten oder Objekte erstellen, für die normalerweise komplizierter, hässlicher Code in nur einer Zeile erforderlich ist.
Abkürzung = Abkürzung.
-WordPress.com
Shortcodes werden mit der WordPress-Shortcode-API erstellt. Sie arbeiten ähnlich wie WordPress-Filter. Sie müssen ein definieren Handler Funktion, die den Kurzcode analysiert und etwas Ausgabe zurückgibt. Sie registrieren den Kurzcode dann mit Verknüpfung hinzufügen() Funktion. Eine Shortcut-Handler-Funktion akzeptiert bis zu drei unten aufgelistete Argumente:
Accentsconagua
$ atts: Ein Array mit beliebigen Kurzcode-Attributen$ content: Jeder Inhalt, den der Kurzcode enthält$ codeDer Name des Shortcodes (normalerweise verwendet, wenn derselbe Handler für mehrere Shortcodes verwendet wird)Mir ist klar, dass dies für Sie etwas verwirrend erscheinen mag. Hier einige Beispiele für diese Argumente mit einem hypothetischen Shortcode wptuts.
[wptuts]
$ atts = array () $ content = null [wptuts] Lorem ipsum dolor sitzen amet [/ wptuts]
$ atts = array () $ content = Lorem ipsum dolor sitzt amet [wptuts name = "irgendein Name"]
$ atts = array ('id' => '555', 'name' => 'irgendein Name') $ content = null [wptuts] Lorem ipsum dolor sitzen amet [/ wptuts]
$ atts = Array ('id' => '555') $ content = Lorem ipsum dolor sitzt ametDas sollte Ihnen eine gute Vorstellung davon geben, wie Argumente an den Shortcode-Handler übergeben werden.
Hinweis: Shortcodes schließen sich selbst ein. Deshalb,
[wptuts]ist das gleiche wie[wptuts /]. Sie müssen nur Shortcode-Tags zum Öffnen und Schließen verwenden, wenn sich dazwischen Inhalt befindet.
Nachdem Sie nun die Grundlagen der Shortcode-API kennen gelernt haben, können Sie Ihren ersten Shortcode erstellen. Ich werde das TwentyEleven-Design verwenden, das in WordPress enthalten ist. Die Screenshots spiegeln dies wider. Sie können jedoch ein beliebiges Design Ihrer Wahl verwenden oder sogar ein Plugin schreiben.
Um zu beginnen, öffne die Functions.php Datei des Designs, und fügen Sie diese Codezeile oben ein:
Include 'shortcodes.php';
Ihre Functions.php sollte so aussehen:
Als Nächstes erstellen Sie die gerade referenzierte Datei - shortcodes.php. Zur Vereinfachung befinden sich alle Kurzwahlnummern in dieser Datei. Zu Beginn erstellen wir einen sehr einfachen Shortcode, der einen Link zum Tweet der Post-URL generiert. Erstellen Sie eine Funktion wptuts_first_shortcode () und geben Sie diesen Code ein:
я Funktion wptuts_first_shortcode ($ atts, $ content = null) $ post_url = get_permalink ($ post-> ID); $ post_title = get_the_title ($ post-> ID); $ tweet = 'Auf Twitter teilen'; $ tweet zurückgeben; add_shortcode ('twitter', 'wptuts_first_shortcode'); Ihr erster Shortcode ist jetzt bereit! Sie können es durch Eingabe ausprobieren [twitter] in einen Beitrag Hier ist ein Beispiel für Ihre Ausgabe:
Nachdem Sie nun einen einfachen Shortcode erstellt haben, können Sie weitere Shortcodes erstellen, die die verschiedenen Argumente verwenden $ atts und $ content.
Ein in YouTube eingebetteter Shortcode ist sehr nützlich, da für das Einbetten eines Videos Codierungskenntnisse erforderlich sind. mit einem shortcode wird der effor-Bedarf erheblich reduziert. Außerdem kann diese Technik verwendet werden, um Shortcodes zu erstellen, in die andere Videos oder sogar Medien wie Bilder oder Audiodateien eingebettet werden können. Fügen Sie diesen Code in ein shortcodes.php:
Funktion wptuts_youtube ($ atts, $ content = null) extract (shortcode_atts (array ('id' => "), $ atts)); $ return = $ content; if ($ content) $ return. ="
"; $ return. = ''; return $ return; add_shortcode ('youtube', 'wptuts_youtube'); Beachten Sie, was wir hier machen. Der Shortcode hat ein einziges Attribut: die Video-ID (die der URL eines Youtube-Videos entnommen werden kann). Die Funktion shortcode_atts () ( arbeitet sehr gerne wp_parse_args (). Es analysiert die Attribute und verwendet das angegebene Array als Standard. Der zurückgegebene Wert ist ein Array mit allen Schlüsseln des ersten Arrays, ersetzt durch die entsprechenden Werte in $ atts Array, falls vorhanden. Wenn der Inhalt zwischen den Shortcode-Tags nicht leer ist, zeigen wir ihn an, fügen ein paar Zeilenumbrüche hinzu und binden das Video ein. Versuch es! Der verwendete Code war:
[youtube] Schauen Sie sich dieses Video an! [/ youtube]
Hier ist das Ergebnis:
я
Ein weiteres Beispiel für einen großartigen Shortcode ist der, der den neuesten Blogeintrag anzeigt. Dies hat den Vorteil, dass bei jeder neuen Veröffentlichung keine manuelle Aktualisierung erforderlich ist. Hier ist der Code:
Funktion wptuts_recentpost ($ atts, $ content = null) $ getpost = get_posts (array ('number' => 1)); $ getpost = $ getpost [0]; $ return = $ getpost-> post_title. "
". $ getpost-> post_excerpt."? "; $ return. ="
ICH WÜRDE) . "">Weiterlesen ?"; return $ return; add_shortcode ('newestpost', 'wptuts_recentpost'); Was wir machen, ist das get_posts () Funktion, um den neuesten Beitrag abzurufen und den Titel, den Auszug und einen Link zum Beitrag anzuzeigen. Der Kurzcode hat keine Attribute. Sie können jedoch beispielsweise Attribute hinzufügen, um Beiträge aus einer bestimmten Kategorie anzuzeigen, oder eine benutzerdefinierte Anzahl der neuesten Beiträge anzeigen. Sie können den Shortcode mit diesem Code ausprobieren:
Schauen Sie sich unseren neuesten Beitrag an:
[neuester Beitrag]
So sieht es aus:
Es gibt ein paar weitere Dinge, die sich als nützlich erweisen könnten, wenn Sie sich mit der fortgeschritteneren Shortcode-Entwicklung befassen.
remove_shortcode () Funktion. Verwendung ist remove_shortcode ($ shorcodename). Sie können auch entfernen alles Kurzwahlnummern mithilfe der Funktion remove_all_shortcodes () do_shortcode ($ content) Funktion. Der erste Fall betrifft verschachtelte Kurzwahlen - einfach verwenden do_shortcode auf der $ content an Sie übergeben, d. h. statt $ content zurückgeben;, benutzen do_shortcode zurückgeben ($ content). Dadurch wird sichergestellt, dass verschachtelte Kurzwahlen verarbeitet werden. add_filter ('widget_text', 'do_shortcode'); (Quelle: Shortcodes in Widgets)
Hoffentlich haben Sie inzwischen eine Menge über WordPress-Shortcodes gelernt. Sie können nun eine Reihe von Shortcodes erstellen, die WordPress vereinfachen und rationalisieren, und Ihre Benutzer, ob Sie selbst oder Ihre Kunden, werden sich bei Ihnen dafür bedanken!
Schauen Sie sich unser aktuelles "Resource Roundup" an, um die besten und kreativsten Shortcodes zu erfahren!
