Hit sections
1. What this page is for
The Hit sections page is used to create and manage featured game or provider rows on the lobby home page, as well as automatic "Hit" flame badges displayed over game covers throughout the site. Administrators can curate and order items manually, or define automated ranking rules based on play count, unique players, or newly arrived games, complete with custom pins and exclusion lists.
2. Before you start
- Permissions: You must have the 'Hit and highlight games' permission granted by an administrator to view, create, edit, or delete hit sections.
- What to prepare:
- Decide whether you are creating a row of Games or Providers (this choice is locked after saving).
- Decide on the configuration mode: Custom (hand-picked items) or Auto (rule-based ranking metrics).
- Verify that games or providers to be included are active in the system.
3. Screen layout
When opened to the main list, you will see the following sections from top to bottom:
- Page Header: Displays the title Hit sections, description, and top action buttons: Arrange home order (links to home page layout organizer) and Add hit section.
- Filter Tabs: Quick status filters: All sections, Active (green), Inactive (gray), and Deleted (dark gray).
- Search & Filter Bar: Text input for search, with toggleable advanced filters for type (Games / Providers), mode (Custom / Auto), date ranges, and staff usernames.
- Data Table: Lists all hit section records, showing rules, visible item counts, on/off switches, and row action menus.
- Pagination Bar: Located at the bottom to navigate pages and adjust records per page.
When creating or editing:
- Live Preview: Real-time visual rendering of the companion row as players will see it, with Thai and English language switches.
- Main Form (Left): Title inputs, type selection (Games / Providers), mode selection (Custom / Auto), ranking criteria, and tweaking controls (pinned, excluded, provider filters).
- Display Settings Card (Right): Status switch (Active / Inactive), Show on home switch, and Show ranking numbers switch.
4. Search and filters
| Field / Filter | Type | Choices & Usage | Result |
|---|---|---|---|
| Status Tabs | Tab toggle | Choose: All sections, Active, Inactive, or Deleted | Filters table to sections matching the selected status |
| Search Bar | Text input | Type Thai or English section title | Filters table to entries matching your search keywords |
| Type | Dropdown | Choose: All, Game, or Provider | Filters table by item type |
| Mode | Dropdown | Choose: All, Custom, or Auto | Filters table by selection method |
| Created date | Date range picker | Select From date and To date | Displays sections created within the specified range |
| Last updated date | Date range picker | Select From date and To date | Displays sections updated within the specified range |
| Created by | User typeahead | Search and select a staff member username | Shows only sections created by that user |
| Updated by | User typeahead | Search and select a staff member username | Shows only sections last updated by that user |
| Clear filters | Button | Click Clear in the search bar | Resets all active search terms and filters to default |
5. Data table
Table Columns
| Column | What you see | Meaning | Badge or color |
|---|---|---|---|
| Name | Gamepad or building icon with Thai and English titles | Configured section title | Click title to open the edit page |
| In lobby | Badge indicating placement on site | Where and how this section appears to players | • Home row + hit badge: Green badge (Home icon) • Hit badge only: Orange badge (Flame icon) • Not shown: Gray badge (Circle off icon) |
| Rule | Mode chip and summary text | Configuration mode and rules summary | • Custom chip (Hand icon) or Auto chip (Sparkles icon) • Summary text like "12 chosen" or "Top 10 by plays · last 7 days" |
| Showing | Active item count | Number of games or providers currently active and visible | • Count text like 12 games or 5 providers• If items are disabled: Orange warning X hidden |
| Last edited | Date, time, and staff name | Timestamp and author of latest modification | Shows staff username or "System" |
| Status | Toggle switch or deleted badge | Current operational status | • Switch: Active (green) / Inactive (gray) • Badge: Deleted (dark gray) |
| Actions | Action buttons | Available commands for that row | See details below |
Row Actions
| Button | Icon / Color | What happens when clicked | Condition / Notes |
|---|---|---|---|
| Edit / View | Pencil icon (or Eye icon) | Opens the edit form (or read-only view for deleted sections) | Always available |
| Action menu (⋮) | Three vertical dots | Opens secondary commands menu | Shown only for active/inactive sections |
| Delete | Red trash icon (in ⋮ menu) | Opens confirmation dialog to delete the hit section | Only clickable when the section switch is set to Inactive |
6. Step-by-step instructions
1. Creating a custom hit section (hand-picked items)
- Navigate to Games > Hit sections from the left sidebar.
- Click Add hit section in the top-right corner.
- Enter Title (TH) (required, up to 100 characters) and Title (EN) (optional).
- Under Type, choose Game or Provider (locked after saving).
- Under Mode, choose Custom.
- Under item selection:
- Click Add games (or Add providers) to open the selection modal.
- Select the items you want (up to 100 items).
- Drag handles or click Up / Down arrows to arrange your preferred sequence.
- In the right-hand settings card:
- Set Status to Active or Inactive.
- Turn Show on home on if you want a home page row.
- Turn Show ranking numbers on if you want 1, 2, 3... numbered overlays.
- Review the live preview box at the top, then click Save at the bottom.
2. Creating an automatic hit section (rule-based ranking)
- Click Add hit section, enter the title, and choose Game or Provider.
- Under Mode, choose Auto.
- Configure the ranking criteria:
- All categories: Leave enabled to pool from all games, or turn off and check specific categories (e.g. Slot, Casino).
- Items to show: Enter the maximum item count (1 to 50 items).
- Rank by: Select Most played (times launched), Most players (unique players), or Newest (arrival date).
- Count period: Select the lookback window: 1 day, 7 days, 30 days, or All time (disabled for Newest).
- Only new games: Toggle on to restrict candidates to newly added games.
- (Optional) Under Tweak automatic ranking:
- Pinned items: Select games/providers that must appear at the front regardless of rank.
- Excluded items: Select games/providers to exclude completely even if they qualify (up to 200 items).
- Limit to providers: Restrict candidate games to selected providers only.
- Set display toggles on the right card, then click Save.
3. Arranging hit section placement on the home page
- From the hit sections list, click Arrange home order at the top right.
- The system redirects to Lobby pages > Home page order.
- Drag the hit section block to your preferred position among other home page sections, then save.
4. Deleting a hit section
- In the table, locate the Status switch of the section you wish to delete.
- Switch it to Inactive (gray) first.
- Click the action menu ⋮ at the end of the row and select Delete.
- In the confirmation dialog, click the red Delete button.
- The section is moved to the Deleted tab for historical reference.
7. Form fields and settings
Summary of all fields on the create and edit pages:
| Field | Required? | What to enter | Example | Rules & limits |
|---|---|---|---|---|
| Title (TH) | Required | Thai heading displayed above the row | เกมยอดนิยมประจำเดือน | 1–100 characters; cannot be blank |
| Title (EN) | Optional | English heading displayed when players use English | Popular Games of the Month | Up to 100 characters; falls back to Thai title if blank |
| Type | Required | Content entity of the section | Game | Choose between: Game or Provider (locked after save) |
| Mode | Required | Item selection method | Auto | Choose between: Custom or Auto |
| All categories (Auto) | Optional | Switch to draw from all game categories | Turned on | If off, at least 1 category must be checked |
| Categories (Auto) | Conditional | Selected game categories | Slot, Casino | Required if All categories is turned off |
| Items to show (Auto) | Required | Maximum items to feature in the row | 10 | Integer between 1 and 50 items |
| Rank by (Auto) | Required | Metric used to order candidates | Most played | Choose: Most played / Most players / Newest |
| Count period (Auto) | Required | Timeframe for aggregating metrics | Last 7 days | Choose: 1 day, 7 days, 30 days, or All time |
| Only new games (Auto) | Optional | Filter to newly released games only | Turned off | Toggle on or off (Game type only) |
| Pinned items | Optional | Items forced to appear first | Selected via picker | Count cannot exceed total Items to show |
| Excluded items | Optional | Items prevented from appearing in this row | Selected via picker | Up to 200 items |
| Limit to providers | Optional | Restrict candidates to selected providers | Selected via picker | If blank, draws from all active providers |
| Status | Optional | Switch to activate or pause the section | Active | 2 states: Active / Inactive |
| Show on home | Optional | Switch to show or hide the row on the home page | Turned on | If off, row is hidden from home, but items keep hit badges |
| Show ranking numbers | Optional | Switch to display 1, 2, 3... numbers on game covers | Turned off | Toggle on or off |
8. Popups and dialogs
1. Hit Item Picker Modal
- When it appears: Triggered when clicking to pick items in Custom items, Pinned, Excluded, or Limit to providers.
- What you see: Search input bar and list of active games or providers with covers, titles, and provider tags.
- What to do: Search by title or code and click to select items.
- Result: Selected items are immediately added to the corresponding list.
2. Confirm Modal (Deletion)
- When it appears: Triggered when clicking Delete from the row menu ⋮ in the table.
- What you see: Warning dialog asking you to confirm deletion of the section.
- What to do: Confirm the section name and click Delete (or click Cancel).
- Result: The entry is moved from the main list to the Deleted tab.
3. Version Conflict Dialog
- When it appears: Triggered if another administrator saved changes to this section while you were editing it.
- What you see: Notification modal warning that the server record has changed.
- What to do: Click Load latest to fetch the latest changes before re-applying your edits.
- Result: Protects against unintentional overwrite of team configurations.
9. Statuses and badge colors
| Status / Badge | Color | Meaning | Next action |
|---|---|---|---|
| Active | Green | Section is active; displayed on home if enabled | Normal operation |
| Inactive | Gray | Section is paused; hidden from home with badges removed | Toggle on when ready to use |
| Deleted | Dark gray | Section has been removed; retained for audit history only | Read-only; cannot be restored or edited |
| Home row + hit badge | Green | Visible as a row on home page, and items wear hit badges | Ideal full-visibility state |
| Hit badge only | Orange | Row hidden from home, but items wear hit badges in category tabs | Use to feature items without home row |
| X hidden | Orange | Some items in this section are disabled or under provider maintenance | Edit the section to replace disabled items |
10. Frequently asked questions & troubleshooting
- Why can't I switch between "Game" and "Provider" after saving:
- Content type determines underlying data structures and is locked upon initial creation. If you need a different type, create a new section and deactivate or delete the old one.
- The Save button cannot be clicked (error borders or disabled):
- Verify that Title (TH) is filled in.
- In Custom mode: Verify that at least 1 item is selected.
- In Auto mode: Verify that Items to show is between 1 and 50, and if "All categories" is off, at least 1 category is selected.
- Verify that the count of Pinned items does not exceed the total Items to show.
- The Delete button is disabled in the row menu:
- System safety prevents deleting active sections. Turn the section switch to Inactive first, then proceed to delete.
- Where do games in a hit section get flame badges:
- Games qualifying for an active hit section receive flame badges on the home page, in the "Hit" tab, and in all matching category tabs automatically.
- Section is Active, but not showing on the website:
- Ensure Show on home is switched on.
- Go to Lobby pages > Home page order to verify that this hit section block is active and ordered properly in your layout.