Check-in

1. What Is This Page For?

The Check-in page lets administrators configure a monthly calendar of daily check-in rewards for players in the lobby. You can award points, lucky wheel tickets, and diamonds, set up rewards day by day or in bulk for the entire month, copy setups between months, and review check-in statistics and claim logs. The legacy check-in history page automatically redirects to the report tab on this page.

---

2. Before You Start

• Required Permissions:
  • You need the 'Check-in' permission in Roles to view and edit the check-in calendar.
  • You need the 'Check-in - report and history' permission in Roles to view the report and claim logs.
  • If you only hold the report permission, the calendar tab will be hidden and you will only see statistics and claim history.
• What to Prepare:
  • Activity Title: Prepare Thai and English titles displayed on the player lobby check-in banner.
  • Reward Schedule: Plan point, ticket, and diamond amounts for each day of the month, especially weekends or special promotional dates.
  • Prerequisites: If awarding wheel tickets, ensure the Lucky Wheel feature is enabled so players can spend their tickets.

---

3. Page Overview

When you open this page, you will see the following key sections:

1. Header: Displays breadcrumbs, the page title Check-in, and a short description.
2. Page Tabs:
   • Check-in Calendar: Configure title, on/off status, and daily reward amounts on the calendar grid.
   • Report and History: Review aggregate claim statistics, trend charts, top claimants, and detailed claim logs.
3. Basic Information Card (Calendar Tab): Holds the Thai title, English title, on/off switch, and audit metadata (version, last editor, and timestamp).
4. Calendar Grid: Displays days 1 through the end of the month with reward amounts configured for each date.
5. Quick Tools Side Panel: Offers one-click day selection buttons (whole month, empty days, weekends) and input fields to apply rewards in bulk.
6. Bottom Action Bar: Displays Cancel and Save buttons whenever changes are made.

---

4. Search and Filters

On the Report and History tab, use these controls to filter data:

Filter / Control	Type	Options / How to Use	Result
Period Preset	Button Group	Choose between: Today, 7 days, 30 days, or Custom	Filters summary cards, trend charts, and the claim table to the selected timeframe
Date Range	Date Range Picker	Select start and end dates (up to 92 days)	Displays records strictly within the specified date range
Search Player	Text Input	Type a player's username in the search box above the table	Shows only claim records for the matching player
Clear	Button	Click the Clear button next to the search box	Clears search text and restores the full table view
Refresh (Circular Arrow)	Button	Click to pull the latest claim numbers and records	Refreshes statistics and table rows immediately

---

5. Data Tables

Reward Claim History Table (Report Tab)

Column	What You See	Meaning	Color Badges / Icons
Claimed At	Date and time (e.g. 21/10/2026, 14:30)	When the player claimed their check-in reward	Standard monospace date-time
Player	Player username (e.g. player01)	The player account who checked in	Bold text, clickable to profile
Mission	Calendar icon with Check-in	Type of activity completed	Blue calendar icon
Rewards	Reward badges (e.g. +50 Points, +1 Ticket)	Rewards credited to the player's wallet	• Orange: Points • Red: Tickets • Blue: Diamonds

Top Claimants Table

Column	What You See	Meaning	Color Badges / Icons
# (Rank)	Rank number 1, 2, 3 ...	Order of players with the most check-ins in the period	• Yellow: Ranks 1–3 • Gray: Rank 4 and above
Player	Player username	Account name of the top claimant	Bold text
Claims	Integer count (e.g. 30)	Total number of days this player checked in	Standard number
Rewards	Combined reward badges	Total points, tickets, and diamonds earned	Orange, red, and blue badges
Last Claim	Date and time	Most recent check-in timestamp	Muted gray text

---

6. Step-by-Step Guides

1. Naming and Enabling Check-in

1. Navigate to Activities > Check-in in the left sidebar.
2. In the Check-in Calendar tab, review the top settings card.
3. Enter the Thai activity title in Check-in Title (e.g. เช็คอินรายวันรับโชค).
4. Enter the English title in Title (EN) (e.g. Daily Check-in Rewards) (optional).
5. Toggle the status switch on the right:
   • Set to Active (Green) to show the check-in banner in the lobby.
   • Set to Inactive (Gray) to temporarily close check-ins.
6. Scroll down and click Save on the bottom action bar.

2. Setting Daily Rewards on the Calendar

1. Locate the monthly calendar grid. Use the left/right arrow buttons next to the month label to switch months.
2. Select target days:
   • Click individual day cells on the grid (click again to deselect).
   • Or use the quick buttons in the right panel:
     • Select whole month: Highlights every day of the month.
     • Select days with no rewards: Highlights only dates with no rewards set yet.
     • Select weekends: Highlights all Saturdays and Sundays.
