WordPress
Shortcode toevoegen
Zoeken…
Syntaxis
add_shortcode( $tag , $func );
parameters
| Parameter | Details |
|---|---|
| $ tag | (tekenreeks) (verplicht) Shortcode-tag om te zoeken in berichtinhoud |
| $ func | (opvraagbaar) (vereist) Haak om uit te voeren wanneer shortcode wordt gevonden |
Opmerkingen
- Aan de shortcode-callback worden drie argumenten doorgegeven: de shortcode-attributen, de shortcode-inhoud (indien aanwezig) en de naam van de shortcode.
- Er kan slechts één haak zijn voor elke shortcode. Wat betekent dat als een andere plug-in een vergelijkbare shortcode heeft, deze de jouwe overschrijft of de jouwe de hunne overschrijft, afhankelijk van de volgorde waarin de plug-ins zijn opgenomen en / of zijn uitgevoerd.
- Namen van shortcodes worden altijd omgezet in kleine letters voordat ze worden doorgegeven aan de handlerfunctie. Waarden blijven ongewijzigd.
- Merk op dat de functie die door de shortcode wordt aangeroepen nooit output van welke aard dan ook mag produceren. Shortcodefuncties moeten de tekst retourneren die moet worden gebruikt om de shortcode te vervangen. Het direct produceren van de output zal leiden tot onverwachte resultaten. Dit is vergelijkbaar met de manier waarop filterfuncties zich zouden moeten gedragen, omdat ze geen verwachte bijwerkingen van de oproep zouden moeten veroorzaken, omdat u niet kunt bepalen wanneer en waar ze vandaan komen.
Eenvoudige shortcode voor recent bericht
add_shortcode is wp trefwoord.
// 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;
}
Dit fragment kan in uw themafuncties worden geplaatst. functions.php .
[recent-posts] Dit is onze shortcode voor recente berichten. We kunnen deze shortcode toepassen in backend (zoals pagina's, berichten, widgets).
We kunnen ook dezelfde shortcode in onze code gebruiken. met behulp van do_shortcode .
Bijv. echo do_shortcode( '[recent-posts]' );
Geavanceerde shortcode voor recente berichten
Met deze functie wordt de parameter gebruikt voor het aantal recente berichten dat u wilt weergeven.
Bijvoorbeeld: u wilt slechts vijf recente berichten weergeven. Net de argumenten doorgegeven met posts = "5" (u kunt een willekeurig aantal recente posts doorgeven die u wilt weergeven).
Functie haalt slechts vijf recente berichten uit database.
// 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;
}
Bijv. echo do_shortcode( '[recent-posts posts="5"]' );