Addon for Modularity for creating guides
Guides are shown step by step: one question at a time, with a progress sidebar and a summary page.
-
Questions: every step that contains a Checkboxes layout becomes a question. Text, modal text and related guides in the same step are shown under the answers (they still react to toggle keys).
-
Summary content: Content on the Summary page tab (for example a todo list or what to do next) is shown under the answers, filtered by the visitor's answers. Steps without answer options are also shown there (that is where older guides kept it; the migration moves them).
-
Guides without questions: if no step has answer options, the content is shown as it is, without the step by step frame.
-
Per step: Short title (sidebar and summary), Icon (Material Symbols name), Description, Help text and Answers: one answer (radio buttons) or several answers (checkboxes, default).
-
Per answer: Description and Outcome:
- Continue to next question (default): the visitor continues.
- Stop the guide: the guide ends and the summary shows the Reason.
- Needs to be checked: as stop, but presented as something to look into, e.g. "I don't know".
With several answers, the most severe outcome wins (stop before check before continue). Outcome tags are only shown on questions where an answer can end the guide. The setting Show outcomes on answers (on by default) hides the tags; the note under the answers is then neutral, and the outcome is only shown on the summary page.
-
Summary page: titles and texts for each outcome and a notice. Empty fields use default texts. Visitors can edit answers, print/save as PDF, save their answers as a text file or start over. Nothing is sent or stored.
The edit screen has three tabs: Questions, Summary page and Settings.
- Questions start collapsed (showing their title). Short title, icon, description and help text are under More settings.
- Summary page → Content holds sections shown under the answers: a title, a description and text, modal texts, a todo list or related guides.
- Answers are added with Answers and content → Answer options.
- Show when on tips, modal texts, todo items and related guides lists the guide's answers: the content is shown when the visitor chooses any of them. It is stored as toggle keys, so the toggle engine and the e-mail export work as before. The list is filled from the saved guide, so save once after adding new answers.
- Answers get a toggle key automatically when it is empty. A question's toggle keys, relations and
the old toggle key fields are only shown when its Show advanced fields switch is on (for AND/NOT
expressions such as
a+bora-b). They are hidden visually, so their values are always saved.
Earlier versions showed guides as an accordion. Existing guides work in the step by step mode without changes, but run the migration once per site after deploying:
wp modularity-guides migrate-to-wizard --dry-run --url=https://example.com
wp modularity-guides migrate-to-wizard --url=https://example.comIt sets several answers explicitly on every question, removes accordion-only data
(display_mode, the unused Required flag on checkboxes), moves steps without answer options to
Summary page → Content (they were already shown on the summary page, so guides look the same)
and lists what editors should review: guides without questions and checkboxes that used to be
required.
composer install
npm ci
npm run buildvendor/bin/phpunit
npx jest
vendor/bin/mago lint source/php
npx biome lint ./sourceRun languages/localize.sh after changing strings (make-pot, update-po, make-mo).
Texts with numbers in the step by step script are prepared server side with _n_noop(),
so add plural forms in the .po file rather than in TypeScript.
source/sass/_wizard.scss lives in the theme's plugin cascade layer and is built on the design
system tokens (--space, --border-radius, --font-size-*, --color--* …). Every token can be
overridden for the guide only with --mod-guide-wizard--<token>, e.g.
--mod-guide-wizard--space: 0.75. The layout uses container queries on the module, so it adapts
to the width of the page area it is placed in.
source/js/Wizard/ holds the step by step script: GuideWizard (navigation), Answers (reads the
inputs), Sidebar, Summary, TextExport, Toast and small helpers.