Operator guideEN

Casino / Collections / Form

Create and edit one collection, including translations, image, active state, portrait-preview preference, and manual preview games.

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

This form is used to create or edit one casino collection. The create screen lists every active language inline. The edit screen loads one existing collection, groups active-language content into tabs, and marks language tabs that already have a name.

What operators can change

  • Collection name per active language.
  • Collection description per active language.
  • Collection image selected from the shared asset list, or No Image.
  • Active or inactive status.
  • In edit mode, whether automatic preview fill should require portrait images.
  • In edit mode, up to eight manually selected preview games and their order.

Create flow

Create starts with empty name and description values for active languages, no image, and the Active checkbox off. Submit sends the entered translations, selected image, and active flag. After the create request succeeds, the page redirects back to the Collections list after a short delay.

Edit flow

Edit loads the selected collection first. Existing active-language values populate the language tabs, and languages that already have a name are sorted before empty languages. Save Changes updates the selected collection and refreshes the edit data; it does not navigate away automatically.

Show only games with portrait icons in Preview is edit-only in the current screen and is saved with Save Changes.

Preview Games

The edit page has a separate Preview Games card:

  • search games already assigned to this collection
  • add a game to the manual preview
  • remove a game from the manual preview
  • drag manual preview games into the intended order
  • select at most eight manual games

Preview-game add, remove, and reorder operations save immediately through separate collection-game actions. They are not waiting for the collection-level Save Changes button.

On the player side, renderable manual choices lead. Any free slots, up to eight, are filled from eligible non-preview games. With a resolved viewer country, fill uses country popularity; otherwise it keeps collection order.

The portrait-only setting applies to automatic fill candidates. Manual choices are allowed without a portrait image but must still have another renderable game image.

Image selection

The image selector is populated from the shared asset list. Choosing an asset stores a collection image path without the file extension. Empty image selection stores no image. Image previews use the stored path when present and fall back to the image icon when empty.

Known caveats

  • Creating a collection fails if another collection already uses the same English name.
  • The create page does not render a visible error alert from the create hook; failed create requests can remain visible only through lower-level request handling/logging.
  • A new collection is placed at the end of the order automatically; ordering is changed later from the reorder screen.
  • The create page sends Active as the checkbox value, whose initial page value is off. Default-active behavior applies only if the active flag is omitted.
  • The edit-page error alert has a close icon, but no verified close/reset handler was found on that icon.
  • Game membership is not part of this form; it is managed from the Add Games relation workflow.
  • A game must already belong to the collection before it can be selected as a manual preview game.
  • Preview controls are available on edit, not initial create.
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.

Calculations16 topicsOpen details

Active language inputs

Operators edit collection content only for languages that are currently active in the admin language list.

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

Edit language tab order

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

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

Language completed indicator

The check icon means a name exists for that language; it does not validate description quality.

Inputs
current language name value
Formula
A language tab shows the check indicator when that language's collection name is non-empty after trimming.

Image option values

Choosing an image stores a reusable casino asset path on the collection, not a local file upload from this form.

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

Image preview URL

The preview reflects the current selected image value before saving.

Inputs
selected image value, core asset delivery
Formula
When the selected image value starts with a slash, the page loads the preview through Core asset delivery. External URLs are used as stored. Empty values show the image icon.

Create payload

Submit saves every active-language row currently present on the create form.

Inputs
local collection data, active checkbox, selected image value
Formula
Create sends a name map, description map, active checkbox value, and selected image value.
Caveats
The create page initializes Active as off and sends that value unless the operator checks it.

Create save rules

New collections are appended to the ordering sequence and must have a unique English name.

Inputs
English name, current maximum order value, create payload
Formula
The create flow rejects a duplicate English collection name, assigns stored order as current maximum order plus one, uses empty description when omitted, and defaults active to true only when the active flag is omitted.
Caveats
In this form, the active flag is sent from the checkbox, so the default-active fallback normally does not apply.

Edit record read

The edit form changes one existing collection.

Inputs
route collection id
Formula
Edit reads the selected collection by route id before populating the form.

Update payload

Save Changes overwrites the selected collection fields with the current form values.

Inputs
selected collection id, local collection data, active checkbox, selected image value
Formula
Save Changes sends selected collection id plus name map, description map, active checkbox value, and selected image value.

Update save rules

Existing collection data is updated when the selected collection still exists and the request is accepted.

Inputs
selected collection id, update payload
Formula
The update flow verifies the collection exists and updates only fields present in the update payload.

