Loop mappings

Loop mappings are reusable lists of iteration items (sections, chapters, topics) that plans reference from loop settings. They live in a shared catalog — not inline on each plan.

Where to work

Open Administration → Curriculum → Study plans → Mappings (/admin/mappings).

Action	How
Browse mappings	Mappings list (tree)
Create a mapping	New mapping
Edit items	Open a custom mapping

System mappings (Canon books, Canon chapters) appear in the list for reference. They are read-only — resolved from KJV book/chapter config, not stored in the database.

Structure

Field	Purpose
Title / slug	Human name and stable reference in plans and dumps
Parent	Folder in the tree (e.g. group book-specific children)
Book	On a child mapping: auto-select when a generic book study’s focus matches
Related mapping	Optional link so items can be grouped under another mapping’s rows
Field keys	Columns for each item (section, title, chapter, …)
Items	Ordered rows with a stable key and field values

Example hierarchy:

1. Book sections (folder, no items)
2. John sections (child, book_id = Jhn, items: prologue, John 2, …)
3. John section outlines (related to John sections; items use parent_item_key)

Using mappings on a plan

In the study plan step editor:

1. Select one or more contiguous steps in the outline and Wrap selection in loop.
2. Click the loop header to open loop settings in the right panel.
3. For mapped loops, choose Items come from → a mapping, or items collected by another loop (that loop must have output enabled). Leave item keys empty to use all items; pick a subset to use only some rows.
4. On generic book plans, add book bindings: per canonical book id, choose which mapping(s) unroll for that book. Books without a binding stay on the open loop.

On the same loop panel, Output chooses whether the learner names the item, marks a Bible range, and whether that happens on the first or last write-note step.

Use Insert variable on step titles and instructions for placeholders such as {{section}}, {{index}}, and mapping field keys.

Curriculum backup

Custom mappings export in curriculum dumps as loop-mappings/{slug}.json. Plans store mapping slugs in loop JSON. See Curriculum backup.

Planning detail: Study Plans — Loop mappings.