Player groups

1. What this page does

The Player groups page is used to categorize players into specific groups based on business rules, such as General Players, VIP Members, or Special Care accounts. These groups are then mapped to site bank accounts so that players in each group only see and deposit into their designated receiving banks. It is designed for system administrators and finance teams managing bank traffic.

---

2. Before you start

• Required permissions: You must have the 'Player groups' permission to view, create, edit, manage members, or delete groups.
• Things to prepare:
  • Group name and descriptive purpose.
  • List of player usernames or phone numbers to assign to the group.
  • Designated site receiving bank accounts you intend to associate with this group.

---

3. Screen layout

When you open this page, you will see the following key components from top to bottom:

1. Page header: Displays the page title Player groups, a short description, and the Create group button.
2. Search & Filters: Contains a group name search input, the Search button, an Advanced button (toggling status and creation date filters), and a clear filters button.
3. Table toolbar: Includes a refresh button (spinning arrows) and an entry counter showing matching groups.
4. Data table: Displays group records, creation/update metadata, member counts, linked CMS bank counts, status switches, and action buttons.
5. Pagination: Located at the bottom of the table to switch pages and configure items per page (10, 20, 50, 100 entries).

---

4. Search and filters

Field / Filter	Type	How to use	Result
Search by group name	Text input	Type the group name and press Search	The table filters to show groups matching your query
Advanced	Button	Press to toggle additional filter options	Displays status and date range filters
Status (in Advanced)	Dropdown	Select: All, Active, or Inactive	Filters groups by their operating status
Creation date (in Advanced)	Date picker	Select a start date and an end date	Filters groups created within the specified timeframe
Clear all	Button	Press the active filter button at the bottom	Resets all search and filter conditions to defaults

---

5. Data table

All columns in the table

Column	What you see	What it means	Badges or symbols
Created at	Date, time, and creator name (e.g. 21 Oct 2026, 10:15:00 by: admin1)	When the group was created and by whom	Date format and staff username
Updated at	Date, time, and editor name	When the group was last updated and by whom	Date format and staff username
Name	Group name and description	Title and purpose of the player group	Bold name with gray description underneath
Members	Numeric badge (e.g. 15)	Current count of players assigned to this group	Gray number badge
CMS banks	Numeric badge (e.g. 2)	Number of site receiving bank accounts linked to this group	Gray outlined number badge
Status	Toggle switch	Operational status of the group	Green switch = Active, Gray switch = Inactive
Actions	Action buttons in each row	Management actions for this group	See action buttons below

Row action buttons (Actions column)

Button	Icon / Color	What happens when clicked	Notes / Conditions
Manage members	Person with gear icon (UserRoundCog) / Blue	Opens the Manage members modal to search and assign players	Requires edit permission
Edit group	Pencil icon (Edit) / Orange	Opens the Edit group modal to change name, description, or status	Requires edit permission
Delete	Trash icon (Trash2) / Red	Opens confirmation dialog to delete the group permanently	Requires delete permission

---

6. Step by step

1. Creating a new player group

1. Go to Players > Player groups from the left navigation menu.
2. Press the Create group button in the upper right corner.
3. In the modal dialog, fill in:
   • Group name in the Name field (maximum 100 characters).
   • Detailed description in Description (optional).
   • Select status as Active.
4. Press Save.
5. A green notification confirms creation, and the new group appears in the table.

2. Adding or removing group members

1. Locate the group in the table.
2. Press the Manage members button (person with gear icon) in that row.
3. In the modal dialog, type a username or phone number in the search box and press search.
4. Check the box beside players you wish to add (or uncheck to remove them).
5. Review the member counter (e.g. Selected 5 players).
6. Press Save members.

3. Toggling group status

1. Locate the toggle switch in the Status column of the target group.
2. Toggle the switch:
   • Switch to ON (Green) to activate the group and apply linked bank rules.
   • Switch to OFF (Gray) to temporarily disable the group.
3. The change saves automatically with an immediate notification.

4. Editing group details

1. Press the Edit group button (pencil icon) in the row of the group.
2. Modify the name, description, or status as desired.
3. Press Save.

5. Deleting a group

1. Check the Members and CMS banks columns. If bank accounts are still linked, disconnect them in the Bank accounts setup menu first.
2. Press the Delete button (trash icon) in the group row.
3. In the confirmation dialog, review the warning and press Confirm delete.
4. The group is permanently removed from the system.

---

7. Edit or add page

The modal dialog for creating and editing groups (GroupEditor) includes the following fields:

Field	Required?	What to enter	Example	Validation rules
Name	Required	Name of the player group	VIP High Rollers	Up to 100 characters, must be unique
Description	Optional	Notes on criteria for this group	Players with cumulative deposits over 500,000 THB	Up to 255 characters
Status	Required	Operational status	Select Active	Options: Active or Inactive

---

8. Popups and modals

1. Popup window: Group editor

• Triggered by: Pressing Create group or pressing the Edit button in any row.
• What you see: Inputs for group name, description, status dropdown, and Save/Cancel buttons.
• Action required: Complete the name, select status, and press Save.
• Outcome: Creates or updates the group record immediately.

2. Popup window: Manage members

• Triggered by: Pressing Manage members (person with gear icon) in any row.
• What you see: Player search bar, player checklist with checkboxes, selected counter, and Save button.
• Action required: Search for players, check/uncheck candidates, and press Save members.
• Outcome: Assigns or unassigns players and updates the row's member count.

3. Popup window: Delete confirmation

• Triggered by: Pressing the Delete button in any row.
• What you see: Warning message outlining consequences of deletion.
• Action required: Read carefully and press Confirm delete (or Cancel).
• Outcome: Permanently deletes the group from the system.

---

9. Statuses and badges

Badge / Label	Color	Meaning	Action required
Active	Green	Group is enabled and its bank rules apply to members	Operates normally
Inactive	Gray	Group is paused; members fall back to default bank settings	Re-enable when ready
Member count	Gray	Number of players currently in this group	Click manage members to adjust
CMS bank count	Gray border	Number of site receiving banks mapped to this group	Link banks in payment settings if needed

---

10. Common questions and troubleshooting

• Why can't players see any receiving banks for deposits?
  1. Check which group the player belongs to via the Edit Player section.
  2. Ensure the group status is set to Active (Green).
  3. Verify that the CMS banks count is greater than 0. If it is 0, navigate to Payment Settings > Bank Accounts to associate banks with this group.
• Why did group creation fail? Ensure you entered a group name, that it does not exceed 100 characters, and that it is not identical to an existing group.
• How do I remove several players from a group at once? Press Manage members, uncheck the boxes next to those players, and press Save members.
• What happens to players when a group is deleted? Players are never deleted from the website when a group is deleted. They simply lose their group assignment and fall back to the default site bank settings.