UnitusTI Package Editor — User Manual

This manual is for center staff with the Author role who build marketplace package manifests : course structure, linked assessments, and published custom forms.

The Package Editor lets you:

Create packages and edit their manifest (title, description, footer, splash image).
Arrange courses and units , link units to assessments, and set thumbnails.
Register which assessments and forms belong in the package manifest.
Save the manifest so learners and the marketplace use the updated structure.

The first breadcrumb label is Packages . The editor opens from Author → My Packages (not from the Center → My Packages screen, which only edits basic package metadata in the classic page).

1. Open the Package Editor

Sign in to UnitusTI and select your center.
Open the Author submenu.
Choose My Packages .

Your profile must include the Author role and the author module must be enabled for the center. If Author or My Packages is missing, ask an administrator.

The list shows package names as links. The top-right button is Add Package .

2. Before you start

2.1 Author vs Center package list

Screen	Menu path	Purpose
Package Editor (this manual)	Author → My Packages	Edit the package manifest : courses, units, assessments list, forms list, splash image, footer.
Center package list	Center → My Packages	Edit package name , description , and tags in the classic dialog. Use both when you need catalog metadata and manifest content.

2.2 Saving behavior

Change	When it is stored
Courses, units, assessments on the manifest, package details from Edit Details , removing a form from the table	When you click Save on the package page.
Add form (Forms tab)	Immediately on the server; the list reloads from the server. You still use Save for other manifest edits.
Thumbnails (package splash, course, unit)	Uploaded when you pick an image; included in the manifest when you Save .

If you leave the package page with unsaved manifest edits, the browser may warn you. The Save button shows a dot when there are unsaved changes.

3. Packages list

The breadcrumb shows Packages .

Click a package name to open it. Click Add Package to create a new one.

While the list loads, a loading message appears. If loading fails, an error snackbar shows at the bottom of the screen.

4. Create a package

On the packages list, click Add Package .
In Add package , fill in:

Code — unique id (letters, numbers, underscore _ , dash - , up to 64 characters). Cannot be changed later.
Title
Description (optional)
Footer (optional rich HTML for the bottom of the package page)

Click Apply .

The center creates the package, an empty manifest, and installs it for your center. You are taken to the new package editor. Splash image upload is available after creation via Edit Details .

5. Package page layout

The breadcrumb is Packages → package title .

5.1 Actions

Control	What it does
Edit Details	Opens the same fields as create (code is read-only), plus Package Splash Image .
Save	Writes the manifest to the server. Success message: Package saved successfully .

5.2 Header area

If a splash image is set, it appears as a wide banner. Description HTML may appear under the banner. Footer HTML appears below the tabs when set.

5.3 Tabs

Tab	Purpose
Courses	Course and unit tree, order, thumbnails.
Assessments	Assessments linked in the manifest.
Forms	Published custom forms linked to the package.

6. Edit package details

Open Edit Details .

Field	Notes
Code	Read-only after create.
Title , Description	Shown on the package page.
Footer	Optional HTML; links allowed where the editor supports them.
Package Splash Image	Upload Picture , Remove Picture . Large images may prompt to resize (max 256×256 pixels).

Click Apply to update the in-memory manifest. Click Save on the package page to persist.

Cancel closes the dialog without applying.

7. Courses tab

7.1 Courses

Click Add Course to open Add course . Set Title , Description , and options (see §8). Click Apply .

Each course row has:

A drag handle (≡) to reorder courses.
A row menu (⋮): Upload Thumbnail , Remove Thumbnail (when a thumbnail exists), Delete .
The title (link) to Edit course .
Code: and the internal course code.
Expand/collapse to show units.

Reorder courses by dragging the handle. Changes apply to the manifest in memory until Save .

Delete removes the course and its units from the manifest (no separate confirm in the row menu).

7.2 Units

Expand a course. Click Add Unit for Add unit (see §9).

Each unit row has the same pattern: drag to reorder within the course, row menu for thumbnail and Delete , title link to edit.

A unit chip shows Assessment: id or Content not set when no assessment is linked.

8. Course dialog

Add course or Edit course .

Field	Meaning
Title , Description	Shown in the package UI.
Non-scoreable	Course does not contribute to scoring.
Render as group of links	Present the course as a group of links instead of the default layout.

Apply updates the manifest in memory. Cancel closes without saving the dialog.

9. Unit dialog

Add unit or Edit unit .

9.1 Title and description

You can type Title and Description , or check:

Use title from linked assessment
Use description from linked assessment

When a box is checked, the field follows the assessment linked in Content source . If the assessment id is missing from the manifest, a warning explains that no assessment matches.

9.2 Content source

Assessment ID — pick an assessment already listed on the Assessments tab. Use Clear selection for no linked assessment. If the manifest has no assessments yet, helper text tells you to add them on the Assessments tab first.

9.3 Unit settings

Non-scoreable — unit does not contribute to scoring.

Click Apply , then Save on the package page.

10. Assessments tab

The table columns are Assessment ID , Title , Description , and Type .

Click Add Assessment to search and select assessments from your center. Selected items are added to the manifest in memory. Click Save to persist.

To remove an assessment:

Open the row menu and choose Delete .
Confirm when asked.

If any unit still references that assessment id, delete is blocked. A message lists the unit titles that use it. Remove or change those units first.

11. Forms tab

The table columns are ID , Title , Description , and Version .

Click Add form to search published custom forms. Each selected form is linked to the package on the server immediately; the table reloads.

To remove a form from the manifest, use the row menu Delete and confirm. Click Save if you have other unsaved manifest changes.

Forms must be published in Center → Forms before they appear in search.

12. Thumbnails

Location	How
Package splash	Edit Details → Upload Picture / Remove Picture
Course or unit	Row menu → Upload Thumbnail / Remove Thumbnail

Images larger than 256×256 pixels may ask whether to resize automatically. Thumbnail paths are stored in the manifest when you Save (upload runs when you select the file).

13. Typical workflow

Open Author → My Packages .
Add Package or open an existing package.
Edit Details for title, description, footer, and splash image. Save .
On Assessments , Add Assessment and Save .
On Courses , add courses and units; link units to assessments. Save .
On Forms , Add form for published forms learners should see in the package.
Reorder courses and units with drag handles. Save again after structural changes.

14. Troubleshooting

Problem	What to try
Author or My Packages is missing	You need the Author role and the author module on the center.
Code will not validate	Use only letters, numbers, _ , and - , max 64 characters.
Save seems ignored	Check for an error snackbar. Confirm you are on the package page, not only Apply in a dialog.
Dot on Save never clears	Another edit may have been made, or save failed. Reload the package and compare.
Cannot delete an assessment	A unit still references it. Edit or delete those units on Courses .
Assessment ID list is empty in unit dialog	Add assessments on the Assessments tab and Save .
Add form finds nothing	Publish the form in Forms first. Only published templates are searchable.
Thumbnail upload fails	Use a valid image file. Retry; check the error message.
Package fails to load	Verify the package code in the URL and that your center owns the package.

15. Glossary

Term	Meaning
Package	A marketplace product your center authors; identified by code .
Manifest	JSON structure: metadata, courses, units, assessments array, forms array.
Course	A section inside a package containing units.
Unit	A learning item inside a course; may link to an assessment .
Assessment (manifest row)	An assessment id registered in the package manifest for units and delivery.
Form (manifest row)	A published custom form linked to the package for learners or staff.

This manual describes the Package Editor (MPPackageEditor) in UnitusTI. Labels follow the English UI: Packages, Add Package, Edit Details, Save, Courses, Assessments, Forms, Apply, Cancel, Delete.