UGTK / Toolkit / Ui Module / Dashboard System Completed

Dashboard System

Summary

The Dashboard System displays server data as a table or as a list, without a class per schema. A row is a bag of name/value pairs, so the same UI renders any table the endpoint returns: change the query on the server and the dashboard follows, with no code to touch in Unity.

It is the back-office view of an advergame or of a kiosk: leads collected, scores, sessions, whatever the PHP side exposes.

Content

• Modules Dependencies
• Setup
• How To Use
• Testing Scene
• Technical Info

Modules Dependencies

• Php Connection System: the download is a Mn_PhpOperationBase operation, with its loop, loading screen and outcome events.
• Database System: the rows land in a SO_SimpleDatabase, which decouples the request from the view.
• Layout Auto Resize and Pooling System: the list grows and reuses its rows instead of instantiating.

Setup

1. Add Mn_PhpDownloadTableToRowsDatabase and point it at the endpoint and the table.
2. Assign the SO_TableRowsDatabase asset it will fill.
3. Add Mn_Dashboard with the view you need — Mn_DashboardTableRows for a table, Mn_DashboardStringList for a plain list — and give it the same database.
4. Assign the row prefab (Mn_TableRowHolder or Mn_StringHolder).

How To Use

S_TableRow row = ...;
string name  = row.Get("name");              // "" if the column is missing
string score = row.Get("score", "0");        // explicit fallback
bool  hasIt  = row.Has("email");
row.Set("status", "sent");

Good to know:

• Every value is a string. Parse on read with int.TryParse / float.TryParse; nothing converts for you, and a numeric column sorts alphabetically unless you parse it first.
• Get never throws: a missing column returns the fallback. Convenient, but it also means a typo in a column name shows up as an empty cell rather than as an error — check with Has while wiring things up.
• Initialize() must run before the lookups: it is what builds the name→value index. Rows arriving from the download are already initialized; rows you build by hand are not.
• Rows are pooled: do not keep a reference to a holder across a refresh, it will be showing another row.
• The table field scopes the row, so one database can hold several tables at once. Filter by it if you download more than one.
• A large table is a large request: the whole thing arrives in one response and is parsed in one frame. Paginate on the PHP side rather than downloading thousands of rows.

Testing Scene

Open DashboardScene in the module's Debug/ folder.

What to do, in order:

1. Fill the list with generated rows from the inspector and scroll it.
2. Fill it with zero rows.
3. Include one very long entry.
4. Point the dashboard's item prefab and the pooler's prefab at different objects.

Step 2 is a legitimate outcome that has to show something rather than a blank panel. Step 4 is the setup that silently produces an empty dashboard: the pooler instantiates its own prefab, not the dashboard's, and nothing complains. The inspector detects the mismatch and offers to reconcile it.

The recording is step 1 and step 2 back to back. Select Dashboard, and in Editor Test Tools set Rows and press Fill: twenty generated rows arrive, scroll like real ones, and let you judge spacing and truncation before a server is involved. Clear empties it, which is the case step 2 is about - an empty list is a normal outcome and has to show something rather than a blank panel.

Technical Info

• Back to the toolkit index

© 2026 Marcello De Bonis. All rights reserved

More in Ui Module.

all 34 →

TMP CapsLock System

Components to force uppercase, lowercase or capitalized text in TextMeshPro fields.

Completed

TMP Partial Bold

Applies bold formatting to selected parts of a TextMeshPro label via markers or segments.

Completed

Mouse Over System

Change mouse icon when over an UI with this system.

Completed

Click Effect Button

UI button press feedback: hides shadow/outline and shifts RectTransform by a fixed offset on press.

Completed