Operator guideEN

Casino / Categories / Form

Create and edit workflow for top-level casino categories, including translations, active state, built-in icons, and custom Core asset icons.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this form does

The category form creates or edits a top-level casino category. Categories are the first grouping layer used to organize casino games, so name quality, active state, and icon choice affect how operators and downstream catalog views recognize the group.

The create flow is intentionally smaller. It lets an operator enter category-name translations, set Active Status, preview the category, and submit the new category. The edit flow loads an existing category and adds settings for built-in icons, custom icon assets, reset, dirty-state markers, and a fuller preview.

What operators can change

  • Category Name translations for active languages.
  • Active Status, which stores the category as active or inactive.
  • System Icons on the edit flow.
  • Custom Icon on the edit flow, selected from existing category icon assets.
  • No Image on the edit flow, which clears the custom icon selection.

How save works

Create becomes available when at least one translation has a non-empty category name. After a successful create, the page briefly shows success feedback and returns to the Categories list. New categories are appended after the current highest stored category order.

Edit loads the category from the category list data by the route id. Save Changes becomes available only when the form is valid and at least one value changed. Reset restores the values that were loaded when the edit form opened. Cancel or Back leaves the form, and if there are unsaved local changes the page asks the operator to confirm leaving.

Translation rules

The form reads active languages and creates one translation row for each active language. A language row can be expanded, edited, collapsed, and marked as filled. Edit puts languages that already have a value first and marks changed values with an Edited indicator.

The page only requires one non-empty translation to enable submit, but the verified duplicate checks use the English name path. For predictable category management, fill the English category name even when another language is the immediate business priority.

Icon rules

Create does not expose icon controls. Edit can store a built-in icon name and optionally a custom icon selected from the category icon asset catalog. When a custom icon is selected, the preview and saved category depend on the asset still being available through the Core asset service. If the selected custom icon is an SVG, the save flow stores processed SVG text for later use.

Known caveats

  • The create flow does not choose an icon. Use edit after creation when the category needs a specific system or custom icon.
  • The page validity rule is "at least one translation is non-empty", while duplicate-name checks are English-name oriented. Missing English names can make validation and audit wording harder to reason about.
  • Edit reads the category through the category list data and then matches the route id locally. If the list data does not contain the category, the edit form cannot initialize the record.
  • Custom icon save depends on the selected Core asset path. Missing or non-SVG assets can still leave the stored custom icon value, but processed SVG text may be empty.
  • Translation completeness matters because categories can appear in multilingual player-facing contexts.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations14 topicsOpen details

Active language inputs

Operators edit category names only for languages that are currently active in the admin language list.

Inputs
active language list, category translation values
Formula
The form reads active languages with page size 100. Create initializes an empty category-name value for each active language. Edit maps active language codes to existing category name values, falling back to empty strings.

Edit language order

Existing translations are easier to find first on the edit form.

Inputs
active languages, existing category names
Formula
Edit sorts active language codes so languages with an existing category name appear before languages without a name.

Form validity

Create Category and Save Changes require at least one filled translation.

Inputs
category-name translation map
Formula
The form is valid when at least one category-name translation is non-empty after trimming.
Caveats
The visible validity rule does not require the English translation, but verified duplicate checks are English-name oriented.

Create unsaved changes

Back on the create form warns before leaving only after at least one category name has been entered.

Inputs
category-name translation map
Formula
Create marks the form as changed when any category-name translation is non-empty after trimming.

Edit unsaved changes

Reset and Save Changes become available only after a real local edit.

Inputs
current translation map, loaded translation map, current active state, loaded active state, current system icon, loaded system icon, current custom icon, loaded custom icon
Formula
Edit marks the form as changed when any translation, active state, system icon, or custom icon differs from the loaded initial state.

Edited translation indicator

The Edited marker means the local value changed; it does not mean the change has been saved.