3. In the right panel, enter the reward amounts:
   • Points: Enter points (e.g. 50).
   • Tickets: Enter wheel tickets (e.g. 1).
   • Score (Diamonds): Enter diamonds (e.g. 10). (At least one reward field must be greater than 0; leave blank or enter 0 for rewards not offered).
4. Click Apply to assign rewards to all selected dates at once.
5. To wipe rewards from selected dates, click the Eraser button next to Apply.
6. Verify that no dashed orange outlines remain on upcoming days.
7. Click Save on the bottom action bar.

3. Copying Rewards Across Months

1. Navigate to the source month that already has rewards configured.
2. Click Copy Month at the top right of the calendar card.
3. A blue notification banner appears indicating the copied month.
4. Navigate to the target month using the month arrows.
5. Click Paste in the blue banner.
6. In the confirmation dialog, click Replace.

   [!NOTE] Past dates in the current month are never overwritten when pasting, preserving past reward history.

7. Click Save on the bottom action bar to apply the changes.

4. Exporting Check-in History to CSV

1. Switch to the Report and History tab.
2. Select your desired period (e.g. 30 days or a custom date range).
3. Scroll down to the Reward History table.
4. Click Export CSV at the top right of the table.
5. The system downloads mission-rewards-<from>_<to>.csv (up to 5,000 records per export).

---

7. Form Fields and Settings

All check-in parameters are configured in the Check-in Calendar tab:

Field	Required?	What It Is	Example	Restrictions
Check-in Title	Required	Thai heading displayed in the lobby check-in banner	เช็คอินรายวันรับทรัพย์	1–100 characters, cannot be empty
Title (EN)	Optional	English heading for English-language lobby users	Daily Check-in Rewards	Max 100 characters
Active Switch	Required	Enables or disables check-ins site-wide	Active (Green)	Active or Inactive
Points	Optional*	Point amount awarded on selected days	50	Positive integer, 0 or greater
Tickets	Optional*	Lucky wheel tickets awarded on selected days	1	Positive integer, 0 or greater
Score (Diamonds)	Optional*	Diamond reward amount awarded on selected days	10	Positive integer, 0 or greater

*Note: Every day that players are allowed to check in must have at least one reward type greater than 0.

---

8. Popups and Dialogs

1. Version Conflict Dialog

• Triggered When: You click Save, but another administrator updated and saved the calendar in the meantime.
• What You See: A warning stating that your on-screen data is older than the server's current version.
• What to Do: Click Load latest. The system loads the latest server data so you can review changes before saving again.
• Result: Prevents inadvertent overwrites between administrators.

2. Paste Confirmation Dialog

• Triggered When: You click Paste into a month that already has some rewards assigned.
• What You See: A warning that existing rewards in upcoming days will be overwritten by the copied month.
• What to Do: Click Replace to confirm, or Cancel to preserve existing data.
• Result: Applies rewards from the copied month to all dates from today through month-end.

3. Today Changed Confirmation Dialog

• Triggered When: You click Save after modifying rewards for "Today", and players have already checked in earlier today.
• What You See: A warning stating how many players have already claimed today's reward and explaining that they will not receive retroactive adjustments.
• What to Do: Click Save to confirm, or Cancel to revert changes.
• Result: New rewards apply only to players checking in after this point; previous claimants retain their original rewards.

---

9. Statuses and Indicators

Status / Indicator	Color	Meaning	Action Required
Active	Green	Check-in calendar is active and visible in the lobby	System operates normally; ensure all dates have rewards
Inactive	Gray	Check-in calendar is paused; players cannot check in	Toggle to active when reward configuration is complete
Dashed Orange Cell Outline	Orange	Upcoming date has zero rewards assigned	Select the day and assign at least one reward
Solid Blue Cell Outline	Blue	Today's date in Bangkok timezone (UTC+7)	Indicates current live check-in day
Gift Box Icon	Blue	Big reward day with all 3 reward types (points, tickets, diamonds)	Highlighted prominently with special art in the lobby
Point Badge	Orange	Points reward type for use in Point Exchange Shop	Credited automatically to player point wallet
Ticket Badge	Red	Wheel ticket reward type for use on Lucky Wheel	Usable immediately in Lucky Wheel game
Diamond Badge	Blue	Score/diamond reward type for special perks	Accumulated according to site activity rules

---

10. Frequently Asked Questions & Troubleshooting

• Players report they cannot check in on a specific day:
  • Check the calendar grid. If the cell has a dashed orange outline, no rewards are assigned. Select the day, enter rewards, click Apply, and click Save.
  • Ensure the top switch is set to Active (Green).
• Cannot paste copied month:
  • Check whether the target month is in the past. The system only allows pasting into the current or future months.
• Save button is disabled or cannot save:
  • Verify that Check-in Title is not empty. This field is required.
• Warning banner shows upcoming days with no rewards:
  • Click Select days with no rewards in the side panel. All unassigned days will be selected automatically. Enter rewards, click Apply, and click Save.