Homepage Widgets
Widgets are configurable blocks in the storefront sidebar. The store owner adds them through the admin panel.
Path: Admin panel → Storefront Appearance → Widgets
Live Widgets (3 types)
Three widgets are currently implemented:
Discord Widget (DISCORD_WIDGET)
Embeds the official Discord server widget via iframe.
- Requires: Guild ID or invite link (
discord.gg/xxx) - Resolution: the invite link is resolved via the backend API
- Parameters: theme (
light/dark), width, height
The Discord server owner must enable "Server Widget" in server settings (Server Settings → Widget). Without this the widget will not load.
VK Group (VK_GROUP)
VKontakte community widget.
- Requires: Group ID
- Render: standard VK iframe
VK Messages (VK_MESSAGES)
VKontakte community messages widget — lets players message the group directly from the storefront.
- Requires: Group ID
- Render: VK Messages widget
Planned Widgets (15 types)
These types are defined in the system but do not yet have a storefront renderer (they return an empty block):
| Type | What it will show |
|---|---|
top_donors | Top donors |
online_counter | Server online count |
server_monitoring | Server status |
recent_purchases | Recent purchases |
wipe_countdown | Countdown to next wipe |
banner | Banner / image |
html_block | Arbitrary HTML |
text_block | Text block |
stats | Store statistics |
social_links | Social links |
categories_grid | Category grid |
youtube_video | YouTube video |
twitch_embed | Twitch stream |
flash_sale_banner | Flash sale banner |
custom_widget | Custom widget |
These types appear in the admin panel dropdown but render nothing on the storefront. Implementation is planned for future phases.
Adding a Widget
- Admin panel → Appearance → Widgets → "Add widget"
- Select a type (Discord / VK Group / VK Messages)
- Fill in the configuration fields
- Save
Widgets are sorted by position and displayed in the left rail of the storefront.
Permanent Blocks (not widgets)
Two blocks are always shown and are not configurable through widgets:
- ServersBlock — list of servers with online status (automatic)
- WipeWidget — countdown to the nearest wipe (if a schedule exists)
These appear at the top of the left rail, above user-added widgets.
Next Steps
- Theme and colors — appearance settings
- Static pages — content pages
- Custom CSS/JS — advanced customization