Holiday Theme Settings - Help Desk Guide¶
Feature Location: Admin Panel > Holiday Theme Settings
Configuration Storage: Settings saved in system_config table
Target Audience: All clients/business owners
Overview¶
The Holiday Theme Settings feature allows clients to add seasonal decorations to their website without any coding or technical knowledge. All settings are controlled through an easy-to-use admin interface with visual previews.
Available Options¶
1. Falling Snowflakes Effect¶
Configuration Key: snowflakes_enabled
Default Value: 0 (Disabled)
Options:
- Enabled (1): Animated snowflakes fall across the homepage
- Disabled (0): No snowflake animation
Display Location: Front page/homepage only
2. Red Ribbon Under Logo¶
Configuration Key: red_ribbon_enabled
Default Value: 0 (Disabled)
Options:
- Enabled (1): Displays decorative red ribbon underneath the business logo
- Disabled (0): No ribbon displayed
Display Location: Under the main logo in the header
3. Header Background Theme¶
Configuration Key: holiday_top_bg
Default Value: 0 (None)
Options:
| Value | Theme Name | Image File | Position | Description |
|---|---|---|---|---|
| 0 | None (Default) | - | N/A | No holiday theme |
| 1 | Snowflakes | snowflake51.jpg | Top | Snowflake pattern at top of navigation header |
| 2 | Garland | garland-1053452_1280-smaller.png | Top | Festive garland at top of navigation header |
| 3 | Fairy Lights (Regular) | fairy-lights-3-small.png | Top | Fairy lights at top of navigation header |
| 4 | Fairy Lights (Small) | fairy-lights-3-smallest.png | Top | Smaller fairy lights at top of navigation header |
| 5 | Wavy Garland (Top) | garland-wavy-sm.png | Top | Wavy garland at top of navigation header |
| 6 | Wavy Garland (Bottom) | garland-wavy-sm-bottom.png | Bottom | Wavy garland at bottom of navigation header |
| 7 | Decorative Garland (Bottom) | garland-dec.jpg | Bottom | Decorative garland at bottom of navigation header |
Display Location: Navigation header (either top edge or bottom edge depending on theme selected)
How Clients Can Access and Use¶
Step-by-Step Instructions¶
- Log into the admin panel
- Navigate to Holiday Theme Settings (menu item or direct URL:
/kiv/holiday-theme-settings.php) - Review the three sections:
- Falling Snowflakes Effect (radio buttons)
- Red Ribbon Under Logo (radio buttons)
- Header Background Theme (visual cards with previews)
- Select desired options by clicking radio buttons
- Click the "Save Holiday Theme Settings" button at the top or bottom of the page
- View the website in a new tab to see changes immediately
Toggling Settings¶
Clients can easily toggle back and forth between settings: - Keep the admin settings page open in one tab - Open their website in another tab - Make changes and save - Refresh the website tab to see updates
Common Support Questions¶
Q: Can I use multiple header themes at once?¶
A: No, only one header background theme can be active at a time. However, you can combine any header theme with the snowflakes effect and/or the red ribbon.
Q: How do I remove the holiday decorations after the season?¶
A: Simply return to Holiday Theme Settings and set all options to "Disabled" or "None," then click Save.
Q: Why don't I see the changes on my website?¶
A: Try the following: - Hard refresh the page (Ctrl+F5 or Cmd+Shift+R) - Clear browser cache - Check if the changes were saved (success message should appear) - Verify you're viewing the correct domain
Q: Can customers see these settings in their account?¶
A: No, this is an admin-only feature. Only business owners/administrators can control holiday themes.
Q: Do the holiday themes affect mobile devices?¶
A: Yes, the themes are responsive and will display appropriately on all devices including mobile phones and tablets.
Q: Will this slow down my website?¶
A: The header background images are lightweight and optimized. The snowflakes effect uses CSS animation which is hardware-accelerated and should not cause performance issues on modern devices.
Technical Details (For Support Team)¶
Configuration Storage¶
All settings are stored in the system_config table with the following keys:
- holiday_top_bg - Header background theme (0-7)
- snowflakes_enabled - Snowflakes effect (0 or 1)
- red_ribbon_enabled - Red ribbon (0 or 1)
Retrieving Values in Code¶
// Check if snowflakes are enabled
if (getConfig('snowflakes_enabled', '0') == '1') {
// Display snowflakes
}
// Check ribbon setting
if (getConfig('red_ribbon_enabled', '0') == '1') {
// Display ribbon under logo
}
// Get selected header theme
$theme = getConfig('holiday_top_bg', '0');
CSS Classes Applied¶
Based on the holiday_top_bg value, the following CSS classes are applied:
- .holiday1 through .holiday7 - Applied to body or container element
- Themes 1-5 target .sktopdiv (top of header)
- Themes 6-7 target .sktop (bottom of header)
Image Location¶
All holiday theme images are stored in: /images/
Logging¶
All changes are logged in the activity log with entries like: - "Holiday theme updated: 0 > 3" - "Snowflakes effect updated: 0 > 1" - "Red ribbon effect updated: 1 > 0"
Cache Clearing¶
The system automatically clears the APC cache for system_config when settings are saved, ensuring changes take effect immediately.
Troubleshooting¶
Issue: Settings save but don't appear on website¶
Possible causes:
- CSS class not being applied to correct element - check frontend code implementation
- Image files missing from /images/ directory
- CSS rules not defined or overridden by other styles
- Browser cache showing old version
Issue: Preview images not showing in admin¶
Possible causes:
- Image files missing from /images/ directory
- Incorrect file paths in theme array
- Permission issues on image files
Issue: Settings revert after saving¶
Possible causes:
- Database connection issue
- Permission issues on system_config table
- Form not submitting properly (check browser console for errors)
FAQ¶
When should clients enable these features?¶
Typically during the holiday season (November through early January), but clients can enable them whenever they want to add festive decorations to their site.
Are there plans to add more themes?¶
Additional themes can be added by uploading new images to the /images/ directory and updating the themes array in holiday-theme-settings.php.
Can clients upload their own custom holiday images?¶
Not currently through the UI. This would require a custom implementation or developer assistance to add custom images.
Related Documentation¶
- Admin Configuration Settings
- System Config Table Structure
- Frontend CSS Architecture