Inputs
current language value, loaded language value
Formula
A language row is marked edited when its current value differs from the value loaded for that language.

Custom icon option values

Choosing a custom icon stores a reusable asset path on the category, not a local file upload from this form.

Inputs
asset name, asset key
Formula
The custom icon selector shows each asset by asset name and stores a casino asset path built from the asset key with its final file extension removed. The No Image option stores an empty value.

Icon preview

A selected custom icon overrides the system icon visually in the preview.

Inputs
custom icon value, system icon value
Formula
Preview prefers the selected custom icon when one is present, otherwise it renders the selected system icon, otherwise it shows an empty category-icon fallback.

Create payload

Create saves all active-language rows currently present in the form and the current Active Status value.

Inputs
category-name translation map, active status
Formula
Create sends the current translation map and active flag.

Create save rules

New categories are appended to the category ordering sequence and should use a unique English name.

Inputs
English category name, current maximum category order, create payload
Formula
The create flow rejects an existing category with the same English name, assigns stored order as current maximum order plus one, and stores the submitted translation map and active flag.
Caveats
The create form starts Active Status on, so new categories are active unless the operator clears that checkbox.

Edit record read

The edit form can initialize only if the selected category is present in the loaded category list response.

Inputs
route category id, category list data
Formula
Edit reads category list data and selects the row whose category id matches the route id.
Caveats
This verified flow does not use a category-specific read endpoint.

Update payload

Save Changes overwrites selected category settings with the current form values after save validation.

Inputs
route category id, category-name translation map, active status, system icon, custom icon
Formula
Save Changes sends selected category id, translation map, active flag, normalized system icon name, custom icon value, and empty icon color.

Update save rules

Existing translations that are not replaced by the submitted map remain available, and icon processing depends on the selected Core asset.

Inputs
selected category id, update payload, existing category translations, custom icon path
Formula
The update flow verifies the category exists, checks duplicate name only when the English name changed, merges submitted translations with existing translations, fetches custom icon SVG text when a non-empty custom icon is selected, and stores active/icon fields.
Caveats
If custom icon fetching fails or the asset is not SVG, processed SVG text can be empty.

Create and edit success navigation

Successful saves return the operator to the list instead of keeping the form open.

Inputs
create request success state, update request success state
Formula
After create or update success, the form clears submitting state, waits briefly, and navigates back to the Casino Categories list.
Fields39 topicsOpen details

Create New Category

Heading shown when creating a new top-level casino category.

Data Type
text
Editable
false

Edit Category

Heading shown when editing an existing top-level casino category.

Data Type
text
Editable
false

Category route id

Identifies which existing category the edit form tries to load and save.

Data Type
integer
Editable
false

Loading form

Skeleton state shown while the edit form is waiting for category data.

Data Type
loading-state
Editable
false

Back

Leaves the form and returns to the Categories list when there are no unsaved changes, or asks for confirmation when local edits exist.

Data Type
action
Editable
true

Translations

Edit-page tab that shows category-name translation rows.

Data Type
tab
Editable
true

Icons & Settings

Edit-page tab that shows system icon, custom icon, and active-state controls.

Data Type
tab
Editable
true

Preview

Edit-page tab that previews how the category will appear in the list.

Data Type
tab
Editable
true

Category Name Translations

Section containing one category-name row for each active language.

Data Type
section
Editable
false

Language row

Expandable row for entering or reviewing a category name in one active language.

Data Type
locale-section
Editable
true

Language code badge

Two-letter visual cue for the language row.

Data Type
status-badge
Editable
false

Category Name

Category title entered per active language.

Data Type
localized-string
Editable
true
Caveats
The visible submit rule only requires one non-empty language value., Verified duplicate-name checks are English-name oriented, so the English value should be filled for predictable create and edit behavior.

EDITED

Edit-page marker showing that a translation value differs from the value loaded when the form opened.

Data Type
status-badge
Editable
false

Original value

