Описание функции wp_star_rating()
Функция wp_star_rating() отображает рейтинг в виде звезд, который может быть использован для оценки товаров, записей или других объектов в WordPress.
Функция позволяет указать количество звезд и текущий рейтинг, что делает её полезной для отображения пользовательских оценок.
Параметры
$rating
Тип: int
Обязательный: Да
Описание: Текущий рейтинг, который будет отображен в виде звезд
Возможные значения:
min: 0
max: 5
$max
Тип: int
Обязательный: Нет
По умолчанию: 5
Описание: Максимальное количество звезд для рейтинга
Возможные значения:
min: 1
max: 10
$echo
Тип: bool
Обязательный: Нет
По умолчанию: true
Описание: Если true, результат будет немедленно выведен, если false, возвращается строка
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string|void
Описание: Возвращает HTML-код для отображения звездного рейтинга или ничего, если echo=true
Возможные значения:
• HTML-код для отображения звезд
• void если echo=true
Примеры использования
Отображение рейтинга 4 из 5 звезд
wp_star_rating(4);
Результат будет выведен на экран
Возвращение HTML-кода для рейтинга 3 из 10 звезд
$rating_html = wp_star_rating(3, 10, false);
// Здесь $rating_html содержит HTML-код для рейтинга 3 из 10 звезд
Результат не выводится на экран
Безопасность
Валидация входных данных: Входные параметры проходят валидацию на допустимые значения
Санитизация: Входные данные автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода значений рейтинга
— Связанные функции
Получает метаданные записи, включая пользовательские рейтинги
Отображает рейтинг для записей, товаров и других объектов с дополнительной функциональностью
— Хуки
Фильтрует HTML-код перед выводом рейтинга
— Примечания
– Ограничения
Не поддерживает динамическое обновление рейтинга без перезагрузки страницы
– Частые проблемы
- Неверный вывод при использовании неправильных значений rating и max
- Не отображается, если значения выходят за пределы допустимого диапазона
