add_shortcode()

add_shortcode( string $tag, callable $callback )

<?php
// Функция обратного вызова для шорткода [my_shortcode]
function my_shortcode_callback( $atts, $content, $shortcode_tag ) {
    // Обработка атрибутов шорткода
    $atts = shortcode_atts( array(
        'attr1' => 'default value',
        'attr2' => 'default value',
    ), $atts );
    // Вывод содержимого шорткода
    $output = 'Атрибут 1: ' . $atts['attr1'] . '<br>';
    $output .= 'Атрибут 2: ' . $atts['attr2'] . '<br>';
    $output .= 'Содержимое шорткода: ' . $content;
    return $output;
}
// Регистрация шорткода [my_shortcode]
add_shortcode( 'my_shortcode', 'my_shortcode_callback' );
?>

add_shortcode( 'hello', 'hello_shortcode' );
function hello_shortcode() {
    return 'Hello, world!';
}

add_shortcode( 'greeting', 'greeting_shortcode' );
function greeting_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'name' => 'Guest',
    ), $atts );
    return 'Hello, ' . $atts['name'] . '!';
}

add_shortcode( 'uppercase', 'uppercase_shortcode' );
function uppercase_shortcode( $atts, $content = null ) {
    if ( $content ) {
        return strtoupper( $content );
    }
}

add_shortcode( 'current_shortcode', 'current_shortcode' );
function current_shortcode( $atts, $content = null, $shortcode_tag ) {
    return 'This shortcode is: ' . $shortcode_tag;
}

Вопросы и ответы

Как создать новый шорткод?

Для создания нового шорткода в WordPress используется функция add_shortcode(). Она принимает два обязательных параметра: $tag (строка) и $callback (функция обратного вызова).

Первый параметр $tag представляет собой тег шорткода, который будет искаться в содержимом поста. Это может быть любая строка, например, «my_shortcode».

Второй параметр $callback — это функция, которая будет выполняться, когда шорткод будет найден. Функция обратного вызова должна быть определена заранее и принимать три параметра по умолчанию: массив атрибутов ($atts), содержимое шорткода или null, если оно не задано ($content), и имя шорткода ($shortcode_tag).

function my_shortcode_callback($atts, $content, $shortcode_tag) {
    // Ваш код обработки шорткода здесь
}
add_shortcode('my_shortcode', 'my_shortcode_callback');

Как передать атрибуты в шорткод?

Атрибуты шорткода могут быть переданы в функцию обратного вызова через массив $atts. Этот массив содержит пары ключ-значение, где ключ — это имя атрибута, а значение — его значение.

Например, если у вас есть шорткод [my_shortcode name="John" age="30"], то в функции обратного вызова вы можете получить значения атрибутов следующим образом:

function my_shortcode_callback($atts, $content, $shortcode_tag) {
    $name = $atts['name']; // "John"
    $age = $atts['age']; // "30"
    // Ваш код обработки шорткода здесь
}
add_shortcode('my_shortcode', 'my_shortcode_callback');

Как получить содержимое шорткода?

Содержимое шорткода может быть получено в функции обратного вызова через параметр $content. Если содержимое шорткода не задано, то значение этого параметра будет равно null.

Например, если у вас есть шорткод [my_shortcode]Hello World![/my_shortcode], то в функции обратного вызова вы можете получить содержимое следующим образом:

function my_shortcode_callback($atts, $content, $shortcode_tag) {
    $content; // "Hello World!"
    // Ваш код обработки шорткода здесь
}
add_shortcode('my_shortcode', 'my_shortcode_callback');

Как получить имя шорткода внутри функции обратного вызова?

Имя шорткода может быть получено в функции обратного вызова через параметр $shortcode_tag.

Например, если у вас есть шорткод [my_shortcode], то в функции обратного вызова вы можете получить имя шорткода следующим образом:

function my_shortcode_callback($atts, $content, $shortcode_tag) {
    $shortcode_tag; // "my_shortcode"
    // Ваш код обработки шорткода здесь
}
add_shortcode('my_shortcode', 'my_shortcode_callback');

Как использовать шорткод внутри другого шорткода?

Функция add_shortcode() в WordPress позволяет создавать и использовать шорткоды для удобного и быстрого добавления дополнительного функционала на страницы или записи сайта. Иногда возникает необходимость использовать один шорткод внутри другого. В таком случае, нужно учитывать порядок выполнения шорткодов.

Для того чтобы использовать шорткод внутри другого шорткода, необходимо убедиться, что второй шорткод будет обработан после первого. Для этого можно воспользоваться фильтром do_shortcode_tag.

// Первый шорткод
function first_shortcode_callback( $atts ) {
    // Код обработки первого шорткода
}
add_shortcode( 'first_shortcode', 'first_shortcode_callback' );
// Второй шорткод
function second_shortcode_callback( $atts ) {
    // Код обработки второго шорткода
    $content = do_shortcode( $atts['content'] ); // Обработка вложенного шорткода
    return $content;
}
add_shortcode( 'second_shortcode', 'second_shortcode_callback' );
// Использование вложенных шорткодов
echo do_shortcode( '[second_shortcode]Some text [first_shortcode][/second_shortcode]' );

Как проверить, существует ли шорткод с определенным тегом?

Иногда возникает необходимость проверить, существует ли шорткод с определенным тегом, перед его использованием. Для этого можно воспользоваться функцией shortcode_exists().

// Проверка существования шорткода
if ( shortcode_exists( 'my_shortcode' ) ) {
    // Код, выполняемый при наличии шорткода
}

Как удалить существующий шорткод?

Иногда возникает необходимость удалить существующий шорткод, например, при разработке плагина или темы. Для этого можно воспользоваться функцией remove_shortcode().

// Удаление существующего шорткода
remove_shortcode( 'my_shortcode' );

Как изменить порядок выполнения шорткодов на странице?

По умолчанию, шорткоды выполняются в порядке их обнаружения на странице. Иногда возникает необходимость изменить порядок выполнения шорткодов. Для этого можно воспользоваться фильтром do_shortcode_tag.

// Изменение порядка выполнения шорткодов
function custom_shortcode_order( $tags ) {
    $tags = array_reverse( $tags ); // Изменение порядка выполнения шорткодов
    return $tags;
}
add_filter( 'do_shortcode_tag', 'custom_shortcode_order' );

Функция add_shortcode() в WordPress предоставляет удобный способ добавления новых шорткодов на страницы или записи сайта. Она позволяет использовать шорткоды внутри других шорткодов, проверять и удалять существующие шорткоды, а также изменять порядок выполнения шорткодов на странице. Это значительно расширяет возможности разработчиков и позволяет создавать более гибкий и функциональный контент для пользователей.