Add studio-defined account-registration questions

Studio admins can now define registration questions that every new student
answers as a required second step during signup, with each student's answers
shown under a "Registration Information" section in the admin.

Extends the existing Registration domain: us_questions gains a scope column
(offering | account) and a nullable offering_id, and account answers reuse
us_question_answers with registration_type = 'account'. Authoring reuses the
Offerings -> Questions page via an "Account signup" scope (studio-admin only).
The registration form becomes two steps (progressive enhancement via
assets/js/register.js; works without JS); required answers are validated before
the account is created and apply to all signup paths (invite, group link,
self-approval). StudentHistory::registrationInfo() powers the admin section.

Bumps the plugin version to 1.1.0 so dbDelta runs the schema migration.

Closes #90

Co-Authored-By: Claude Opus 4.8 <[email protected]>

templates/admin/questions.php

@@ -10,6 +10,8 @@ if (! defined('ABSPATH')) {
 /**
  * @var list<\Unsupervised\Schedular\Offering\Offering> $offeringList
  * @var \Unsupervised\Schedular\Offering\Offering|null   $selectedOffering
+ * @var bool $accountScope Whether the studio-wide account-signup questions are selected.
+ * @var bool $manageAll    Whether the current user is a studio admin (may edit account questions).
  * @var list<\Unsupervised\Schedular\Registration\Question>|null $questions
  */
 ?>
@@ -18,21 +20,31 @@ if (! defined('ABSPATH')) {
 
     <form method="get">
         <input type="hidden" name="page" value="us-questions">
-        <label for="offering_id"><?php esc_html_e('Offering', 'unsupervised-schedular'); ?></label>
+        <label for="offering_id"><?php esc_html_e('Questions for', 'unsupervised-schedular'); ?></label>
         <select name="offering_id" id="offering_id" onchange="this.form.submit()">
-            <option value="0"><?php esc_html_e('— Select an offering —', 'unsupervised-schedular'); ?></option>
+            <option value="0"><?php esc_html_e('— Select —', 'unsupervised-schedular'); ?></option>
+            <?php if ($manageAll) : ?>
+                <option value="<?php echo esc_attr(Question::SCOPE_ACCOUNT); ?>" <?php selected($accountScope); ?>>
+                    <?php esc_html_e('Account signup (all registrations)', 'unsupervised-schedular'); ?>
+                </option>
+            <?php endif; ?>
             <?php foreach ($offeringList as $offering) : ?>
-                <option value="<?php echo esc_attr((string) $offering->id); ?>" <?php selected($selectedOffering && $selectedOffering->id === $offering->id); ?>>
+                <option value="<?php echo esc_attr((string) $offering->id); ?>" <?php selected(! $accountScope && $selectedOffering && $selectedOffering->id === $offering->id); ?>>
                     <?php echo esc_html($offering->title); ?>
                 </option>
             <?php endforeach; ?>
         </select>
     </form>
 
-    <?php if (null === $selectedOffering) : ?>
-        <p><?php esc_html_e('Choose an offering to manage its intake questions.', 'unsupervised-schedular'); ?></p>
+    <?php if (! $accountScope && null === $selectedOffering) : ?>
+        <p><?php esc_html_e('Choose an offering to manage its intake questions, or "Account signup" for the questions every new student answers when registering.', 'unsupervised-schedular'); ?></p>
     <?php else : ?>
-        <h2><?php echo esc_html(sprintf(/* translators: %s: offering title */ __('Questions for "%s"', 'unsupervised-schedular'), $selectedOffering->title)); ?></h2>
+        <?php if ($accountScope) : ?>
+            <h2><?php esc_html_e('Account signup questions', 'unsupervised-schedular'); ?></h2>
+            <p><?php esc_html_e('Every new student answers these required-if-marked questions as a second step after choosing their name and password.', 'unsupervised-schedular'); ?></p>
+        <?php else : ?>
+            <h2><?php echo esc_html(sprintf(/* translators: %s: offering title */ __('Questions for "%s"', 'unsupervised-schedular'), $selectedOffering->title)); ?></h2>
+        <?php endif; ?>
 
         <h3><?php esc_html_e('Add Question', 'unsupervised-schedular'); ?></h3>
         <form method="post">
@@ -74,7 +86,7 @@ if (! defined('ABSPATH')) {
 
         <h3><?php esc_html_e('Current Questions', 'unsupervised-schedular'); ?></h3>
         <?php if (empty($questions)) : ?>
-            <p><?php esc_html_e('No questions configured for this offering.', 'unsupervised-schedular'); ?></p>
+            <p><?php esc_html_e('No questions configured yet.', 'unsupervised-schedular'); ?></p>
         <?php else : ?>
             <table class="wp-list-table widefat fixed striped">
                 <thead>

templates/admin/student-detail.php

@@ -11,6 +11,7 @@ if (! defined('ABSPATH')) {
  * @var list<array{id: int, start_dt: string, end_dt: string, offering: string, instructor: string, status: string}> $past
  * @var list<array{id: int, offering: string, status: string}> $enrolments
  * @var list<array{policy: string, version: string, context: string, accepted_at: string}> $acceptances
+ * @var list<array{question: string, answer: string, required: bool}> $registrationInfo
  * @var list<array{question: string, answer: string, context: string}> $intake
  * @var list<array{created_at: string, context: string, method: string, status: string, amount: float, tax_amount: float, total: float, currency: string, receipt: string}> $payments
  * @var string $backUrl
@@ -101,6 +102,33 @@ $renderLessons = static function (array $rows, bool $withActions = false): void
         <?php submit_button(esc_html__('Save account details', 'unsupervised-schedular'), 'secondary', 'submit', false); ?>
     </form>
 
+    <h2><?php esc_html_e('Registration Information', 'unsupervised-schedular'); ?></h2>
+    <?php if (empty($registrationInfo)) : ?>
+        <p><?php esc_html_e('No registration questions are configured.', 'unsupervised-schedular'); ?></p>
+    <?php else : ?>
+        <table class="wp-list-table widefat fixed striped">
+            <thead>
+                <tr>
+                    <th><?php esc_html_e('Question', 'unsupervised-schedular'); ?></th>
+                    <th><?php esc_html_e('Answer', 'unsupervised-schedular'); ?></th>
+                </tr>
+            </thead>
+            <tbody>
+                <?php foreach ($registrationInfo as $row) : ?>
+                    <tr>
+                        <td>
+                            <?php echo esc_html($row['question']); ?>
+                            <?php if ($row['required']) : ?>
+                                <span class="us-required" aria-hidden="true">*</span>
+                            <?php endif; ?>
+                        </td>
+                        <td><?php echo esc_html($row['answer']); ?></td>
+                    </tr>
+                <?php endforeach; ?>
+            </tbody>
+        </table>
+    <?php endif; ?>
+
     <?php if ($canBilling) : ?>
         <h2><?php esc_html_e('Billing method', 'unsupervised-schedular'); ?></h2>
         <form method="post">

templates/frontend/register-page.php

@@ -1,6 +1,8 @@
 <?php
 declare(strict_types=1);
 
+use Unsupervised\Schedular\Registration\Question;
+
 if (! defined('ABSPATH')) {
     exit;
 }
@@ -16,7 +18,42 @@ if (! defined('ABSPATH')) {
  * @var string $loginUrl Where the post-confirmation sign-in link points.
  * @var string $error
  * @var list<array{policy: \Unsupervised\Schedular\Policy\Policy, version: \Unsupervised\Schedular\Policy\PolicyVersion}> $policyForms
+ * @var list<Question> $accountQuestions Studio-wide questions answered as step two.
  */
+
+/**
+ * Render one account-signup question's input, named `us_answers[<id>]`.
+ */
+$renderQuestionField = static function (Question $question): void {
+    $id       = (int) $question->id;
+    $name     = 'us_answers[' . $id . ']';
+    $fieldId  = 'us-reg-q-' . $id;
+    $required = $question->isRequired ? ' required' : '';
+    ?>
+    <p>
+        <label for="<?php echo esc_attr($fieldId); ?>">
+            <?php echo esc_html($question->label); ?>
+            <?php if ($question->isRequired) : ?>
+                <span class="us-required" aria-hidden="true">*</span>
+            <?php endif; ?>
+        </label>
+        <?php if ($question->fieldType === Question::FIELD_TEXTAREA) : ?>
+            <textarea name="<?php echo esc_attr($name); ?>" id="<?php echo esc_attr($fieldId); ?>" rows="4"<?php echo $required; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- literal attribute string. ?>></textarea>
+        <?php elseif ($question->fieldType === Question::FIELD_SELECT) : ?>
+            <select name="<?php echo esc_attr($name); ?>" id="<?php echo esc_attr($fieldId); ?>"<?php echo $required; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- literal attribute string. ?>>
+                <option value=""><?php esc_html_e('— Select —', 'unsupervised-schedular'); ?></option>
+                <?php foreach ((array) $question->options as $option) : ?>
+                    <option value="<?php echo esc_attr((string) $option); ?>"><?php echo esc_html((string) $option); ?></option>
+                <?php endforeach; ?>
+            </select>
+        <?php elseif ($question->fieldType === Question::FIELD_CHECKBOX) : ?>
+            <input type="checkbox" name="<?php echo esc_attr($name); ?>" id="<?php echo esc_attr($fieldId); ?>" value="1"<?php echo $required; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- literal attribute string. ?>>
+        <?php else : ?>
+            <input type="text" name="<?php echo esc_attr($name); ?>" id="<?php echo esc_attr($fieldId); ?>"<?php echo $required; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- literal attribute string. ?>>
+        <?php endif; ?>
+    </p>
+    <?php
+};
 ?>
 <div class="us-register-form">
     <?php if ($successType === 'invite') : ?>
@@ -43,49 +80,73 @@ if (! defined('ABSPATH')) {
                 <p class="us-error" role="alert"><?php echo esc_html($error); ?></p>
             <?php endif; ?>
 
-            <form method="post" action="">
+            <?php $hasQuestions = ! empty($accountQuestions); ?>
+            <form method="post" action="" <?php echo $hasQuestions ? 'data-steps="1"' : ''; ?>>
                 <?php wp_nonce_field('us_student_register'); ?>
                 <input type="hidden" name="us_invite" value="<?php echo esc_attr($token); ?>">
 
-                <p>
-                    <label for="us-reg-email"><?php esc_html_e('Email', 'unsupervised-schedular'); ?></label>
-                    <?php if ($inviteValid && $invite !== null && ! $invite->isGroup()) : ?>
-                        <input type="email" id="us-reg-email" value="<?php echo esc_attr($invite->email); ?>" readonly>
-                    <?php else : ?>
-                        <input type="email" name="email" id="us-reg-email" autocomplete="email" required>
+                <div class="us-reg-step" data-step="1">
+                    <p>
+                        <label for="us-reg-email"><?php esc_html_e('Email', 'unsupervised-schedular'); ?></label>
+                        <?php if ($inviteValid && $invite !== null && ! $invite->isGroup()) : ?>
+                            <input type="email" id="us-reg-email" value="<?php echo esc_attr($invite->email); ?>" readonly>
+                        <?php else : ?>
+                            <input type="email" name="email" id="us-reg-email" autocomplete="email" required>
+                        <?php endif; ?>
+                    </p>
+                    <p>
+                        <label for="us-reg-name"><?php esc_html_e('Your name', 'unsupervised-schedular'); ?></label>
+                        <input type="text" name="display_name" id="us-reg-name" autocomplete="name" required>
+                    </p>
+                    <p>
+                        <label for="us-reg-pass"><?php esc_html_e('Password', 'unsupervised-schedular'); ?></label>
+                        <input type="password" name="password" id="us-reg-pass" autocomplete="new-password" minlength="8" required>
+                    </p>
+
+                    <?php if (! empty($policyForms)) : ?>
+                        <fieldset class="us-policies">
+                            <legend><?php esc_html_e('Policies', 'unsupervised-schedular'); ?></legend>
+                            <?php foreach ($policyForms as $form) : ?>
+                                <div class="us-policy">
+                                    <h4><?php echo esc_html($form['policy']->title); ?></h4>
+                                    <div class="us-policy-body"><?php echo wp_kses_post((string) $form['version']->body); ?></div>
+                                    <label>
+                                        <input type="checkbox" name="accept[]" value="<?php echo esc_attr((string) $form['version']->id); ?>" required>
+                                        <?php
+                                        /* translators: %s: policy title */
+                                        echo esc_html(sprintf(__('I have read and agree to the %s.', 'unsupervised-schedular'), $form['policy']->title));
+                                        ?>
+                                    </label>
+                                </div>
+                            <?php endforeach; ?>
+                        </fieldset>
                     <?php endif; ?>
-                </p>
-                <p>
-                    <label for="us-reg-name"><?php esc_html_e('Your name', 'unsupervised-schedular'); ?></label>
-                    <input type="text" name="display_name" id="us-reg-name" autocomplete="name" required>
-                </p>
-                <p>
-                    <label for="us-reg-pass"><?php esc_html_e('Password', 'unsupervised-schedular'); ?></label>
-                    <input type="password" name="password" id="us-reg-pass" autocomplete="new-password" minlength="8" required>
-                </p>
 
-                <?php if (! empty($policyForms)) : ?>
-                    <fieldset class="us-policies">
-                        <legend><?php esc_html_e('Policies', 'unsupervised-schedular'); ?></legend>
-                        <?php foreach ($policyForms as $form) : ?>
-                            <div class="us-policy">
-                                <h4><?php echo esc_html($form['policy']->title); ?></h4>
-                                <div class="us-policy-body"><?php echo wp_kses_post((string) $form['version']->body); ?></div>
-                                <label>
-                                    <input type="checkbox" name="accept[]" value="<?php echo esc_attr((string) $form['version']->id); ?>" required>
-                                    <?php
-                                    /* translators: %s: policy title */
-                                    echo esc_html(sprintf(__('I have read and agree to the %s.', 'unsupervised-schedular'), $form['policy']->title));
-                                    ?>
-                                </label>
-                            </div>
-                        <?php endforeach; ?>
-                    </fieldset>
+                    <?php if ($hasQuestions) : ?>
+                        <p>
+                            <button type="button" class="us-reg-next"><?php esc_html_e('Next', 'unsupervised-schedular'); ?></button>
+                        </p>
+                    <?php else : ?>
+                        <p>
+                            <input type="submit" name="us_register" value="<?php esc_attr_e('Create Account', 'unsupervised-schedular'); ?>">
+                        </p>
+                    <?php endif; ?>
+                </div>
+
+                <?php if ($hasQuestions) : ?>
+                    <div class="us-reg-step" data-step="2">
+                        <fieldset class="us-reg-questions">
+                            <legend><?php esc_html_e('Registration information', 'unsupervised-schedular'); ?></legend>
+                            <?php foreach ($accountQuestions as $question) : ?>
+                                <?php $renderQuestionField($question); ?>
+                            <?php endforeach; ?>
+                        </fieldset>
+                        <p>
+                            <button type="button" class="us-reg-back"><?php esc_html_e('Back', 'unsupervised-schedular'); ?></button>
+                            <input type="submit" name="us_register" value="<?php esc_attr_e('Create Account', 'unsupervised-schedular'); ?>">
+                        </p>
+                    </div>
                 <?php endif; ?>
-
-                <p>
-                    <input type="submit" name="us_register" value="<?php esc_attr_e('Create Account', 'unsupervised-schedular'); ?>">
-                </p>
             </form>
         <?php endif; ?>
     <?php endif; ?>