Shortcode

Shortcode — шаблоны слов или функции, которые выполняются на странице записи. Например, вместо [gallery] может появиться галерея.

Добавляются шорткоды через функцию add_shortcode().

Пример 1: [mycode]

// functions.php
function mycode_func() {
    return 'пользовательский текст';	
}
 
add_shortcode('mycode', 'mycode_func');

При редактирования поста вместо кода [mycode] появится «пользовательский текст».

Пример 2: [mycode param1=10 param2=20]

Параметры передаются через переменную $attr.

// functions.php
function mycode_func($atts) {
    $res = $atts['param1'] + $atts['param2'];
    return 'Результат: '.$res;
}
 
add_shortcode('mycode', 'mycode_func');

При редактирования поста вместо кода [mycode param1=10 param2=20], появится текст «Результат: 30».

Через shortcode_atts() можно назначить значения по умолчанию.

# functions.php
function mycode_func($atts) {
    shortcode_atts([
        'param1' => 'default value 1',
        'param2' => 'default value 2',
    ], $atts);
    ...
}

Пример 3: [bold]content[/bold]

Текст, который включён «внутри» шорткода, доступен через переменную $content.

# functions.php
function get_bold($atts, $content) {
    return '<strong>'.$content.'</strong>';
}
 
add_shortcode('bold', 'get_bold');

Вывести значение шорткода в исходном коде

Вывести shortcode в файле шаблона можно через функцию do_shortcode().

echo do_shortcode('[mycode]');

Появление shortcode: Wordpress 2.5