Edit-page helper that shows the loaded value for a changed translation.

Data Type
helper-text
Editable
false

Category Options

Settings area that contains the category active-state control.

Data Type
section
Editable
false

Active Status

Controls whether the category is stored as Active or Inactive.

Data Type
boolean
Editable
true
Caveats
Create starts active in the current form., Edit initializes this value from the loaded category.

Active / Inactive

Visual status chip that mirrors the current Active Status value.

Data Type
status
Editable
false

System Icons

Edit-page section for choosing a built-in category icon.

Data Type
section
Editable
false

Current Icon

Shows the currently selected built-in icon, selected custom icon, or empty icon fallback.

Data Type
icon-preview
Editable
false

Select System Icon

Opens the built-in icon picker and stores the selected icon locally until Save Changes.

Data Type
enum-selector
Editable
true

Custom Icon

Edit-page section for selecting a custom category icon from shared assets.

Data Type
section
Editable
false

Custom Image

Preview for the selected custom icon asset, or an empty-image placeholder when no custom icon is selected.

Data Type
asset-preview
Editable
false

Select Custom Icon

Selects an existing category icon asset for the category.

Data Type
asset-selector
Editable
true
Allowed Values
No Image, category icon assets returned by asset search
Caveats
Asset options are built from existing asset keys with file extensions removed., The saved value is a reusable casino asset path, not a local file upload from this form.

No Image

Clears the custom icon selection locally until Save Changes.

Data Type
enum-option
Editable
true

Category Preview

Shows how the current category name, icon, id, translations, and active state will appear before saving.

Data Type
preview
Editable
false

Add a category name to see the preview

Preview placeholder shown until at least one translation has a non-empty category name.

Data Type
empty-state
Editable
false

How it will appear in the list

Edit-page card showing category icon, first non-empty name, id, and active-state chip.

Data Type
preview
Editable
false

Translations

Preview list of non-empty category-name translations.

Data Type
preview-list
Editable
false

Reset

Restores the edit form to the values loaded when the page initialized.

Data Type
action
Editable
true

Cancel

Leaves the edit form, with confirmation when unsaved changes exist.

Data Type
action
Editable
true

Create Category

Sends the create request for a new category.

Data Type
action
Editable
true

Save Changes

Sends the update request for the selected category.

Data Type
action
Editable
true

Submit disabled

Create is disabled until the form is valid; Save Changes is disabled until the form is valid, changed, and not already submitting.

Data Type
disabled-state
Editable
false

Submitting overlay

Full-page progress overlay shown while create or update is in progress.

Data Type
loading-state
Editable
false

Category successfully created / Category successfully updated

Success alert shown after create or update completes successfully.

Data Type
feedback-state
Editable
false

Request error

Error alert shown when the create or update request fails.

Data Type
feedback-state
Editable
false

You have unsaved changes. Are you sure you want to leave?

Warning shown when Back or Cancel is clicked while local unsaved changes exist.

Data Type
confirmation
Editable
true

Leave

Confirms leaving the form and discards unsaved local changes.

Data Type
action
Editable
true

Stay

Closes the warning and keeps the operator on the form.

Data Type
action
Editable
true
More help

Related pages

Casino / Categories

Operator guide for casino top-level categories, their list workflow, create or edit form, and manual ordering screen.

Casino / Categories / List

Searchable category catalog with create, edit, status toggle, and reorder entrypoints.

Casino / Categories / Reorder

Drag-and-drop screen for changing the visible category order in the casino catalog.

Affiliate Deals / Form

Create and edit form for affiliate deals, including PID, date window, commercial terms, and responsible person.

Affiliate Payment Settings / Form

Create and edit form for one affiliate payment-setting record, with visible PID targeting, minimum deposit threshold, and active-state control.

Auto Tags Manager / Create

Full rule-builder for a new automatic tagging rule, including priority, tag actions, coupon actions, KPI field selection, and draft impact estimation.