Create success navigation

A successful create returns the operator to the list instead of staying on the create form.

Inputs
create request success state
Formula
After create success, the page waits briefly and navigates to the main Collections list.

Edit success refresh

A successful edit remains on the edit page and refreshes the displayed record.

Inputs
update request success
Formula
After update success, the edit page shows a success toast and refetches the selected collection.

Preview portrait-only preference

Automatic fill requires portrait images when enabled; manual choices still need any renderable image.

Inputs
previewPortraitOnly, player-facing automatic preview fill
Formula
The edit form saves previewPortraitOnly with the collection. Player delivery applies it to automatic fill candidates, not to manual preview choices.

Manual preview limit

Remove an existing manual choice before adding a ninth.

Inputs
selected preview games
Formula
The edit card allows at most eight games with isPreview enabled.

Manual preview order

Manual choices lead the player-facing preview in this order.

Inputs
preview game ids, drag-and-drop order
Formula
The ordered game-id list is saved to previewOrderId values through the dedicated preview-order mutation.

Player-facing preview fill

A partial manual list is topped up automatically; fewer than eight eligible games can still produce a shorter card.

Inputs
renderable manual preview games, eligible non-preview collection games, viewer country, previewPortraitOnly
Formula
Keep up to eight renderable manual choices first, then fill free slots with eligible non-preview games ranked by country popularity when country is known or by collection order otherwise.
Fields24 topicsOpen details

Create Collection

Heading shown on the create collection route.

Data Type
text
Editable
false

Edit

Edit heading that uses the English collection name when loaded, otherwise a generic Collection label.

Data Type
text
Editable
false

Back

Returns from edit to the Collections list without saving unsaved changes.

Data Type
action
Editable
true

Loading Collection...

Edit-page loading state while collection data or active languages are still loading.

Data Type
loading-state
Editable
false

Localized Content

Edit-page section for collection name and description translations.

Data Type
section
Editable
false

Language row

Create-page inline row for one active language.

Data Type
locale-section
Editable
false

Language tab

Edit-page tab for one active language's name and description values.

Data Type
locale-tab
Editable
true

Language completed indicator

Check icon shown on edit language tabs that already have a non-empty name.

Data Type
status-icon
Editable
false

Name

Collection title entered per active language; the English value must be unique on create.

Data Type
localized-string
Editable
true

Description

Optional collection description entered per active language.

Data Type
localized-string
Editable
true

Description character count

Edit-page helper text showing the current description length for the selected language.

Data Type
integer
Editable
false

General Settings

Edit-page side card that contains the collection active-state control.

Data Type
section
Editable
false

Status

Edit-page visual status text showing whether the collection is visible and can be used or hidden from users.

Data Type
status-text
Editable
false

Active

Whether the collection should be active after saving.

Data Type
boolean
Editable
true
Caveats
Create starts with this checkbox off on the current page., Default-active behavior applies only when the active flag is omitted; this form sends the checkbox value.

Image Settings

Edit-page side card for image preview and image selection.

Data Type
section
Editable
false

Image preview

Large preview that shows the selected image or an image icon when no image is selected.

Data Type
asset-preview
Editable
false

Image

Image chosen from the shared asset list, or left empty for no image.

Data Type
asset-selector
Editable
true

No Image

Clears or leaves empty the collection image value.

Data Type
enum-option
Editable
true

Image selected / No image selected

Edit-page caption explaining whether an image is currently selected.

Data Type
status-text
Editable
false

Error updating collection

Edit-page error alert shown when the update request fails.

Data Type
feedback-state
Editable
false
Caveats
The close icon is visible, but no verified reset handler was found on that icon.

Submit

Sends the create request for a new collection.

Data Type
action
Editable
true

Save Changes

Sends the update request for the selected collection.

Data Type
action
Editable
true

Saving...

Edit-page save button state while the update request is running.

Data Type
loading-state
Editable
false

Cancel

Returns to the Collections list without saving unsaved changes.

Data Type
action
Editable
true
More help

Related pages

Casino / Collections

Operator guide for casino collection catalog maintenance, including list, create or edit, reorder, and add-games relation flow.

Casino / Collections / Add Games

Relation workflow for assigning, removing, ordering, or bulk-loading games in a collection.

Casino / Collections / List

Searchable collection grid with status filter, page-level summary cards, game counts, image reset maintenance, and row-level collection actions.

Casino / Collections / Reorder

Drag-and-drop ordering screen for casino collections loaded into the reorder table.

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.