Описание функции add_shortcode()
Функция add_shortcode() позволяет разработчикам регистрировать собственные шорткоды в WordPress. Шорткоды представляют собой специальные теги, которые могут быть использованы в контенте для динамического отображения данных или выполнения действий.
Функция принимает имя шорткода и соответствующую функцию, которая будет вызвана при его использовании в контенте.
Параметры
$tag
Тип: string
Обязательный: Да
Описание: Имя шорткода, который будет использоваться в контенте
Возможные значения:
$func
Тип: callable
Обязательный: Да
Описание: Функция, которая будет вызываться при использовании шорткода
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешной регистрации шорткода, false в противном случае
Возможные значения:
• true — если шорткод успешно зарегистрирован
• false — если шорткод не зарегистрирован (например, если имя шорткода уже используется)
Примеры использования
Создание простого шорткода, который выводит текст
function example_shortcode() {
return 'Hello, World!';
}
add_shortcode('example', 'example_shortcode');
// Вставка в контенте: [example]
Вывод: Hello, World!
Шорткод, который принимает параметр и выводит приветствие
function greeting_shortcode($atts) {
$atts = shortcode_atts(array(
'name' => 'Guest'
), $atts);
return 'Hello, ' . esc_html($atts['name']) . '!';
}
add_shortcode('greeting', 'greeting_shortcode');
// Вставка в контенте: [greeting name='John']
Вывод: Hello, John!
Безопасность
Валидация входных данных: Необходимо проверять входные параметры в функции шорткода
Санитизация: Используйте функции очистки, такие как esc_html() для вывода
Рекомендации: Избегайте выполнения потенциально опасных операций с данными, переданными через шорткоды
— Связанные функции
Выполняет шорткод и возвращает результат
Удаляет зарегистрированный шорткод
— Примечания
– Ограничения
Не может регистрировать шорткоды с одинаковыми именами
– Частые проблемы
- Шорткод не работает, если функция не определена
- Ошибки при использовании неверного имени шорткода
