Step-by-Step Modular Builder & Packager Workflow # Step-by-Step Modular Builder & Packager Workflow This guide provides a comprehensive, step-by-step walkthrough for using the interactive **Modular Course Builder & Packager** to create, edit, and publish courses without technical packaging knowledge. --- ## Overview The Web Course Packager is designed to bypass prompt limits and token caps in AI chatbots (like Claude, Gemini, or ChatGPT). By creating your course page-by-page (module-by-module) as HTML fragments — or in plain text using [STF](help.php?doc=stf-format-guide) — and assembling them card-by-card, you can structure, preview, and publish a fully compliant course package without writing any code. The same tool also lets you reopen and edit a course you've already published. --- ## Step 1: Access the Packager Utility 1. Log in to your tenant learning portal (e.g., `https://yourtenant.superablelearning.com/login.php`). 2. Click the **Admin Panel** link located in the header navigation at the top of the dashboard. 3. On the first tab (**Courses & Packages**), find the section heading and click the button labeled **`Open Web Course Packager →`**. 4. You will land on the **Modular Course Builder & Packager** tool. > [!TIP] > **Screen Reader Navigation**: Visually impaired users can use the **"Skip to main content"** skip-link at the very beginning of the page to jump directly to the builder panel, skipping the site headers and nav links. --- ## Step 2: Set Up Course Metadata 1. In the first section, **Course Metadata & Styles**, fill in your general course info: - **Course Title**: Enter the name of your course (e.g., *Screen Reader Basics*). - **Access Control**: Choose who can view this course (e.g., *Public* or *Protected*). - **Course Description**: Provide a brief description summarizing the training. 2. If you have custom course-wide styles, expand the *Advanced Custom Styles & Scripts (CSS / JS)* section to paste them. --- ## Step 3: Add Module Content The **Modular Builder (Block-by-Block)** tab is active by default. Use this area to add course pages one-by-one. 1. Under **Course Modules Pages**, click **`Add New Module`** or edit the default starting module card. 2. For each module card, configure: - **Module Title**: The heading displayed to learners for this page (e.g., *Introduction to JAWS*). - **Filename / Target Path**: The file destination inside the package. The default path (e.g., `modules/module1.html`) is pre-filled and should be kept as-is unless you have custom folder requirements. - **Content Format**: Leave this on *Auto-detect* unless the tool warns you it guessed wrong — see the **`Content Format`** note below. - **Module Content**: Paste an HTML fragment generated by your AI assistant, or type plain [STF text](help.php?doc=stf-format-guide) directly — no HTML required. 3. To add more pages, click **`Add Another Module`**. 4. Use the **`Move Up`** and **`Move Down`** buttons on each card to rearrange the sequence of pages. > [!NOTE] > **Interactivity & Media**: Use the inline buttons above the content textarea (**`+ Image`**, **`+ Download`**, **`+ Audio`**) to inject accessible code templates for image captions, media players, and downloadable attachment links. The **`Insert Formatting…`** dropdown next to them inserts STF's Bold/Italic/Highlight markers around your current text selection, if you're typing STF and don't want to remember the symbols by hand. > [!TIP] > **Content Format**: The tool tries to detect whether you pasted HTML, STF, or JSON automatically. If it guesses wrong — or warns you that a module looks like it mixes HTML and STF — use the **`Content Format`** dropdown on that module's card to say explicitly which one you mean (*Auto-detect*, *Force Raw HTML*, or *Force STF*). A module can only be one or the other, not both. --- ## Step 4: Preview and Save Your Course 1. To test individual pages during editing, click **`Preview Module`** on any specific card. 2. To test the navigation flow of the entire course, click **`Full Course Live Preview`** in the top sticky toolbar. 3. If you need to stop and continue later, click **`Save Draft`** in the top toolbar to store your current layout securely in your browser's local storage. 4. When your course is complete, you have two ways to publish it: - **If you're logged in as an admin or editor** (i.e. you reached the packager via the Admin Panel), click **`Save Directly to Course Library`** in the top toolbar. This builds the package and adds it straight to your Course Library — no download or manual upload step. Skip to Step 6 if you want to reopen it later. - **If you're using the packager without being logged in** (the public tool, e.g. someone drafting a course before they have an account), click **`Generate & Download Course ZIP`** instead. A `.zip` package (e.g., `course_package.zip`) downloads to your computer, and you'll upload it manually — continue to Step 5. --- ## Step 5: Import a Downloaded Course Package Only needed if you used **`Generate & Download Course ZIP`** in Step 4. If you used **`Save Directly to Course Library`**, your course is already published — skip this step. 1. Click the **`Admin Panel`** button in the header at the top of the packager tool to return to your workspace. The active tenant session is automatically preserved. 2. Under the **Courses & Packages** tab, locate the section **Upload New Course (.zip)**. 3. Click the file selection field labeled **`Select Package (.zip)`** (this may show up as *Choose File* or *Browse* depending on your browser). 4. Locate the generated `.zip` file in your system folders (usually inside your *Downloads* directory) and select **Open**. 5. **Crucial**: Click the button below the file input labeled **`Upload & Import Package`**. 6. The screen will refresh and your new course will appear under the **Course Library** table near the bottom of the tab, ready to be launched or modified! --- ## Step 6: Editing an Existing Course You don't need to rebuild a course from scratch to fix a typo or tweak some wording. Any published course can be reopened in the packager: 1. From the **Admin Panel**'s **Courses & Packages** tab, find the course in your **Course Library** and click **`✎ Edit Modules in Packager`** next to it. 2. The packager opens with every module already loaded, and a banner at the top confirms which course you're editing. > [!WARNING] > **Keep the Course Title unchanged.** A course's identity is derived from its title. If you change the **Course Title** field while editing an existing course and then click **`Save Directly to Course Library`**, you'll create a brand-new, separate course instead of updating this one. Leave the title exactly as it was unless you genuinely want a new course. Modules opened this way default to a plain-text editing view rather than showing HTML — see the next section. --- ## Editing Text Without Touching HTML You don't need to know HTML to fix wording in a module. Two ways to edit text-only: **When you open an existing course (Step 6):** each module card shows its visible text as a simple list of editable fields under **Module Text** — no tags, `<div>`s, or attributes visible. Type your changes directly; they save as you type, no extra confirmation step needed. Everything else about the module — layout, styling, interactive components like flip cards or accordions — stays exactly as it was. If you do need to touch the underlying HTML (for example, to change a flip card's title or add a new element), expand **`Advanced: Edit Raw HTML`** below the text fields. This is the same raw editor described in Step 3. Closing that section afterward refreshes the plain-text fields above to match whatever you changed. **On any module card, regardless of how it was created:** click **`Edit Text Only`** near the bottom of the card (next to `Preview Module`) to open the same plain-text editing view in a popup, make your changes, and click **`Apply Changes`**. This is useful for reviewing or lightly editing a module you're actively building from scratch, without needing to reopen it later. > [!NOTE] > Text-only editing works on the *visible words* in a module — it can't add, remove, or rearrange HTML elements, and it won't do anything useful on a module written in STF (STF is already plain text, so just edit it directly in the Module Content box). --- ## Finding Your Way Around a Long Course Courses with many modules can get hard to navigate while editing. A few tools help: - **Module headings**: every module card has a real heading ("Module 6: Understanding ARIA") — screen reader users can jump directly between modules using their screen reader's heading-navigation key, the same way you'd jump between headings on any web page. - **Previous Module / Next Module**: buttons on every card move you straight to the neighboring module's heading without scrolling or tabbing through everything in between. These only move your focus — they don't reorder anything (that's what **`Move Up`** / **`Move Down`** are for). - **Jump to Module**: a dropdown listing every other module by title. Choose one and click the **`Go`** button beside it to jump there. (The dropdown alone doesn't jump you anywhere — you have to confirm with **`Go`**, so arrowing through the list to find the right one doesn't accidentally send you somewhere else.) - **Go to module number**: type a module's number into the small numeric field and press **Enter** (or click its **`Go`** button) to jump straight there — handy if you already know you want "module 14" and don't want to scan a list of titles. All of these are available on every module card, so you're never more than a couple of tab-stops away from being able to jump anywhere in the course, no matter how deep into a long course you are. --- ## Keyboard Shortcuts Two shortcuts are available anywhere on the page (except while a dialog/modal is open): | Shortcut | Action | | :--- | :--- | | `Alt` + `S` | Save a draft to your browser's local storage — the same as clicking **`Save Draft`**. | | `Alt` + `J` | Jump to the **Jump to Module** number field for whichever module you're currently working in. Type a module number and press Enter to jump. | There's no shortcut for **`Save Directly to Course Library`** — publishing a course is a deliberate action, so it's click-only on purpose.