PG Wheel — интерактивный модуль «Колесо фортуны» для Joomla 5. Он помогает проводить акции и розыгрыши на сайте, привлекать внимание посетителей, собирать контактные данные участников и сохранять результаты вращений. Вы самостоятельно задаёте призы, настраиваете вероятность их выпадения, выбираете внешний вид колеса и определяете, как оно будет появляться на сайте.
PG Wheel — настройте розыгрыш под свой сайт
Колесо можно встроить непосредственно в страницу, открыть во всплывающем окне, показывать через плавающую кнопку или запускать в полноэкранном режиме. Внешний вид настраивается в визуальном редакторе, а призы — в отдельном редакторе секторов. Дополнительно можно использовать новый шаблон «Компактное колесо» с частично видимым кругом, боковой неподвижной стрелкой и выделением активного сектора.
Иллюстрация принципа работы. Сектора, надписи и цвета на вашем сайте задаются в настройках модуля.
Быстрый старт: как создать колесо
- Установите пакет PG Wheel через менеджер расширений Joomla 5.
- Откройте «Модули сайта» и создайте модуль «Колесо фортуны».
- Укажите заголовок, текст-приглашение и надпись на кнопке вращения.
- Добавьте призы в редакторе секторов и задайте вес каждого приза.
- Выберите режим отображения и настройте форму контактов.
- Откройте визуальный редактор, выберите тему и проверьте результат.
- Опубликуйте модуль и назначьте нужные пункты меню Joomla.
В комплект входят модуль сайта и компонент PG Wheel для серверной обработки розыгрышей, заявок и просмотра статистики.
Новый шаблон отображения «Компактное колесо»
Для сценариев, когда на странице важно оставить больше свободного места, предусмотрен отдельный компактный вариант оформления. Это не то же самое, что настройка ширины всплывающего окна «Компактное до 760 px»: шаблон меняет сам способ визуального представления колеса.
Схема компактного отображения
Условная схема принципа компактного отображения, не скриншот административной панели.
Как устроен компактный вариант
- Частично видимое колесо: в видимой области находится примерно половина круга, остальная часть скрыта за границей блока.
- Неподвижная стрелка: указатель расположен сбоку и остаётся на месте, пока вращается колесо.
- Выделение активного сектора: сектор под указателем получает более яркую заливку и контрастное визуальное выделение.
- Экономия места: компактная композиция подходит для узких областей страницы и промо-блоков, где полноразмерное колесо занимает слишком много пространства.
Как настроить
- Откройте нужный модуль «Колесо фортуны» в административной панели Joomla.
- Перейдите к параметрам оформления / шаблона отображения.
- Выберите вариант «Компактное колесо» (если он добавлен в используемую сборку модуля).
- Проверьте положение бокового указателя, видимую часть колеса и контраст активного сектора.
- Сохраните модуль и проверьте результат на опубликованной странице, в том числе на мобильном устройстве.
Важно: компактный шаблон — отдельный вариант визуального отображения колеса. Параметр «Ширина окна: Компактное (до 760 px)» только ограничивает ширину окна и сам по себе не включает частично скрытое колесо. Точное название поля и расположение переключателя зависят от сборки, в которую включён новый шаблон.
Настройка призов и секторов
В редакторе можно добавлять и редактировать сектора. Для каждого указываются название, вес выпадения, цвет, тип результата, значение приза, а также изображение и описание, если они нужны.
Редактор секторов — пример заполнения
Демонстрационный макет
| Приз | Вес | Цвет | Тип |
|---|---|---|---|
| Скидка 5% | 35 | #649728 | Скидка |
| Скидка 10% | 25 | #003c4e | Скидка |
| Подарок | 10 | #e9b949 | Подарок |
| Попробуйте ещё | 30 | #dce8d0 | Без выигрыша |
Как работает вес? Вес — относительная величина, влияющая на вероятность выпадения сектора. Например, при весах 35, 25, 10 и 30 сумма равна 100, поэтому значения соответствуют 35%, 25%, 10% и 30%. Если сумма другая, доля каждого сектора рассчитывается относительно общей суммы весов.
Числа в таблице — пример демонстрационного розыгрыша, а не предустановленные обязательные значения.
Визуальный редактор оформления
Оформление настраивается без ручного редактирования CSS. В редакторе предусмотрены готовые визуальные темы, сезонные оформления, цвета, фоновые изображения, параметры колеса, указатель, типографика, анимация и внешний вид результата.
Дополнительно доступны темы и сезонные шаблоны оформления, включая праздничные варианты. Можно менять цвета секторов, текста, обода, указателя, центральной части, кнопок и формы; выбирать форму и положение указателя; настраивать шрифты, размеры, скругления, тени и интенсивность анимации.
Для фона предусмотрены встроенные варианты «Изумруд и золото», «Слоновая кость и шампань», «Полночь и бирюза», а также загрузка собственных изображений. Пользовательский фон имеет приоритет над встроенным. Можно задать масштаб, положение, прозрачность, текстуру и затемнение.
Цветовые названия выше — иллюстрация палитры тем. Это не скриншот панели администратора. Реальные названия параметров и доступные значения определяются редактором установленной версии.
Режимы отображения
| Режим | Как работает |
|---|---|
| Встроенный | Колесо отображается в выбранной позиции страницы как обычный блок. |
| Всплывающее окно | Открывает колесо поверх страницы в модальном окне. |
| Плавающая кнопка | На странице видна компактная кнопка запуска; по нажатию открывается окно розыгрыша. |
| Полноэкранный | Колесо открывается на весь экран. |
Для popup можно настроить ширину окна: компактную (до 760 px), обычную (до 920 px), широкую (до 1160 px), очень широкую (до 1380 px) или на всю ширину. Также задаются расположение колеса, горизонтальная или вертикальная компоновка, внутренний отступ и расстояние между колесом и формой.
Для плавающей кнопки доступны варианты формы, положения по краям экрана, иконка (колесо, подарок, билет или без иконки), размер, отступы, ширина и анимация.
Сбор контактов участников
Форму участия можно включить или отключить. Доступен запрос имени, телефона и email. Контакт можно запросить до вращения или после выигрыша. Настраиваются заголовок, описание и текст кнопки формы, а также расположение формы относительно колеса: справа, слева или под ним.
Можно включить обязательное согласие и задать собственный текст согласия на обработку персональных данных. Для уведомлений о выигрышах указывается email администратора; если поле не заполнено, используется почта сайта Joomla.
Перед запуском розыгрыша проверьте текст согласия и содержание политики обработки персональных данных вашего сайта.
Управление результатами и участниками
Компонент PG Wheel содержит панель управления, в которой отображаются общие показатели: количество вращений, сохранённых участников, вращений за текущий день и опубликованных модулей.
В панели доступны последние контакты участников и история розыгрышей. Контакты можно экспортировать в CSV для дальнейшей работы.
В записях участника сохраняются имя, email, телефон, приз, идентификатор результата, отметка о согласии, идентификатор модуля и дата создания.
Мобильная версия
Модуль адаптируется под небольшие экраны. Для мобильного отображения предусмотрены отдельный размер колеса, ширина окна, внутренние отступы и вариант компоновки. Можно выбрать вертикальное расположение элементов или горизонтальный вариант там, где он подходит по ширине. Плавающую кнопку можно отдельно показывать или скрывать на мобильных устройствах.
Как выглядят настройки модуля
Ниже — наглядные макеты основных групп параметров. Они собраны по установочному XML и редакторам версии 0.9.23, чтобы показать логику настройки до установки расширения.
Колесо фортуны — основные параметры
Joomla · mod_pgwheel
Основные настройки · Призы · Оформление · Дополнительно
| Параметр | Пример значения |
|---|---|
| Заголовок | Испытай удачу! |
| Текст кнопки | Крутить колесо |
| Режим отображения | Всплывающее окно |
| Ширина окна | Широкое (до 1160 px) |
| Максимум вращений за сессию | 1 |
| Размер колеса | 420 px |
Контакты и форма участия
| Параметр | Пример значения |
|---|---|
| Показывать форму контактов | Да |
| Когда запрашивать контакт | До вращения |
| Запрашивать имя | Нет |
| Запрашивать телефон | Да |
| Расположение формы | Справа от колеса |
| Обязательное согласие | Да |
Визуальный редактор
Темы · Фоны · Колесо · Текст · Анимация · Результат · Адаптивность
| Параметр | Варианты |
|---|---|
| Готовая тема | Emerald / Ocean / Gold / Ruby / Midnight / Candy |
| Фон панели | Свой фон / Встроенный фон |
| Форма указателя | Треугольник / Стрелка / Шеврон / Pin / Круг |
| Эффект вращения | Плавный / Резкий / Классический |
Это демонстрационные макеты экранов настроек, а не фотографии административной панели. Названия параметров и варианты выбора взяты из исходного пакета PG Wheel v0.9.23; фактический вид панели зависит от интерфейса Joomla.
Часто задаваемые вопросы
Чем шаблон «Компактное колесо» отличается от компактной ширины окна?
Это разные настройки. Компактная ширина ограничивает максимальную ширину окна (до 760 px). Шаблон «Компактное колесо» меняет композицию самого колеса: примерно половина круга остаётся видимой, боковой указатель неподвижен, а активный сектор выделяется цветом и контрастом.
Как работает боковая стрелка в компактном колесе?
Стрелка закреплена сбоку и не вращается вместе с колесом. Во время остановки она указывает на сектор, который определяет результат розыгрыша.
Почему активный сектор выделен ярче остальных?
Дополнительная яркость и контрастная граница помогают посетителю быстро увидеть сектор под указателем и понять результат остановки.
Можно ли использовать компактное колесо на мобильных устройствах?
После выбора шаблона обязательно проверьте его на смартфоне: видимая часть круга, боковой указатель и активный сектор должны оставаться различимыми, а содержимое не должно создавать горизонтальную прокрутку.
Для какой версии Joomla предназначен PG Wheel?
Пакет v0.9.23 подготовлен для Joomla 5. Не устанавливайте его на другие основные версии Joomla без отдельной проверки совместимости.
Что входит в установочный пакет?
В комплект входят модуль сайта mod_pgwheel и компонент com_pgwheel. Модуль отвечает за отображение колеса и настройки, компонент — за серверную обработку розыгрышей, заявок и административную панель.
Можно ли создать несколько разных розыгрышей?
Можно создавать отдельные экземпляры модуля с собственными параметрами. Для каждого экземпляра настраиваются заголовок, сектора, режим показа, оформление и форма участия.
Как рассчитывается вероятность выигрыша?
Вероятность зависит от веса сектора относительно суммы весов всех секторов. Чем выше вес, тем выше доля выпадения этого сектора. Вес не является гарантией конкретного результата на короткой серии вращений.
Можно ли добавить собственные призы?
Да. В редакторе секторов задаются название, вес, цвет, тип и значение приза. Также предусмотрены поля для изображения и описания сектора.
Можно ли запросить контакты до вращения?
Да. В параметре момента запроса контакта выберите «До вращения». Альтернативный вариант — запросить контакт после выигрыша.
Можно ли ограничить количество вращений?
Да. Параметр «Максимум вращений за сессию» задаёт лимит попыток для посетителя в пределах сессии браузера.
Можно ли показывать окно не сразу?
Да. Для всплывающего окна задаётся задержка в секундах. Частота показа может быть при каждом открытии страницы, один раз за сессию браузера или один раз в сутки.
Как изменить дизайн колеса?
Откройте визуальный редактор в параметрах модуля. Выберите тему или шаблон, настройте цвета, фон, указатель, обод, центр, типографику, анимацию и отображение результата. Для фонового оформления можно загрузить собственное изображение.
Что делать, если собственное фоновое изображение не видно?
Проверьте, что изображение загружено и выбраны подходящие масштаб и положение. Пользовательское изображение имеет приоритет над встроенным фоном темы; при необходимости проверьте прозрачность и затемнение.
Где посмотреть контакты и результаты?
Откройте компонент PG Wheel в административной панели Joomla. В нём доступны таблицы участников и истории розыгрышей, а список контактов можно выгрузить в CSV.
Можно ли изменить вид плавающей кнопки?
Да. Выберите форму кнопки, её положение, иконку, размеры, отступы и анимацию. Для мобильных устройств предусмотрен отдельный переключатель видимости.
Почему результат розыгрыша не совпадает с ожиданиями?
Проверьте веса всех секторов и их сумму, а также убедитесь, что тестируете опубликованный экземпляр нужного модуля. При оценке вероятностей учитывайте, что случайный результат отдельного вращения не обязан совпадать с процентом на небольшой выборке.
Как обновить модуль?
Перед обновлением сделайте резервную копию сайта и базы данных. Сохраните текущие настройки модулей и установите пакет обновления, предназначенный для вашей версии Joomla.
PG Wheel v0.9.23
Создайте собственную механику розыгрыша, настройте призы и оформление, выберите удобный способ показа колеса и собирайте заявки участников в административной панели Joomla.
Разработчик: Параллель ГРУПП · p-gp.ru
Платформа: Joomla 5.
