What this solution does
The Holiday Hunt module guides visitors through several pages of the site. During the active holiday period, a small item appears in the corner of the screen selected by the administrator: a Christmas ornament, heart, star, flower, or carnation. A counter displaying the number of found items is shown nearby. The item does not cover menus, buttons, or forms.
When a visitor clicks the item, no new item appears on the same page. Refreshing the page does not count the find again. To collect the full set, users must navigate to other pages. A short caption next to the item explains the action, shows the current count, and announces the prize at the end. If the item on the current page has already been found, the caption indicates that the next image is available on another page.
The caption includes a refusal link labeled "I do not want to participate." After clicking it, the hunt no longer appears in that browser, and any found items are not counted, including in other holiday events.
Once all items are collected, a prize window opens displaying a short congratulatory message, the website owner's text, a promo code with a copy function, and a transition button. The button appears only if a link is specified in the settings. The window closes via a close icon, but the system requests user confirmation before closing to prevent accidental loss of the prize. The same prize window reappears on subsequent visits.
After installation, no holiday is enabled by default, and the public part of the site remains unchanged. The list includes New Year, February 14, February 23, March 8, and May 9. Each holiday has its own dates, illustrations, and prize. Dates and names can be edited, images replaced, and custom holidays added to the same list. A custom holiday remains disabled until explicitly activated.
Only one enabled holiday can be active on the site per day, provided the current date falls within its period. If holiday periods overlap, the one starting later takes precedence. Progress from one holiday does not carry over to another. As long as the holiday name and dates remain unchanged, the hunt cannot be repeated; the visitor is shown the already claimed prize again.
Functional limitations
The module does not support ranking systems, does not conduct raffles, and does not issue unique codes to individual visitors.
The SOLODIX "Holiday Hunt: Items and Promo Code" module displays pre-configured text, codes, or links. It does not generate promo codes, validate them, or insert them into the shopping cart. A single code is issued to all participants who complete the hunt during a specific holiday event.
The hunt interface is hidden from the administrative panel, shopping cart, checkout process, personal account, and any addresses listed in the exclusion list. On mobile devices, the hunt display can be disabled or kept active.
User progress is stored locally within the visitor's browser. The module does not collect personal data and does not communicate with external services.
Operation requires an up-to-date version of "1C-Bitrix: Site Management", PHP 8.2 or newer, and UTF-8 encoding. Support for Windows-1251 encoding and PHP 7 is not provided.
If “Holiday Hunt: Items and Promo Code” is required, General iT can help with installation, configuration and a technical check after integration.