Проверка существования шорткода с помощью функции shortcode_exists()

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

Описание функции

• Версия: 3.6.0
• Время выполнения:
  • 1 раз — 0.000011 сек (очень быстро)
  • 50000 раз — 0.02 сек (практически мгновенно)
• Требуемая версия PHP: 7.1.5 и выше
• Не имеет хуков.

Возвращаемое значение

Функция возвращает true, если шорткод существует, и false, если нет.

Синтаксис

shortcode_exists( $tag );

• Параметр $tag (строка, обязательный): Название шорткода, который нужно проверить.

Примеры использования

Проверка существования шорткода "gallery"

if ( shortcode_exists( 'gallery' ) ) {
    // Шорткод  зарегистрирован.
}

Пояснение примера

В данном коде мы проверяем, зарегистрирован ли шорткод "gallery". Если он существует, мы можем безопасно его использовать в нашем коде.

Примечания

• Функция работает с глобальным массивом $shortcode_tags, который содержит все зарегистрированные шорткоды и их обработчики.

Код функции

Вот как выглядит реализация функции shortcode_exists() в WordPress:

function shortcode_exists( $tag ) {
global $shortcode_tags;
return array_key_exists( $tag, $shortcode_tags );
}

Заключение

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