WordPress
kortkod

Registrerar kortkod

Shortcode är en liten kodkod som kan läggas till i WordPress-redigeraren och kommer att mata ut något annat när sidan har publicerats eller förhandsvisats.

Ofta är kortkoder läggs till temat functions.php fil, men det är inte en god praxis som kortkoder förväntas fortsätta arbeta efter byte teman. Skriv istället ett plugin för att lägga till den här funktionen.

Strukturen för att registrera kortkod är:

function new_shortcode($atts, $content = null){
    // if parameters are needed in the shortcode
    // parameters can be set to default to something
    extract( shortcode_atts( array(
        'param_one' => 'h1'
    ), $atts ) );
    $shortcode = '<'.$param_one'>'.$content.'</'.$param_one.'>';
    return $shortcode;
}
// this is what registers the shortcode with wordpress
add_shortcode('demo-shortcode','new_shortcode');

Inuti WordPress-redigeraren kan du skriva:

[demo-shortcode param_one="h2"]Demo[/demo-shortcode]
// you don't need to insert param_one into the editor if it has a default value.
// having it in the editor will override the default

När sidan har publicerats kommer den att bli

<h2>Demo</h2>

Använda kortkoder i WordPress Backend

[footag foo="value of 1" attribute-2="value of 2"]

I wordpress admin använder vi fördefinierade kortkoder genom att skriva kortkodens namn i fyrkantiga parenteser och eventuellt lägga till attribut till det som skiljer sig efter mellanrum.

Lägga till nya kortkoder

function footag_func( $atts ) {
    return "foo = {$atts['foo']}";
}
add_shortcode( 'footag', 'footag_func' );

I plugins kan vi lägga till kortkoder med funktionen add_shortcode.

Kortkoden kan användas på valfri Wordpress-sida eller post bara genom att bifoga den i fyrkantiga parenteser.

[footag]

Använda kortkoder inuti PHP-koden (teman och plugins)

<?php echo do_shortcode("[footag foo='Hi! I am a foo output']"); ?>

För att skriva ut en kortkod med php använd do_shortcode funktionen och eko det returnerade värdet.

Använda kortkoder i widgetar

add_filter( 'widget_text', 'shortcode_unautop' );
add_filter( 'widget_text', 'do_shortcode' );enter code here

Lägg till detta i ett plugin eller filen functions.php för att aktivera kortkoder i widgetar. Koden stoppar först WordPress-svänglinjen bryts i stycketaggar och låter sedan kortkoder att analysera för widgetar. Ordningen på de två linjerna är viktig.