Podium
1. What this page is for
The Podium page is used to configure the featured top 3 games podium (ranks 1, 2, and 3) displayed prominently on the lobby home page. The podium captures players' attention the moment they enter the site. Administrators can choose whether each step is populated automatically by real gameplay ranking metrics, or locked to a specific promotional game chosen manually, or even combine both approaches on the same podium.
2. Before you start
- Permissions: You must have the 'Podium' permission (and 'Update game podium' for saving changes) granted by an administrator.
- What to prepare:
- Desired Thai and English headings (optional; defaults are used if left blank).
- List of games you wish to feature manually (games and their parent providers must be active in the Providers menu).
3. Screen layout
When opened, you will see the following sections from top to bottom:
- Page Header: Displays the title Podium, description, current status chip (On / Off), and overview details.
- Page Audit: Displays the saved version number, last editor name, and last updated timestamp.
- Podium Preview: Interactive simulation of the 3-tier podium (Rank 1 center top, Rank 2 left, Rank 3 right) with Thai and English preview toggle buttons in the top-right corner.
- Settings Card: Houses the Show on home toggle, Thai/English title inputs, and ranking lookback period dropdown.
- Positions Card: 3-row configuration table defining the game source for each rank, alongside the Refresh metrics action button.
- Form Action Bar: Floats at the bottom when changes are made, containing Cancel and Save buttons.
4. Search and filters
This is a single configuration page for the site's top 3 podium. There are no table search bars or filter tabs for the main layout. However, inside the Game column (when a rank is set to "Custom"), a search modal allows you to search and select games by title or game code.
5. Data table
Positions Table Columns
| Column | What you see | Meaning | Badge or color |
|---|---|---|---|
| Position | Number 1, 2, or 3 in a circular badge | Standing on the podium | • Rank 1: Gold-yellow circle with black text • Rank 2: Silver-gray circle with black text • Rank 3: Bronze-orange circle with black text |
| Source | Dropdown selection menu | How the game for that rank is determined | • Auto: Yellow lightning icon • Custom: Blue slider icon |
| Game | Game picker button or card of the ranked game | The game featured on that step, with cover and provider name | • If Custom: Game picker button • If Auto: Game cover + title + provider, or "Ranked after save" • If Unavailable: Yellow warning alert |
| Resolved at | Date and time like 21 Oct 2026, 14:30 | Last timestamp the system calculated this rank | Muted gray text (shown only for Auto rows) |
6. Step-by-step instructions
1. Enabling the Podium and setting custom headings
- Navigate to Games > Podium from the left sidebar.
- In the Settings card:
- Switch Show on home to On (green).
- In Title (TH), enter your custom Thai heading (up to 60 characters) or leave blank for "เกมยอดนิยม".
- In Title (EN), enter your custom English heading (up to 60 characters) or leave blank for "Popular Games".
- Under Ranking period, select the metric timeframe: 1 day, 3 days, 7 days, 15 days, or 30 days.
- Click Save on the bottom action bar.
2. Manually selecting a game for a specific rank
- Scroll down to the Positions card.
- In the row for your desired rank (e.g., Rank 1), select Custom under Source.
- Click the game picker field under Game to open the search modal.
- Type the game title or code and select the desired game.
- Check the preview card above to verify the selected game appears on the podium.
- Repeat for other ranks as needed (the same game cannot be selected twice).
- Click Save.
3. Setting a rank to automatic ranking
- Under Source for that rank, switch the selection back to Auto.
- The system will automatically select the highest-performing game within your configured lookback window.
- Click Save.
4. Recalculating automatic rankings immediately
- Ensure there are no unsaved changes on the page (the bottom Save bar should not be visible).
- Click Refresh metrics (spinning arrow icon) at the top right of the Positions card.
- The system will recalculate game metrics and update automatic ranks immediately, refreshing the timestamp in Resolved at.
7. Form fields and settings
All configuration options on this page are summarized below:
| Field | Required? | What to enter | Example | Rules & limits |
|---|---|---|---|---|
| Show on home | Optional | Switch to show or hide the podium on the lobby home page | Turned on | 2 states: On / Off |
| Title (TH) | Optional | Thai heading displayed above the podium | 3 อันดับเกมมาแรง | Max 60 characters; defaults to system title if blank |
| Title (EN) | Optional | English heading displayed above the podium | Top 3 Trending Games | Max 60 characters; defaults to system title if blank |
| Ranking period | Required | Lookback window used for automatic ranking metrics | 7 days | Dropdown: 1, 3, 7, 15, or 30 days |
| Source (per rank) | Required | How the game is chosen for ranks 1, 2, and 3 | Auto | Select between: Auto / Custom |
| Game (if Custom) | Required | Specific game locked to that rank | Caishen Wins | Must select 1 active game; duplicate selections prohibited |
8. Popups and dialogs
1. Podium Game Picker Modal
- When it appears: Triggered when clicking the game selection field on any rank set to Custom.
- What you see: Search input bar and list of all active site games with covers, titles, and provider badges.
- What to do: Search for the game by name, then click to select it (games already chosen for other ranks cannot be re-selected).
- Result: The selected game is immediately populated into that rank's slot.
2. Version Conflict Dialog
- When it appears: Triggered if another administrator saved changes to the podium while you were editing the page.
- What you see: A warning modal indicating the server configuration has changed.
- What to do: Click Load latest to fetch the latest settings before re-applying your changes.
- Result: Prevents inadvertent overwriting of team configurations.
9. Statuses and badge colors
| Status / Badge | Color | Meaning | Next action |
|---|---|---|---|
| On | Green | Podium is active and displayed on the lobby home page | Normal operation; no action needed |
| Off | Gray | Podium is hidden from the lobby home page | Switch to On and save if you wish to display it |
| Rank 1 | Gold-yellow | 1st place standing (center highest pedestal) | - |
| Rank 2 | Silver-gray | 2nd place standing (left pedestal) | - |
| Rank 3 | Bronze-orange | 3rd place standing (right pedestal) | - |
| Unavailable game | Yellow | Chosen game is switched off or its provider is in maintenance | Choose a different game or enable the game in Providers |
10. Frequently asked questions & troubleshooting
- The "Refresh metrics" button is disabled (grayed out):
- Unsaved edits are present on the form. Click Save first; once saved, the refresh button becomes clickable.
- Why can't I choose the same game for both Rank 1 and Rank 2:
- Duplicate games are prohibited across podium steps. Select a different game for each custom rank.
- Error message "Please fix the errors before saving":
- Check whether any rank set to "Custom" is missing a selected game. All custom ranks must have a game picked before saving.
- Auto rank shows "Ranked after save":
- For newly initialized podiums or after changing ranking periods, the game will be resolved and populated immediately after clicking Save.
- The switch is On, but the podium doesn't appear on the home page:
- Go to Lobby pages > Home page order to verify that the Podium block is active and positioned in your layout.