Шорткоди та HTML-блоки дають змогу швидко додавати на сторінки кнопки, форми, таблиці й динамічний контент. Але кожен механізм, який приймає або виводить HTML, може стати точкою для XSS-атаки — особливо якщо дані надходять від авторів, редакторів, відвідувачів або сторонніх інтеграцій.
Основне правило безпечної роботи з WordPress таке: санітизація потрібна під час збереження даних, а екранування — безпосередньо перед виведенням. Це різні етапи, і один не замінює інший. Нижче — практична схема перевірки шорткодів, HTML у Elementor та прав користувачів.
Чому шорткод може стати вразливістю XSS
Шорткод сам по собі не є небезпечним. Ризик виникає в його callback-функції — коді, який обробляє атрибути та формує HTML для сторінки. Якщо callback виводить значення атрибутів без перевірки, зловмисник може передати JavaScript або небезпечні HTML-атрибути.
Проблема особливо серйозна, коли редагувати записи можуть не лише адміністратори. Якщо користувач із розширеними правами вставить шкідливий код у запис, він може виконуватися в браузерах інших адміністраторів або відвідувачів. Це називають stored XSS — збереженою міжсайтовою скриптовою атакою.
Не варто вважати адмін-панель автоматично безпечною зоною. Дані з полів налаштувань, метаполів, імпортів, API, форм і шорткодів можуть потрапити на фронтенд, у листи або в JavaScript-контекст.
- Не виводьте атрибути шорткода без esc_attr().
- Не виводьте звичайний текст без esc_html().
- Не дозволяйте довільний HTML, якщо для цього немає чіткої потреби.
- Перевіряйте не лише сторінки, а й віджети, архіви, шаблони та AJAX-відповіді.
Розмежуйте санітизацію та екранування
Санітизація очищає або нормалізує дані під час їх отримання чи збереження. Наприклад, для короткого текстового поля можна використати sanitize_text_field(), для URL — esc_url_raw(), для числа — absint(). Санітизація зменшує ризик збереження некоректних даних, але не скасовує потребу в екрануванні.
Екранування виконується в момент виведення і залежить від контексту. Текст, HTML-атрибут, URL та JavaScript-контекст потребують різних функцій. Не існує однієї універсальної функції, яку можна безпечно застосувати всюди.
Якщо поле повинно містити обмежений HTML, використовуйте wp_kses() або wp_kses_post() безпосередньо перед виведенням. Дозволений набір тегів має відповідати реальній задачі, а не бути максимально широким.
- Звичайний текст: esc_html().
- Значення HTML-атрибута: esc_attr().
- URL у HTML: esc_url() під час виведення та esc_url_raw() під час збереження.
- Обмежений HTML у вмісті запису: wp_kses_post() або wp_kses() із власним списком тегів.
- Числові значення: перевірка типу, наприклад absint(), а не просте екранування рядка.
Приклад безпечного callback для шорткода
У прикладі нижче заголовок виводиться як текст, URL — як атрибут посилання, а опис — як дозволений HTML. Важливо також не довіряти атрибутам шорткода: їх потрібно нормалізувати та обмежити допустимими значеннями.
function webhva_button_shortcode( $atts, $content = null ) {
$atts = shortcode_atts(
array(
'url' => '',
'title' => 'Перейти',
),
$atts,
'webhva_button'
);
$url = esc_url( $atts['url'] );
$title = esc_html( $atts['title'] );
$text = wp_kses_post( $content ?? '' );
if ( empty( $url ) ) {
return '';
}
return sprintf(
'<a class="button" href="%1$s" aria-label="%2$s">%3$s</a>',
$url,
$title,
$text
);
}
Безпечна робота з атрибутами шорткодів
Атрибути шорткода — це введені користувачем дані, навіть якщо поле виглядає як частина шаблону. Не вставляйте їх у HTML через конкатенацію без обробки. Також не варто дозволяти атрибутам визначати довільні CSS-класи, назви файлів, URL або параметри запитів без білого списку.
Для значень, що мають обмежений набір варіантів, використовуйте allowlist. Наприклад, розмір кнопки може бути лише small, medium або large. Для URL перевіряйте схему й не дозволяйте небезпечні протоколи на кшталт javascript:.
Якщо шорткод приймає числовий ID запису, перетворіть його на ціле число та перевірте, чи має поточний користувач право бачити відповідний контент. Екранування не замінює перевірку авторизації.
- Задавайте значення за замовчуванням через shortcode_atts().
- Перевіряйте тип і допустимий діапазон кожного параметра.
- Для режимів, стилів і статусів використовуйте список дозволених значень.
- Не виводьте необроблені атрибути в style, onmouseover, onclick або інші event-атрибути.
- Не формуйте SQL-запити, shell-команди чи імена файлів без окремої валідації.
Чому небезпечно передавати введення напряму в do_shortcode()
do_shortcode() призначена для обробки рядка, у якому вже міститься контрольований вміст із шорткодами. Якщо передати туди довільний текст від користувача, цей текст може бути інтерпретований як шорткод. У результаті користувач отримає доступ до функціональності, яку розробник не планував відкривати в цьому місці.
Ризик залежить від зареєстрованих шорткодів. Один із них може виконувати зовнішній запит, показувати приватні дані, створювати форму або змінювати стан системи. Навіть якщо це не призводить безпосередньо до XSS, виникає проблема несанкціонованої функціональності.
Якщо обробка шорткодів справді потрібна, спочатку обмежте джерело даних і контекст. Для звичайного тексту краще використовувати esc_html(), а не do_shortcode(). Для контрольованого редакторського контенту застосовуйте wp_kses_post() і дозвольте шорткоди лише користувачам із відповідними правами.
- Не передавайте в do_shortcode() значення з публічних форм без чіткої перевірки.
- Не дозволяйте користувачу вибирати довільну назву шорткода.
- Не використовуйте do_shortcode() як спосіб «відрендерити будь-який текст».
- Перегляньте сторонні шорткоди, які можуть викликатися через редакторський контент.
Ролі WordPress і HTML у Elementor
HTML і JavaScript-вміст мають бути доступні лише тим користувачам, яким ви справді довіряєте. У WordPress можливість вставляти необмежений HTML пов’язана з capability unfiltered_html. Не надавайте її авторам і редакторам без необхідності: у разі компрометації такого облікового запису зловмисник зможе зберегти небезпечний код.
У Elementor HTML-віджет та інші елементи, що дозволяють вставляти довільний код, слід обмежити адміністраторами або спеціально визначеною групою довірених користувачів. Точний спосіб керування залежить від конфігурації WordPress, Elementor і додаткових засобів керування ролями, тому перевіряйте не лише налаштування редактора, а й фактичні права тестового користувача.
Важливо враховувати, що обмеження ролі не очищає вже збережений контент. Після зміни прав потрібно перевірити старі сторінки, шаблони, глобальні віджети, попапи та інші місця, де міг залишитися HTML або JavaScript.
- Принцип найменших привілеїв: користувач отримує лише ті права, які потрібні для роботи.
- Перевірте ролі авторів, редакторів, менеджерів магазину та користувачів із кастомними capabilities.
- Після зміни ролей протестуйте створення, редагування та публікацію HTML-контенту.
- Періодично переглядайте активні облікові записи й видаляйте непотрібні права.
- Не вставляйте сторонні скрипти в HTML-віджети без перевірки джерела та призначення.
Як перевірити шорткоди й HTML на практиці
Перевірку краще проводити не лише читанням коду, а й у тестовому середовищі. Створіть окремий обліковий запис із роллю автора або редактора та перевірте, що він може вставити, зберегти й опублікувати. Потім відкрийте сторінку в іншому браузері або в приватному режимі.
Для кожного параметра протестуйте звичайне значення, лапки, HTML-теги, події JavaScript, URL із небезпечними протоколами та дуже довгі рядки. Не використовуйте шкідливі payloads на робочому сайті: перевірку проводьте на копії або в staging-середовищі.
Після оновлення плагінів, зміни ролей або міграції сайту повторіть аудит. Окремо перевірте контент, створений до впровадження санітизації: старі дані могли зберегтися в базі в небезпечному вигляді.
- Знайдіть усі реєстрації шорткодів і перегляньте їхні callback-функції.
- Перевірте, чи є екранування в тому самому місці, де формується HTML.
- Перегляньте поля налаштувань, метаполя, імпорти та AJAX-обробники.
- Перевірте контент Elementor, включно з шаблонами та глобальними елементами.
- Переконайтеся, що помилки вхідних даних не показують необроблений користувацький текст.
- Після тестування очистіть демонстраційні записи та відкличте тимчасові права.
Типові помилки розробників
Найчастіша помилка — санітизувати значення один раз під час збереження й вважати його безпечним назавжди. Дані можуть бути змінені іншим кодом, імпортовані з бази або виведені в іншому контексті. Тому екранування має залишатися безпосередньо перед виведенням.
Інша помилка — використання esc_html() для HTML, який потрібно зберегти. Ця функція перетворить теги на текст. І навпаки, wp_kses_post() не є заміною для esc_attr(), якщо значення вставляється в атрибут.
- Одна функція екранування для всіх контекстів.
- Довіра до даних лише тому, що вони прийшли з адмін-панелі.
- Надання unfiltered_html усім редакторам «для зручності».
- Динамічне формування шорткодів із введення користувача.
- Перевірка лише нового контенту без аудиту старих сторінок.
Поширені запитання
Чи достатньо використовувати wp_kses_post() для захисту всіх шорткодів?
Ні. wp_kses_post() підходить для дозволеного HTML у текстовому контенті, але не замінює esc_attr() для атрибутів, esc_url() для URL, перевірку прав доступу та валідацію типів даних.
Чи можна дозволити редакторам вставляти HTML у WordPress?
Лише якщо це виправдано процесом роботи та користувачам можна довіряти. Краще надати обмежені можливості й заборонити unfiltered_html тим ролям, яким не потрібен довільний HTML або JavaScript.
Чи небезпечний сам текст із shortcode-синтаксисом?
Текст не обов’язково небезпечний, але передача його в do_shortcode() може активувати зареєстровані шорткоди. Якщо потрібно показати текст як текст, виводьте його через esc_html(), а не обробляйте як шорткод.
Де обмежувати HTML-віджет Elementor?
Обмеження потрібно встановити на рівні ролей і доступних можливостей редактора, залишивши довільний HTML лише адміністраторам або окремій довіреній групі. Після цього перевірте доступ тестовим користувачем і перегляньте вже збережені шаблони.
Чи потрібно екранувати дані, якщо поле доступне лише в адмін-панелі?
Так. Дані з адмін-панелі можуть потрапити на фронтенд, у листи, REST-відповіді або інші контексти. Санітизація під час збереження та екранування під час виводу мають виконуватися незалежно від того, хто заповнює поле.
Висновок
Безпечні шорткоди будуються не навколо однієї функції, а навколо правильної моделі доступу та обробки даних. Обмежуйте ролі, не дозволяйте необмежений HTML без потреби, перевіряйте атрибути й використовуйте екранування відповідно до контексту.
Для WordPress та Elementor особливо важливі регулярний аудит старого контенту, контроль HTML-віджетів і відмова від передачі довільного введення в do_shortcode(). Санітизуйте дані під час збереження, екрануйте їх під час виводу та тестуйте сайт очима користувача з мінімальними правами.