WordPress
Shortcode hinzufügen
Suche…
Syntax
add_shortcode( $tag , $func );
Parameter
| Parameter | Einzelheiten |
|---|---|
| $ tag | (Zeichenfolge) (erforderlich) Shortcode-Tag, das im Post-Inhalt gesucht werden soll |
| $ func | (aufrufbar) (erforderlich) Hook zum Ausführen, wenn Shortcode gefunden wird |
Bemerkungen
- Dem Shortcode-Callback werden drei Argumente übergeben: die Shortcode-Attribute, der Shortcode-Inhalt (falls vorhanden) und der Name des Shortcodes.
- Für jeden Shortcode kann es nur einen Haken geben. Das bedeutet, dass ein anderes Plugin einen ähnlichen Shortcode überschreibt, oder das andere, je nachdem, in welcher Reihenfolge die Plugins enthalten sind und / oder ausgeführt werden.
- Shortcode-Attributnamen werden immer in Kleinbuchstaben konvertiert, bevor sie an die Handlerfunktion übergeben werden. Werte sind unberührt.
- Beachten Sie, dass die vom Shortcode aufgerufene Funktion niemals irgendeine Ausgabe erzeugen sollte. Shortcode-Funktionen sollten den Text zurückgeben, der zum Ersetzen des Shortcodes verwendet werden soll. Die direkte Ausgabe der Ausgabe führt zu unerwarteten Ergebnissen. Dies ist ähnlich wie das Verhalten von Filterfunktionen, da sie keine erwarteten Nebeneffekte aus dem Aufruf hervorrufen sollten, da Sie nicht steuern können, wann und von wo aus sie aufgerufen werden.
Einfacher Kurzcode für den letzten Beitrag
add_shortcode ist ein add_shortcode Schlüsselwort.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
endwhile;
endif;
wp_reset_query();
return $return_string;
}
Dieses Snippet kann in Ihrer Theme- functions.php .
[recent-posts] Dies ist der Shortcode für den letzten Post. Wir können diesen Shortcode im Backend anwenden (wie Seiten, Post, Widgets).
Wir können den gleichen Shortcode auch in unserem Code verwenden. mit Hilfe von do_shortcode .
Z.B. echo do_shortcode( '[recent-posts]' );
Erweiterter Shortcode für aktuelle Beiträge
Diese Funktion verwendet Parameter für die Anzahl der letzten Beiträge, die Sie anzeigen möchten.
Bsp .: Sie möchten nur fünf aktuelle Beiträge anzeigen. Übergeben Sie einfach die Argumente mit posts = "5" (Sie können eine beliebige Anzahl der letzten Beiträge übergeben, die Sie anzeigen möchten).
Funktion holt nur fünf aktuelle Beiträge aus der Datenbank.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
extract(shortcode_atts(array(
'posts' => 1,
), $atts));
$return_string = '<ul>';
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
endwhile;
endif;
$return_string .= '</ul>';
wp_reset_query();
return $return_string;
}
Z.B. echo do_shortcode( '[recent-posts posts="5"]' );