A course is a sequence of steps shown in a side panel, on top of any ianseo page. Each step explains one action, can point at it visually — a highlighted button, an arrow, a tooltip — and then waits until the action has really been performed before unlocking the next step.
Everything is built from the visual editor (New course or Edit): no code needed. The JSON is generated for you, and stays reachable for advanced users in the folded "JSON source" section.
| Field | Purpose |
|---|---|
| Title | The name shown in the catalogue and at the top of the panel. |
| Description | One short sentence, shown under the title in the catalogue. |
| Version | A free-form number such as 1.0. Raise it and the users who had finished the previous version are marked "previous version". |
| Thumbnail | An optional 16:9 image, shown in the catalogue so a course is recognisable at a glance. |
| ID | A unique identifier, generated for you. Do not change it once the course has been published: it is the key progress is recorded against. |
Every step has:
Use + Before and + After to insert steps, and the ◀ ▶ arrows to move between them. The left-hand panel is a live preview: what you see is exactly what the user will see.
The toolbar above the preview formats the text:
A trigger describes what the user has to do for the step to be complete. A step may hold several, and they fire in order — drag and drop to reorder them. There are two families.
| Field | Purpose |
|---|---|
| Page | The page the action happens on. Empty means the step's own default page. * means any page, which is what menus need since they exist everywhere. |
| Type | The event to wait for: click, double click, change, entry, focus, hover, submit… — none highlights the element and lets the user confirm by hand. |
| Selector | The element, as a CSS selector — #btnSave, .menu-item. It is highlighted, with an arrow. |
| Tooltip | Optional short text shown beside the highlighted element. |
| Required | When ticked, the step does not complete until the action is done. |
Instead of an action, the step waits for a condition inside ianseo to be met — "a competition is open", for instance. While it is not, a message says so. The condition is checked again every time the user comes back to the step.
One built-in condition is always available: 📍 Current page. It checks that the user is on a given page, named in the field that appears. That page may differ from the step's own page. Until the user gets there the step stays locked and a "Go to the page →" link is shown.
The other built-in condition is 🔎 Presence or absence of an element. You give a CSS selector — prefix selectors such as [id^="…"] work here too — and say whether the element must be present or absent. Useful for waiting on a confirmation message, a window opening, a loading indicator disappearing. This condition is re-checked automatically, because such an element can appear or vanish without the page ever reloading.
* page works both as the step's default page and on each trigger individually. A trigger set to * stays active whatever page is on screen.Every trigger, action or state, has an ⎇ activation condition. By default a trigger is always active. It can be made conditional:
A trigger whose condition is not satisfied is skipped, and the sequence moves to the next one. That is what lets a course take different paths depending on the state of ianseo and then rejoin a common sequence:
To target an element — a button, a field, a link:
id, such as id="btnSave": the selector is #btnSave.id, use a class — class="btn-primary" gives .btn-primary.Some ianseo ids carry a record number that changes with the participant or the competition, such as #d_q_QuSession_25360 or #d_QuD1Score_25360. An exact selector would work once and never again. Use a prefix selector:
[id^="d_q_QuSession_"] — an id that starts with this prefix;[id$="_suffix"] — ends with; [id*="middle"] — contains.The trigger then fires on any matching element — the Session box of any participant, say — and the arrow points at the first one found. The trigger recorder spots these numbered ids by itself and writes the prefix selector for you.
Rather than typing selectors by hand, 🔴 Record triggers, in the step options, captures them by clicking directly in ianseo:
| Option | Effect |
|---|---|
| Optional | Shows a "Mark as done" button: the user can complete the step without performing the action. |
| Non-permissive | Blocks every click outside the expected element, so the user can only interact with the target. The panel flashes red when a click is blocked. |
A course can offer up to three activities: the step-by-step guide, a quiz and a challenge. At the end of the guide the user is invited on to the quiz, then the challenge, then the next course. Each activity passed raises the achievement:
| Achievement | Earned by |
|---|---|
| 🎯 Bronze target | Finishing the guide |
| 🎯 Silver target | The guide plus one other activity |
| 🎯 Gold target | Every activity the course offers |
The conditions shipped with the module cover the usual run of a competition:
When the server runs an account module, each account has its own progress: courses under way, steps completed, quizzes, challenges and achievements are recorded per user, without affecting anybody else. The "Learn to use ianseo" banner appears for an account that can see no competition at all, which is the sign of a new organiser. The courses themselves stay common to the whole server. With no account module nothing changes: the progress is simply the installation's.
A course carries every language it has been written in, inside its own file: it stays one document with one version number, and the update mechanism has one thing to compare.
A reader gets the course in the language of their interface. Failing that, English; failing that, the language the course was written in — so a course translated into only one language is still served, never shown empty. A regional language counts as its parent along the way: a reader set to Canadian French gets the French text before English is considered.