Ask some registration questions of students only, and require them of students without requiring them of the account holder #164

Merged
thatguygriff merged 1 commits from feature/student-scoped-registration-questions into main 2026-07-30 16:56:33 +00:00
20 changed files with 809 additions and 85 deletions
Showing only changes of commit 434fe801ba - Show all commits
+4 -1
View File
@@ -11,7 +11,10 @@ When a `v*` tag is pushed, `.gitea/workflows/release.yml` publishes the matching
the plugin to the next patch version and adds a fresh section here for it. Record the plugin to the next patch version and adds a fresh section here for it. Record
each change under the current top section as you work. each change under the current top section as you work.
## [1.4.2] ## [1.5.0]
### Added
- **A registration question can now be asked of students only, and can be required of a student without being required of the account holder.** Every account-signup question was asked of everybody who registered, on the same terms — so "School and grade" had to be put to the adult signing themselves up, and a question a studio needed answered for a child could only be made required by demanding it of everyone. Each question now says who it is asked of — everyone, or only the students you register on behalf of — and carries its own **Required** setting for each: optional for you, required for every student you enrol, is now a thing a studio can ask for. Existing questions are untouched: they stay asked of everyone, and one that was required stays required of everyone.
## [1.4.1] ## [1.4.1]
+37 -8
View File
@@ -23,11 +23,32 @@ and the same authoring page (**Offerings → Questions**).
| `label` | VARCHAR(255) | The question text shown to the registrant | | `label` | VARCHAR(255) | The question text shown to the registrant |
| `field_type` | VARCHAR(20) | `text` / `textarea` / `select` / `checkbox` | | `field_type` | VARCHAR(20) | `text` / `textarea` / `select` / `checkbox` |
| `options` | TEXT | JSON array of choices (for `select`); NULL otherwise | | `options` | TEXT | JSON array of choices (for `select`); NULL otherwise |
| `is_required` | TINYINT(1) | 1 = registrant must answer to continue | | `audience` | VARCHAR(20) | `all` (default) or `child` — who the question is asked of (account scope) |
| `is_required` | TINYINT(1) | 1 = the **account holder** must answer to continue |
| `is_required_child` | TINYINT(1) | 1 = each **student being registered** must answer to continue |
| `sort_order` | INT | Display order within the scope | | `sort_order` | INT | Display order within the scope |
| `is_active` | TINYINT(1) | 0 = retired, 1 = shown on the form | | `is_active` | TINYINT(1) | 0 = retired, 1 = shown on the form |
| `created_at` | DATETIME | Insertion time | | `created_at` | DATETIME | Insertion time |
## Audience and Required-ness (account scope)
An account-scope question is asked in two places, and the two are configured separately:
- **The account holder's own "About you" panel** — shown when they are registering
themselves (`self` or `both`). Governed by `audience` (a `child` question is not asked
here at all) and by `is_required`.
- **Each student block** — one per person they are registering on behalf of, on the signup
form and on the guardian's family screen. Every question is asked here regardless of
`audience`; `is_required_child` decides whether it blocks submission.
That split is what lets a studio ask "School and grade" of children only, or make
"Previous experience" optional for an adult signing themselves up but required for every
child they enrol. `audience = 'child'` leaves `is_required` moot — the question never
reaches the account holder's panel.
`audience` and `is_required_child` are ignored for offering-scope questions: booking and
enrolment ask their intake questions once, about the student being booked, with no separate
account-holder form to differ from.
## Data Model — `{prefix}us_question_answers` ## Data Model — `{prefix}us_question_answers`
| Column | Type | Notes | | Column | Type | Notes |
@@ -51,19 +72,24 @@ lesson, a group enrolment, or an account signup (`account` + the user ID).
## Account-scope Flow (signup) ## Account-scope Flow (signup)
1. The `[us_student_register]` page (`Auth\RegistrationPage`) loads active account-scope questions via `QuestionRepository::findByScope('account')`. 1. The `[us_student_register]` page (`Auth\RegistrationPage`) loads active account-scope questions via `QuestionRepository::findByScope('account')`.
2. The form is a single page. The questions sit in an **About you** panel, alongside the account holder's birth year, between the "Who are you registering?" choice and the students being added. `assets/js/register.js` disables and hides that whole panel when the choice is "on behalf of students" — the questions describe a student and a pure guardian is not one — and puts the same questions in every child block instead. Progressive enhancement: without JS every panel shows and the single submit still works. This applies to **every** signup path (invite, group link, self-approval). 2. The form is a single page. The questions sit in an **About you** panel, alongside the account holder's birth year, between the "Who are you registering?" choice and the students being added — minus any `audience = 'child'` question, which is never asked of the account holder. `assets/js/register.js` disables and hides that whole panel when the choice is "on behalf of students" — the questions describe a student and a pure guardian is not one — and puts the full question set in every child block instead. Progressive enhancement: without JS every panel shows and the single submit still works. This applies to **every** signup path (invite, group link, self-approval).
3. On submit, required answers are validated **before** the user is created (a missing answer returns an error and creates no account); after creation each answered question is written to `us_question_answers` with `registration_type = 'account'`, `registration_id = student_id = <new user ID>`. 3. On submit, required answers are validated **before** the user is created (a missing answer returns an error and creates no account)`is_required` against the account holder's panel, `is_required_child` against each student block; after creation each answered question is written to `us_question_answers` with `registration_type = 'account'`, `registration_id = student_id = <new user ID>`. An answer posted for a `child`-audience question against the account holder is discarded, not stored.
4. A studio admin reviews the answers on the student's admin screen under **Registration Information** (`Auth\StudentHistory::registrationInfo()` lists every account question paired with the student's answer, "—" when unanswered). These rows are excluded from the offering-scope "Intake answers" table. 4. A studio admin reviews the answers on the student's admin screen under **Registration Information** (`Auth\StudentHistory::registrationInfo()` lists every account question paired with the student's answer, "—" when unanswered). These rows are excluded from the offering-scope "Intake answers" table.
## Admin Interface ## Admin Interface
Both scopes are edited from **Offerings → Questions** (`Registration\QuestionController`): Both scopes are edited from **Offerings → Questions** (`Registration\QuestionController`):
- Pick an offering to edit its questions, or **"Account signup (all registrations)"** for the account-scope questions. - Pick an offering to edit its questions, or **"Account signup (all registrations)"** for the account-scope questions.
- The account-scope form adds **Asked of** (everyone / students only) and a second **Required** checkbox for students; both are hidden for offering scope, where they have no meaning.
- Studio admin (`manage_questions` + `manage_instructors`) edits any offering's questions and the account-scope questions. - Studio admin (`manage_questions` + `manage_instructors`) edits any offering's questions and the account-scope questions.
- Instructor (`manage_questions`) edits questions only on their own offerings; the account-scope option is hidden. - Instructor (`manage_questions`) edits questions only on their own offerings; the account-scope option is hidden.
## REST API ## REST API
Only offering-scope questions are exposed over REST. Account-scope questions are managed Only offering-scope questions are exposed over REST. Account-scope questions are managed
through the server-rendered admin page and read directly by `RegistrationPage`. through the server-rendered admin page and read directly by `RegistrationPage` — a request
naming one is turned away as not found, since the owner check has no offering to check
against, so REST can neither read nor overwrite an `audience`. An offering question written
over REST mirrors its single `is_required` into `is_required_child`, as the admin form and
the upgrade backfill both do.
| Method | Endpoint | Permission | | Method | Endpoint | Permission |
|----------|---------------------------------------------------|----------------------| |----------|---------------------------------------------------|----------------------|
@@ -74,12 +100,13 @@ through the server-rendered admin page and read directly by `RegistrationPage`.
## Implementation ## Implementation
- Repositories: `Unsupervised\Schedular\Registration\QuestionRepository` (`findByOffering`, `findByScope`), `Unsupervised\Schedular\Registration\AnswerRepository` - Repositories: `Unsupervised\Schedular\Registration\QuestionRepository` (`findByOffering`, `findByScope`), `Unsupervised\Schedular\Registration\AnswerRepository`
- Models: `Unsupervised\Schedular\Registration\Question` (`scope`, nullable `offeringId`), `Unsupervised\Schedular\Registration\Answer` (`REG_ACCOUNT`) - Models: `Unsupervised\Schedular\Registration\Question` (`scope`, nullable `offeringId`, `audience`, `isRequiredChild`, and the `askedOfSelf()` / `isRequiredForSelf()` / `isRequiredForChild()` readers every caller uses instead of touching `isRequired` directly), `Unsupervised\Schedular\Registration\Answer` (`REG_ACCOUNT`)
- Admin controller: `Unsupervised\Schedular\Registration\QuestionController` - Admin controller: `Unsupervised\Schedular\Registration\QuestionController`
- REST endpoint: `Unsupervised\Schedular\Registration\QuestionEndpoint` (offering scope only) - REST endpoint: `Unsupervised\Schedular\Registration\QuestionEndpoint` (offering scope only)
- Signup form: `Unsupervised\Schedular\Auth\RegistrationPage`, `templates/frontend/register-page.php`, `assets/js/register.js` - Signup form: `Unsupervised\Schedular\Auth\RegistrationPage`, `templates/frontend/register-page.php`, `assets/js/register.js`
- Admin review: `Unsupervised\Schedular\Auth\StudentHistory::registrationInfo()`, `templates/admin/student-detail.php` - Admin review: `Unsupervised\Schedular\Auth\StudentHistory::registrationInfo()`, `templates/admin/student-detail.php`
- Schema: `us_questions.scope` + nullable `us_questions.offering_id` (requires a plugin version bump so `dbDelta` runs) - Schema: `us_questions.scope` + nullable `us_questions.offering_id`, `us_questions.audience`, `us_questions.is_required_child` (each requires a plugin version bump so `dbDelta` runs)
- Required-for-students backfill: `is_required_child` arrives with `DEFAULT 0`, which would quietly make every existing required question optional for students. `QuestionRepository::backfillChildRequired()` copies `is_required` into it once; `Plugin::boot()` runs it guarded by the `us_questions_child_required_backfilled` option, after the version gate has let `dbDelta` add the column
- Nullability repair: `dbDelta` does **not** reliably relax a column from `NOT NULL` to `NULL`, so sites created before account-scope questions kept `offering_id NOT NULL` and rejected account inserts. `QuestionRepository::ensureOfferingNullable()` re-applies the nullable definition (idempotent `ALTER … MODIFY`); `Plugin::boot()` runs it once, guarded by the `us_questions_offering_nullable` option rather than the version gate (affected sites may already be on the current version) - Nullability repair: `dbDelta` does **not** reliably relax a column from `NOT NULL` to `NULL`, so sites created before account-scope questions kept `offering_id NOT NULL` and rejected account inserts. `QuestionRepository::ensureOfferingNullable()` re-applies the nullable definition (idempotent `ALTER … MODIFY`); `Plugin::boot()` runs it once, guarded by the `us_questions_offering_nullable` option rather than the version gate (affected sites may already be on the current version)
## Tests ## Tests
@@ -87,8 +114,10 @@ through the server-rendered admin page and read directly by `RegistrationPage`.
- `tests/Unit/Registration/AnswerRepositoryTest.php` - `tests/Unit/Registration/AnswerRepositoryTest.php`
- `tests/Unit/Registration/QuestionTest.php` - `tests/Unit/Registration/QuestionTest.php`
- `tests/Unit/Registration/AnswerTest.php` - `tests/Unit/Registration/AnswerTest.php`
- `tests/Unit/Registration/QuestionFieldTest.php`
- `tests/Unit/Auth/RegistrationPageTest.php` - `tests/Unit/Auth/RegistrationPageTest.php`
- `tests/Unit/Auth/StudentHistoryTest.php` - `tests/Unit/Auth/StudentHistoryTest.php`
- `tests/Unit/Guardian/FamilyPageTest.php`
## Per-Child Answers ## Per-Child Answers
For a parent/guardian signup, **account-scope** questions are asked **once per For a parent/guardian signup, **account-scope** questions are asked **once per
@@ -96,5 +125,5 @@ child** rather than once per guardian — in practice they describe the student
(instrument, level, school), not the account holder. Each answer's `student_id` (instrument, level, school), not the account holder. Each answer's `student_id`
and `registration_id` are the child's user ID, so a studio admin reading a and `registration_id` are the child's user ID, so a studio admin reading a
child's screen sees the information that describes them. The guardian's family child's screen sees the information that describes them. The guardian's family
screen asks the same questions when a child is added later. See screen asks the same questions when a child is added later, under the same
`parent-guardian-accounts.md`. `is_required_child` rule as the signup form. See `parent-guardian-accounts.md`.
+18 -5
View File
@@ -319,6 +319,13 @@ class RegistrationPage {
// student themselves. "Both" is both. // student themselves. "Both" is both.
$registeringFor = $this->submittedRegisteringFor(); $registeringFor = $this->submittedRegisteringFor();
// A "students only" question is never put to the account holder, so it is
// dropped before their answers are validated or stored — a crafted post
// cannot file one against them.
$selfQuestions = array_values(
array_filter( $accountQuestions, static fn( Question $question ): bool => $question->askedOfSelf() )
);
// "Students" and "both" collect student blocks; only "self" does not. // "Students" and "both" collect student blocks; only "self" does not.
$isGuardian = self::FOR_SELF !== $registeringFor; $isGuardian = self::FOR_SELF !== $registeringFor;
@@ -355,7 +362,7 @@ class RegistrationPage {
// Checked as two passes rather than one so the message can say *whose* // Checked as two passes rather than one so the message can say *whose*
// answers are missing — under "both" a single message could not. // answers are missing — under "both" a single message could not.
foreach ( array_column( $children, 'answers' ) as $set ) { foreach ( array_column( $children, 'answers' ) as $set ) {
if ( $this->hasUnansweredRequired( $accountQuestions, $set ) ) { if ( $this->hasUnansweredRequired( $accountQuestions, $set, forChild: true ) ) {
return esc_html__( 'Please answer all required registration questions for each student.', 'unsupervised-schedular' ); return esc_html__( 'Please answer all required registration questions for each student.', 'unsupervised-schedular' );
} }
} }
@@ -369,7 +376,7 @@ class RegistrationPage {
return esc_html( GuardianService::ownBirthYearError() ); return esc_html( GuardianService::ownBirthYearError() );
} }
if ( $asksSelf && $this->hasUnansweredRequired( $accountQuestions, $answers ) ) { if ( $asksSelf && $this->hasUnansweredRequired( $selfQuestions, $answers ) ) {
return esc_html__( 'Please answer all required registration questions.', 'unsupervised-schedular' ); return esc_html__( 'Please answer all required registration questions.', 'unsupervised-schedular' );
} }
@@ -420,7 +427,7 @@ class RegistrationPage {
// After the children, so a rollback that deletes this account cannot // After the children, so a rollback that deletes this account cannot
// leave its answers behind pointing at a user that no longer exists. // leave its answers behind pointing at a user that no longer exists.
if ( $asksSelf ) { if ( $asksSelf ) {
$this->recordAnswers( $accountQuestions, $answers, (int) $userId ); $this->recordAnswers( $selfQuestions, $answers, (int) $userId );
} }
if ( $inviteValid && ! $invite->isGroup() ) { if ( $inviteValid && ! $invite->isGroup() ) {
@@ -564,12 +571,18 @@ class RegistrationPage {
/** /**
* Whether any required question in `$questions` is left blank in `$answers`. * Whether any required question in `$questions` is left blank in `$answers`.
* *
* `$forChild` picks which required-ness applies: a question can be optional
* for the account holder answering about themselves and still required of
* every student they register.
*
* @param list<Question> $questions * @param list<Question> $questions
* @param array<int, string> $answers * @param array<int, string> $answers
*/ */
private function hasUnansweredRequired( array $questions, array $answers ): bool { private function hasUnansweredRequired( array $questions, array $answers, bool $forChild = false ): bool {
foreach ( $questions as $question ) { foreach ( $questions as $question ) {
if ( $question->isRequired && '' === trim( (string) ( $answers[ (int) $question->id ] ?? '' ) ) ) { $required = $forChild ? $question->isRequiredForChild() : $question->isRequiredForSelf();
if ( $required && '' === trim( (string) ( $answers[ (int) $question->id ] ?? '' ) ) ) {
return true; return true;
} }
} }
+5 -1
View File
@@ -162,12 +162,16 @@ class FamilyPage {
* The first required question left unanswered, as the error to show — or null * The first required question left unanswered, as the error to show — or null
* when every required question has a value. * when every required question has a value.
* *
* This screen only ever adds a student the guardian registers, so the
* students' required-ness is the one that applies — the same rule the child
* blocks on the signup form are held to.
*
* @param list<Question> $questions * @param list<Question> $questions
* @param array<int, string> $answers question_id => submitted value * @param array<int, string> $answers question_id => submitted value
*/ */
private function firstMissingAnswer( array $questions, array $answers ): ?\WP_Error { private function firstMissingAnswer( array $questions, array $answers ): ?\WP_Error {
foreach ( $questions as $question ) { foreach ( $questions as $question ) {
if ( $question->isRequired && '' === trim( (string) ( $answers[ (int) $question->id ] ?? '' ) ) ) { if ( $question->isRequiredForChild() && '' === trim( (string) ( $answers[ (int) $question->id ] ?? '' ) ) ) {
return new \WP_Error( 'missing_answer', __( 'Please answer all required questions for this student.', 'unsupervised-schedular' ) ); return new \WP_Error( 'missing_answer', __( 'Please answer all required questions for this student.', 'unsupervised-schedular' ) );
} }
} }
+9
View File
@@ -72,6 +72,15 @@ class Plugin {
update_option( 'us_questions_offering_nullable', '1' ); update_option( 'us_questions_offering_nullable', '1' );
} }
// One-time backfill of us_questions.is_required_child, which dbDelta adds
// defaulting to 0 — leaving every question that *was* required no longer
// required of the students a guardian registers. Runs after the version
// gate above, so the column it writes to exists. Guarded so a question
// later made optional for students stays that way.
if ( '1' !== get_option( 'us_questions_child_required_backfilled', '' ) && $questions->backfillChildRequired() ) {
update_option( 'us_questions_child_required_backfilled', '1' );
}
$answers = new AnswerRepository( $wpdb ); $answers = new AnswerRepository( $wpdb );
$policies = new PolicyRepository( $wpdb ); $policies = new PolicyRepository( $wpdb );
$policyVersions = new PolicyVersionRepository( $wpdb ); $policyVersions = new PolicyVersionRepository( $wpdb );
+86 -18
View File
@@ -21,6 +21,16 @@ class Question {
/** Question is studio-wide, asked once at account signup (no offering). */ /** Question is studio-wide, asked once at account signup (no offering). */
public const SCOPE_ACCOUNT = 'account'; public const SCOPE_ACCOUNT = 'account';
/** Asked of everyone: the account holder as a student, and each student they register. */
public const AUDIENCE_ALL = 'all';
/**
* Asked only of the students someone registers on behalf of — never of the
* account holder's own "About you" panel. For the questions that only make
* sense about a child ("school and grade", "who may collect them").
*/
public const AUDIENCE_CHILD = 'child';
/** /**
* All valid field types. * All valid field types.
* *
@@ -43,9 +53,29 @@ class Question {
self::SCOPE_ACCOUNT, self::SCOPE_ACCOUNT,
]; ];
/**
* All valid audiences.
*
* @var list<string>
*/
public const VALID_AUDIENCES = [
self::AUDIENCE_ALL,
self::AUDIENCE_CHILD,
];
/** /**
* Build an intake question value object. * Build an intake question value object.
* *
* `$isRequired` and `$isRequiredChild` are deliberately separate: a studio may
* want an answer from every student it enrols without demanding the same of an
* adult signing themselves up. Read them through {@see isRequiredForSelf()} and
* {@see isRequiredForChild()} rather than directly, so the audience is applied
* with them.
*
* Both `$audience` and `$isRequiredChild` are meaningless for offering scope,
* where a booking asks its questions once about the student being booked and
* there is no separate account-holder form to differ from.
*
* @param int|null $offeringId The owning offering, or null for account-scoped questions. * @param int|null $offeringId The owning offering, or null for account-scoped questions.
* @param list<string>|null $options Choices for a `select` field. * @param list<string>|null $options Choices for a `select` field.
*/ */
@@ -58,9 +88,36 @@ class Question {
public readonly int $sortOrder = 0, public readonly int $sortOrder = 0,
public readonly bool $isActive = true, public readonly bool $isActive = true,
public readonly string $scope = self::SCOPE_OFFERING, public readonly string $scope = self::SCOPE_OFFERING,
public readonly string $audience = self::AUDIENCE_ALL,
public readonly bool $isRequiredChild = false,
public readonly ?int $id = null, public readonly ?int $id = null,
) {} ) {}
/**
* Whether the account holder is asked this question in their own right — true
* for everything except a child-audience question.
*/
public function askedOfSelf(): bool {
return self::AUDIENCE_CHILD !== $this->audience;
}
/**
* Whether the account holder must answer before the form will submit. A
* child-audience question never reaches them, so it can never block them.
*/
public function isRequiredForSelf(): bool {
return $this->isRequired && $this->askedOfSelf();
}
/**
* Whether each student being registered must answer before the form will
* submit. Every question is asked in the student blocks whatever its audience,
* so this stands on its own.
*/
public function isRequiredForChild(): bool {
return $this->isRequiredChild;
}
public static function fromRow( \stdClass $row ): self { public static function fromRow( \stdClass $row ): self {
$options = null; $options = null;
if ( null !== $row->options && '' !== $row->options ) { if ( null !== $row->options && '' !== $row->options ) {
@@ -70,16 +127,25 @@ class Question {
: null; : null;
} }
// `audience` and `is_required_child` arrived after the table did, so a row
// read on a site whose dbDelta has not run yet simply lacks them: the
// pre-existing behaviour (asked of everyone, required of nobody in
// particular) is the right reading of a question authored before the
// distinction existed.
$audience = Val::string( $row->audience ?? '' );
return new self( return new self(
offeringId: Val::intOrNull( $row->offering_id ), offeringId: Val::intOrNull( $row->offering_id ),
label: Val::string( $row->label ), label: Val::string( $row->label ),
fieldType: Val::string( $row->field_type ), fieldType: Val::string( $row->field_type ),
options: $options, options: $options,
isRequired: Val::bool( $row->is_required ), isRequired: Val::bool( $row->is_required ),
sortOrder: Val::int( $row->sort_order ), sortOrder: Val::int( $row->sort_order ),
isActive: Val::bool( $row->is_active ), isActive: Val::bool( $row->is_active ),
scope: Val::string( $row->scope ), scope: Val::string( $row->scope ),
id: Val::int( $row->id ), audience: in_array( $audience, self::VALID_AUDIENCES, true ) ? $audience : self::AUDIENCE_ALL,
isRequiredChild: Val::bool( $row->is_required_child ?? false ),
id: Val::int( $row->id ),
); );
} }
@@ -90,15 +156,17 @@ class Question {
*/ */
public function toArray(): array { public function toArray(): array {
return [ return [
'id' => $this->id, 'id' => $this->id,
'offering_id' => $this->offeringId, 'offering_id' => $this->offeringId,
'scope' => $this->scope, 'scope' => $this->scope,
'label' => $this->label, 'label' => $this->label,
'field_type' => $this->fieldType, 'field_type' => $this->fieldType,
'options' => $this->options, 'options' => $this->options,
'is_required' => $this->isRequired, 'audience' => $this->audience,
'sort_order' => $this->sortOrder, 'is_required' => $this->isRequired,
'is_active' => $this->isActive, 'is_required_child' => $this->isRequiredChild,
'sort_order' => $this->sortOrder,
'is_active' => $this->isActive,
]; ];
} }
} }
+17 -7
View File
@@ -89,15 +89,25 @@ class QuestionController {
return; return;
} }
// Audience and the students' own required-ness are asked for on the
// account-scope form only; an offering's questions are answered once about
// the student being booked, so there is no second audience to differ from.
// An offering question therefore mirrors its single "required" into both
// columns rather than storing a distinction it does not have.
$accountScope = null === $offering;
$audience = sanitize_key( Val::string( wp_unslash( $_POST['audience'] ?? '' ) ) );
$this->questions->insert( $this->questions->insert(
new Question( new Question(
offeringId: null === $offering ? null : (int) $offering->id, offeringId: $accountScope ? null : (int) $offering->id,
label: $label, label: $label,
fieldType: $fieldType, fieldType: $fieldType,
options: $this->parseOptions( sanitize_textarea_field( Val::string( wp_unslash( $_POST['options'] ?? '' ) ) ) ), options: $this->parseOptions( sanitize_textarea_field( Val::string( wp_unslash( $_POST['options'] ?? '' ) ) ) ),
isRequired: isset( $_POST['is_required'] ), isRequired: isset( $_POST['is_required'] ),
sortOrder: absint( Val::int( $_POST['sort_order'] ?? 0 ) ), sortOrder: absint( Val::int( $_POST['sort_order'] ?? 0 ) ),
scope: null === $offering ? Question::SCOPE_ACCOUNT : Question::SCOPE_OFFERING, scope: $accountScope ? Question::SCOPE_ACCOUNT : Question::SCOPE_OFFERING,
audience: $accountScope && in_array( $audience, Question::VALID_AUDIENCES, true ) ? $audience : Question::AUDIENCE_ALL,
isRequiredChild: $accountScope ? isset( $_POST['is_required_child'] ) : isset( $_POST['is_required'] ),
) )
); );
// phpcs:enable WordPress.Security.NonceVerification.Missing // phpcs:enable WordPress.Security.NonceVerification.Missing
+30 -16
View File
@@ -88,14 +88,21 @@ class QuestionEndpoint {
return $this->invalid( __( 'Invalid field type.', 'unsupervised-schedular' ) ); return $this->invalid( __( 'Invalid field type.', 'unsupervised-schedular' ) );
} }
$isRequired = (bool) $request->get_param( 'is_required' );
$question = new Question( $question = new Question(
offeringId: $offeringId, offeringId: $offeringId,
label: $label, label: $label,
fieldType: $fieldType, fieldType: $fieldType,
options: $this->sanitizeOptions( $request->get_param( 'options' ) ), options: $this->sanitizeOptions( $request->get_param( 'options' ) ),
isRequired: (bool) $request->get_param( 'is_required' ), isRequired: $isRequired,
sortOrder: Val::int( $request->get_param( 'sort_order' ) ), sortOrder: Val::int( $request->get_param( 'sort_order' ) ),
isActive: null === $request->get_param( 'is_active' ) ? true : (bool) $request->get_param( 'is_active' ), isActive: null === $request->get_param( 'is_active' ) ? true : (bool) $request->get_param( 'is_active' ),
// An offering asks its questions once, about the student being booked,
// so there is no second audience to differ from: the single "required"
// stands for both, the same way the upgrade backfill left every
// question authored before the two could differ.
isRequiredChild: $isRequired,
); );
$id = $this->questions->insert( $question ); $id = $this->questions->insert( $question );
@@ -129,16 +136,23 @@ class QuestionEndpoint {
return $this->invalid( $this->tooLongMessage( __( 'question', 'unsupervised-schedular' ), Question::MAX_LABEL_LENGTH ) ); return $this->invalid( $this->tooLongMessage( __( 'question', 'unsupervised-schedular' ), Question::MAX_LABEL_LENGTH ) );
} }
// Only offering-scope questions reach here — an account-scope one has no
// offering to own it and is turned away as not found above — so the same
// single "required" applies to everyone asked. See create().
$isRequired = $request->has_param( 'is_required' ) ? (bool) $request->get_param( 'is_required' ) : $existing->isRequired;
$question = new Question( $question = new Question(
offeringId: $existing->offeringId, offeringId: $existing->offeringId,
label: $label, label: $label,
fieldType: $fieldType, fieldType: $fieldType,
options: $request->has_param( 'options' ) ? $this->sanitizeOptions( $request->get_param( 'options' ) ) : $existing->options, options: $request->has_param( 'options' ) ? $this->sanitizeOptions( $request->get_param( 'options' ) ) : $existing->options,
isRequired: $request->has_param( 'is_required' ) ? (bool) $request->get_param( 'is_required' ) : $existing->isRequired, isRequired: $isRequired,
sortOrder: $request->has_param( 'sort_order' ) ? Val::int( $request->get_param( 'sort_order' ) ) : $existing->sortOrder, sortOrder: $request->has_param( 'sort_order' ) ? Val::int( $request->get_param( 'sort_order' ) ) : $existing->sortOrder,
isActive: $request->has_param( 'is_active' ) ? (bool) $request->get_param( 'is_active' ) : $existing->isActive, isActive: $request->has_param( 'is_active' ) ? (bool) $request->get_param( 'is_active' ) : $existing->isActive,
scope: $existing->scope, scope: $existing->scope,
id: $id, audience: $existing->audience,
isRequiredChild: $isRequired,
id: $id,
); );
$this->questions->update( $id, $question ); $this->questions->update( $id, $question );
+9 -3
View File
@@ -21,12 +21,18 @@ class QuestionField {
* the HTML attribute, for a block the browser must not block submission on * the HTML attribute, for a block the browser must not block submission on
* because it may not apply at all — the child blocks, which only count when * because it may not apply at all — the child blocks, which only count when
* the parent/guardian box is ticked. The server validates those either way. * the parent/guardian box is ticked. The server validates those either way.
*
* `$isRequired` overrides which of the question's two required flags applies
* here — a question can be optional for the account holder and required for
* each student they register, and only the caller knows which block this is.
* Null falls back to the question's own {@see Question::$isRequired}.
*/ */
public static function render( Question $question, string $name, string $id, bool $enforceRequired = true ): string { public static function render( Question $question, string $name, string $id, bool $enforceRequired = true, ?bool $isRequired = null ): string {
$required = $question->isRequired && $enforceRequired ? ' required' : ''; $mustAnswer = $isRequired ?? $question->isRequired;
$required = $mustAnswer && $enforceRequired ? ' required' : '';
$label = '<label for="' . esc_attr( $id ) . '">' . esc_html( $question->label ) $label = '<label for="' . esc_attr( $id ) . '">' . esc_html( $question->label )
. ( $question->isRequired ? ' <span class="us-required" aria-hidden="true">*</span>' : '' ) . ( $mustAnswer ? ' <span class="us-required" aria-hidden="true">*</span>' : '' )
. '</label>'; . '</label>';
return '<p>' . $label . self::input( $question, $name, $id, $required ) . '</p>'; return '<p>' . $label . self::input( $question, $name, $id, $required ) . '</p>';
+38 -10
View File
@@ -15,7 +15,7 @@ class QuestionRepository {
$this->db->insert( $this->db->insert(
$this->table, $this->table,
$this->columns( $question ) + [ 'created_at' => current_time( 'mysql' ) ], $this->columns( $question ) + [ 'created_at' => current_time( 'mysql' ) ],
[ '%d', '%s', '%s', '%s', '%s', '%d', '%d', '%d', '%s' ] [ '%d', '%s', '%s', '%s', '%s', '%s', '%d', '%d', '%d', '%d', '%s' ]
); );
return $this->db->insert_id; return $this->db->insert_id;
@@ -26,7 +26,7 @@ class QuestionRepository {
$this->table, $this->table,
$this->columns( $question ), $this->columns( $question ),
[ 'id' => $id ], [ 'id' => $id ],
[ '%d', '%s', '%s', '%s', '%s', '%d', '%d', '%d' ], [ '%d', '%s', '%s', '%s', '%s', '%s', '%d', '%d', '%d', '%d' ],
[ '%d' ] [ '%d' ]
); );
} }
@@ -38,14 +38,16 @@ class QuestionRepository {
*/ */
private function columns( Question $question ): array { private function columns( Question $question ): array {
return [ return [
'offering_id' => $question->offeringId, 'offering_id' => $question->offeringId,
'scope' => $question->scope, 'scope' => $question->scope,
'label' => $question->label, 'label' => $question->label,
'field_type' => $question->fieldType, 'field_type' => $question->fieldType,
'options' => null === $question->options ? null : (string) wp_json_encode( $question->options ), 'options' => null === $question->options ? null : (string) wp_json_encode( $question->options ),
'is_required' => $question->isRequired ? 1 : 0, 'audience' => $question->audience,
'sort_order' => $question->sortOrder, 'is_required' => $question->isRequired ? 1 : 0,
'is_active' => $question->isActive ? 1 : 0, 'is_required_child' => $question->isRequiredChild ? 1 : 0,
'sort_order' => $question->sortOrder,
'is_active' => $question->isActive ? 1 : 0,
]; ];
} }
@@ -128,4 +130,30 @@ class QuestionRepository {
return null !== $sql && false !== $this->db->query( $sql ); return null !== $sql && false !== $this->db->query( $sql );
} }
/**
* Give every question authored before students had a required-ness of their
* own the one it used to have.
*
* `is_required_child` arrives with `DEFAULT 0`, so without this a question the
* studio had marked required would quietly stop being required of the students
* a guardian registers — the case it most likely existed for. Copying
* `is_required` across preserves exactly the old behaviour: required of
* everyone, or of nobody.
*
* Run once, guarded by an option in {@see \Unsupervised\Schedular\Plugin::boot()},
* so a question deliberately made optional for students afterwards is not
* quietly made required again.
*
* @return bool True when the statement ran, false if it could not be prepared
* or the query failed.
*/
public function backfillChildRequired(): bool {
$sql = $this->db->prepare(
'UPDATE %i SET is_required_child = 1 WHERE is_required = 1',
$this->table
);
return null !== $sql && false !== $this->db->query( $sql );
}
} }
+2
View File
@@ -85,7 +85,9 @@ class Schema {
label VARCHAR(255) NOT NULL, label VARCHAR(255) NOT NULL,
field_type VARCHAR(20) NOT NULL DEFAULT 'text', field_type VARCHAR(20) NOT NULL DEFAULT 'text',
options TEXT, options TEXT,
audience VARCHAR(20) NOT NULL DEFAULT 'all',
is_required TINYINT(1) NOT NULL DEFAULT 0, is_required TINYINT(1) NOT NULL DEFAULT 0,
is_required_child TINYINT(1) NOT NULL DEFAULT 0,
sort_order INT NOT NULL DEFAULT 0, sort_order INT NOT NULL DEFAULT 0,
is_active TINYINT(1) NOT NULL DEFAULT 1, is_active TINYINT(1) NOT NULL DEFAULT 1,
created_at DATETIME NOT NULL, created_at DATETIME NOT NULL,
+58 -7
View File
@@ -41,7 +41,7 @@ if (! defined('ABSPATH')) {
<?php else : ?> <?php else : ?>
<?php if ($accountScope) : ?> <?php if ($accountScope) : ?>
<h2><?php esc_html_e('Account signup questions', 'unsupervised-schedular'); ?></h2> <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 when they register — the account holder on the signup form itself, and once per student they are registering on behalf of.', 'unsupervised-schedular'); ?></p> <p><?php esc_html_e('Every new student answers these questions when they register — the account holder on the signup form itself, and once per student they are registering on behalf of. Each question says who it is asked of, and can be required of the account holder, of the students, or of both.', 'unsupervised-schedular'); ?></p>
<?php else : ?> <?php else : ?>
<h2><?php echo esc_html(sprintf(/* translators: %s: offering title */ __('Questions for "%s"', 'unsupervised-schedular'), $selectedOffering->title)); ?></h2> <h2><?php echo esc_html(sprintf(/* translators: %s: offering title */ __('Questions for "%s"', 'unsupervised-schedular'), $selectedOffering->title)); ?></h2>
<?php endif; ?> <?php endif; ?>
@@ -76,10 +76,31 @@ if (! defined('ABSPATH')) {
<th><label for="sort_order"><?php esc_html_e('Sort order', 'unsupervised-schedular'); ?></label></th> <th><label for="sort_order"><?php esc_html_e('Sort order', 'unsupervised-schedular'); ?></label></th>
<td><input type="number" name="sort_order" id="sort_order" min="0" step="1" value="0"></td> <td><input type="number" name="sort_order" id="sort_order" min="0" step="1" value="0"></td>
</tr> </tr>
<tr> <?php if ($accountScope) : ?>
<th><?php esc_html_e('Required', 'unsupervised-schedular'); ?></th> <tr>
<td><label><input type="checkbox" name="is_required" value="1"> <?php esc_html_e('Registrant must answer', 'unsupervised-schedular'); ?></label></td> <th><label for="audience"><?php esc_html_e('Asked of', 'unsupervised-schedular'); ?></label></th>
</tr> <td>
<select name="audience" id="audience">
<option value="<?php echo esc_attr(Question::AUDIENCE_ALL); ?>"><?php esc_html_e('Everyone registering', 'unsupervised-schedular'); ?></option>
<option value="<?php echo esc_attr(Question::AUDIENCE_CHILD); ?>"><?php esc_html_e('Students only — not the account holder', 'unsupervised-schedular'); ?></option>
</select>
<p class="description"><?php esc_html_e('"Students only" leaves the question off the account holder\'s own section, for anything that only makes sense about a student someone is registering on behalf of.', 'unsupervised-schedular'); ?></p>
</td>
</tr>
<tr>
<th><?php esc_html_e('Required', 'unsupervised-schedular'); ?></th>
<td>
<label><input type="checkbox" name="is_required" value="1"> <?php esc_html_e('The account holder must answer for themselves', 'unsupervised-schedular'); ?></label><br>
<label><input type="checkbox" name="is_required_child" value="1"> <?php esc_html_e('Each student they register must answer', 'unsupervised-schedular'); ?></label>
<p class="description"><?php esc_html_e('Tick either, both, or neither — a question can be optional for an adult signing themselves up and still required for every student they enrol.', 'unsupervised-schedular'); ?></p>
</td>
</tr>
<?php else : ?>
<tr>
<th><?php esc_html_e('Required', 'unsupervised-schedular'); ?></th>
<td><label><input type="checkbox" name="is_required" value="1"> <?php esc_html_e('Registrant must answer', 'unsupervised-schedular'); ?></label></td>
</tr>
<?php endif; ?>
</table> </table>
<?php submit_button(esc_html__('Add Question', 'unsupervised-schedular')); ?> <?php submit_button(esc_html__('Add Question', 'unsupervised-schedular')); ?>
</form> </form>
@@ -94,7 +115,12 @@ if (! defined('ABSPATH')) {
<th><?php esc_html_e('Order', 'unsupervised-schedular'); ?></th> <th><?php esc_html_e('Order', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Question', 'unsupervised-schedular'); ?></th> <th><?php esc_html_e('Question', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Type', 'unsupervised-schedular'); ?></th> <th><?php esc_html_e('Type', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Required', 'unsupervised-schedular'); ?></th> <?php if ($accountScope) : ?>
<th><?php esc_html_e('Asked of', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Required of', 'unsupervised-schedular'); ?></th>
<?php else : ?>
<th><?php esc_html_e('Required', 'unsupervised-schedular'); ?></th>
<?php endif; ?>
<th><?php esc_html_e('Actions', 'unsupervised-schedular'); ?></th> <th><?php esc_html_e('Actions', 'unsupervised-schedular'); ?></th>
</tr> </tr>
</thead> </thead>
@@ -104,7 +130,32 @@ if (! defined('ABSPATH')) {
<td><?php echo esc_html((string) $question->sortOrder); ?></td> <td><?php echo esc_html((string) $question->sortOrder); ?></td>
<td><?php echo esc_html($question->label); ?></td> <td><?php echo esc_html($question->label); ?></td>
<td><?php echo esc_html($question->fieldType); ?></td> <td><?php echo esc_html($question->fieldType); ?></td>
<td><?php echo $question->isRequired ? esc_html__('Yes', 'unsupervised-schedular') : esc_html__('No', 'unsupervised-schedular'); ?></td> <?php if ($accountScope) : ?>
<td>
<?php
echo $question->askedOfSelf()
? esc_html__('Everyone', 'unsupervised-schedular')
: esc_html__('Students only', 'unsupervised-schedular');
?>
</td>
<td>
<?php
// Named rather than two ticks, so "required of the
// students but not of you" reads as the deliberate
// setting it is rather than as a half-filled row.
$requiredOf = [];
if ($question->isRequiredForSelf()) {
$requiredOf[] = __('account holder', 'unsupervised-schedular');
}
if ($question->isRequiredForChild()) {
$requiredOf[] = __('students', 'unsupervised-schedular');
}
echo esc_html([] === $requiredOf ? __('—', 'unsupervised-schedular') : implode(', ', $requiredOf));
?>
</td>
<?php else : ?>
<td><?php echo $question->isRequired ? esc_html__('Yes', 'unsupervised-schedular') : esc_html__('No', 'unsupervised-schedular'); ?></td>
<?php endif; ?>
<td> <td>
<form method="post" style="display:inline;"> <form method="post" style="display:inline;">
<?php wp_nonce_field('usc_question_action'); ?> <?php wp_nonce_field('usc_question_action'); ?>
+6 -1
View File
@@ -94,7 +94,12 @@ if (! defined('ABSPATH')) {
<?php foreach ($questions as $question) : ?> <?php foreach ($questions as $question) : ?>
<?php <?php
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- QuestionField::render() escapes every interpolated value. // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- QuestionField::render() escapes every interpolated value.
echo QuestionField::render($question, 'us_answers[' . (int) $question->id . ']', 'us-family-q-' . (int) $question->id); echo QuestionField::render(
$question,
'us_answers[' . (int) $question->id . ']',
'us-family-q-' . (int) $question->id,
isRequired: $question->isRequiredForChild()
);
?> ?>
<?php endforeach; ?> <?php endforeach; ?>
</fieldset> </fieldset>
+16 -3
View File
@@ -22,7 +22,7 @@ if (! defined('ABSPATH')) {
* @var string $loginUrl Where the post-confirmation sign-in link points. * @var string $loginUrl Where the post-confirmation sign-in link points.
* @var string $error * @var string $error
* @var list<array{policy: \Unsupervised\Schedular\Policy\Policy, version: \Unsupervised\Schedular\Policy\PolicyVersion}> $policyForms * @var list<array{policy: \Unsupervised\Schedular\Policy\Policy, version: \Unsupervised\Schedular\Policy\PolicyVersion}> $policyForms
* @var list<Question> $accountQuestions Studio-wide questions, asked of every student — the account holder included when they are one. * @var list<Question> $accountQuestions Studio-wide questions, asked of every student being registered — the account holder included when they are one, unless the question is for students only.
*/ */
?> ?>
@@ -121,9 +121,21 @@ if (! defined('ABSPATH')) {
<input type="number" name="birth_year" id="us-reg-birth-year" aria-required="true" required min="1900" max="<?php echo esc_attr(current_time('Y')); ?>" step="1" inputmode="numeric" autocomplete="bday-year" placeholder="<?php esc_attr_e('YYYY', 'unsupervised-schedular'); ?>"> <input type="number" name="birth_year" id="us-reg-birth-year" aria-required="true" required min="1900" max="<?php echo esc_attr(current_time('Y')); ?>" step="1" inputmode="numeric" autocomplete="bday-year" placeholder="<?php esc_attr_e('YYYY', 'unsupervised-schedular'); ?>">
</p> </p>
<?php foreach ($accountQuestions as $question) : ?> <?php foreach ($accountQuestions as $question) : ?>
<?php
// A "students only" question describes a child being registered,
// so it is never put to the account holder about themselves.
if (! $question->askedOfSelf()) {
continue;
}
?>
<?php <?php
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- QuestionField::render() escapes every interpolated value. // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- QuestionField::render() escapes every interpolated value.
echo QuestionField::render($question, 'us_answers[' . (int) $question->id . ']', 'us-reg-q-' . (int) $question->id); echo QuestionField::render(
$question,
'us_answers[' . (int) $question->id . ']',
'us-reg-q-' . (int) $question->id,
isRequired: $question->isRequiredForSelf()
);
?> ?>
<?php endforeach; ?> <?php endforeach; ?>
</fieldset> </fieldset>
@@ -150,7 +162,8 @@ if (! defined('ABSPATH')) {
$question, $question,
'children[0][answers][' . (int) $question->id . ']', 'children[0][answers][' . (int) $question->id . ']',
'us-child-0-q-' . (int) $question->id, 'us-child-0-q-' . (int) $question->id,
enforceRequired: false enforceRequired: false,
isRequired: $question->isRequiredForChild()
); );
?> ?>
<?php endforeach; ?> <?php endforeach; ?>
+154 -1
View File
@@ -1017,7 +1017,7 @@ class RegistrationPageTest extends TestCase
]; ];
$this->ctx['questions']->shouldReceive('findByScope')->andReturn([ $this->ctx['questions']->shouldReceive('findByScope')->andReturn([
new Question(offeringId: null, label: 'Instrument', isRequired: true, scope: Question::SCOPE_ACCOUNT, id: 7), new Question(offeringId: null, label: 'Instrument', isRequired: true, scope: Question::SCOPE_ACCOUNT, isRequiredChild: true, id: 7),
]); ]);
Functions\when('email_exists')->justReturn(false); Functions\when('email_exists')->justReturn(false);
@@ -1247,4 +1247,157 @@ class RegistrationPageTest extends TestCase
'The account holder answers the questions above the students they are adding.' 'The account holder answers the questions above the students they are adding.'
); );
} }
/**
* A "students only" question describes a child being registered, so it is put
* to each student and never to the account holder about themselves.
*/
public function testAStudentsOnlyQuestionIsAskedOfTheStudentsAndNotOfTheAccountHolder(): void
{
$this->stubRenderContext();
$question = new Question(
null,
'School and grade',
scope: Question::SCOPE_ACCOUNT,
audience: Question::AUDIENCE_CHILD,
isRequiredChild: true,
id: 7
);
$this->ctx['questions']->shouldReceive('findByScope')->with(Question::SCOPE_ACCOUNT, Mockery::any())->andReturn([$question]);
$html = $this->ctx['page']->render([]);
self::assertStringNotContainsString('name="us_answers[7]"', $html);
self::assertStringContainsString('name="children[0][answers][7]"', $html);
}
/**
* The two required flags are read where each applies: the browser is asked to
* enforce the account holder's, and the students' block carries the marker
* without the attribute (it may not be in play at all).
*/
public function testTheFormMarksAQuestionRequiredWhereItActuallyIs(): void
{
$this->stubRenderContext();
$question = new Question(
null,
'Previous experience',
scope: Question::SCOPE_ACCOUNT,
isRequired: false,
isRequiredChild: true,
id: 7
);
$this->ctx['questions']->shouldReceive('findByScope')->with(Question::SCOPE_ACCOUNT, Mockery::any())->andReturn([$question]);
$html = $this->ctx['page']->render([]);
// No `required` attribute on the account holder's copy, and no marker on
// its label — they may leave it blank.
self::assertStringContainsString('<input type="text" name="us_answers[7]" id="us-reg-q-7">', $html);
self::assertStringContainsString('<label for="us-reg-q-7">Previous experience</label>', $html);
// The student's copy is marked required, without the attribute: the block
// may not be in play at all, so the server is what enforces it.
self::assertStringContainsString('<label for="us-child-0-q-7">Previous experience <span class="us-required" aria-hidden="true">*</span></label>', $html);
self::assertStringContainsString('<input type="text" name="children[0][answers][7]" id="us-child-0-q-7">', $html);
}
/**
* The point of the two flags: an adult signing themselves up can leave the
* question blank, while every student they enrol must answer it.
*/
public function testAQuestionOptionalForYouIsStillRequiredOfEachStudent(): void
{
$_POST = [
'password' => 'thistle-marrow-42',
'display_name' => 'Grace',
'birth_year' => '1990',
'us_registering_for' => RegistrationPage::FOR_BOTH,
'us_answers' => ['7' => ' '],
'children' => [['name' => 'Ada', 'birth_year' => '2015', 'answers' => [7 => ' ']]],
];
$question = new Question(null, 'Instrument', isRequired: false, scope: Question::SCOPE_ACCOUNT, isRequiredChild: true, id: 7);
$this->ctx['questions']->shouldReceive('findByScope')->andReturn([$question]);
Functions\when('email_exists')->justReturn(false);
Functions\expect('wp_insert_user')->never();
$result = $this->submit(new Invite(email: '[email protected]', token: 'hash'), false);
// The student's blank is what stopped it — the account holder's was fine.
self::assertStringContainsString('for each student', $result);
}
public function testTheAccountHolderMayLeaveBlankWhatTheirStudentsMustAnswer(): void
{
$_POST = [
'password' => 'thistle-marrow-42',
'display_name' => 'Grace',
'birth_year' => '1990',
'us_registering_for' => RegistrationPage::FOR_BOTH,
'us_answers' => ['7' => ' '],
'children' => [['name' => 'Ada', 'birth_year' => '2015', 'answers' => [7 => 'Piano']]],
];
$question = new Question(null, 'Instrument', isRequired: false, scope: Question::SCOPE_ACCOUNT, isRequiredChild: true, id: 7);
$this->ctx['questions']->shouldReceive('findByScope')->andReturn([$question]);
$this->ctx['guardians']->shouldReceive('createChild')->once()->andReturn(101);
$this->stubInviteSuccess();
$students = [];
$this->ctx['answers']->shouldReceive('insert')->andReturnUsing(
static function (Answer $answer) use (&$students): int {
$students[] = $answer->studentId;
return 1;
}
);
self::assertSame('invite', $this->submit(new Invite(email: '[email protected]', token: 'hash'), false));
// Only the student answered, so only the student has an answer stored.
self::assertSame([101], $students);
}
/**
* A question the account holder is never shown cannot be one they are held
* to, nor one an answer can be filed against them for — a crafted post that
* supplies both is ignored on both counts.
*/
public function testAStudentsOnlyQuestionNeitherBlocksNorStoresAgainstTheAccountHolder(): void
{
$_POST = [
'password' => 'thistle-marrow-42',
'display_name' => 'Grace',
'birth_year' => '1990',
'us_registering_for' => RegistrationPage::FOR_BOTH,
'us_answers' => ['7' => 'Crafted by hand'],
'children' => [['name' => 'Ada', 'birth_year' => '2015', 'answers' => [7 => 'Grade 4']]],
];
$question = new Question(
null,
'School and grade',
isRequired: true,
scope: Question::SCOPE_ACCOUNT,
audience: Question::AUDIENCE_CHILD,
isRequiredChild: true,
id: 7
);
$this->ctx['questions']->shouldReceive('findByScope')->andReturn([$question]);
$this->ctx['guardians']->shouldReceive('createChild')->once()->andReturn(101);
$this->stubInviteSuccess();
$recorded = [];
$this->ctx['answers']->shouldReceive('insert')->andReturnUsing(
static function (Answer $answer) use (&$recorded): int {
$recorded[] = [$answer->studentId, $answer->answerValue];
return 1;
}
);
self::assertSame('invite', $this->submit(new Invite(email: '[email protected]', token: 'hash'), false));
self::assertSame([[101, 'Grade 4']], $recorded);
}
} }
+78 -1
View File
@@ -76,9 +76,21 @@ class FamilyPageTest extends TestCase
return $page; return $page;
} }
/**
* A question required of everyone, or of nobody — the shape every question
* had before the account holder and the students could differ, and the shape
* the upgrade backfill leaves them in.
*/
private function question(int $id, bool $required): Question private function question(int $id, bool $required): Question
{ {
return new Question(offeringId: null, label: 'Instrument', isRequired: $required, scope: Question::SCOPE_ACCOUNT, id: $id); return new Question(
offeringId: null,
label: 'Instrument',
isRequired: $required,
scope: Question::SCOPE_ACCOUNT,
isRequiredChild: $required,
id: $id
);
} }
public function testLoggedOutVisitorIsOfferedALoginLink(): void public function testLoggedOutVisitorIsOfferedALoginLink(): void
@@ -158,6 +170,71 @@ class FamilyPageTest extends TestCase
self::assertNull($captured); self::assertNull($captured);
} }
/**
* This screen only ever adds a student, so the students' required-ness is the
* one that applies: a question required of the account holder alone must not
* stop a guardian adding a child.
*/
public function testAddIsNotBlockedByAQuestionRequiredOnlyOfTheAccountHolder(): void
{
$_POST = [
'us_family_action' => 'add',
'child_name' => 'Ada',
'child_birth_year' => '2015',
'us_answers' => [7 => ' '],
];
$question = new Question(
offeringId: null,
label: 'Instrument',
isRequired: true,
scope: Question::SCOPE_ACCOUNT,
isRequiredChild: false,
id: 7
);
$this->questions->shouldReceive('findByScope')->once()->andReturn([$question]);
$this->guardians->shouldReceive('createChild')->once()->andReturn(42);
// Nothing was typed, so nothing is stored — but the add went through.
$this->answers->shouldNotReceive('insert');
$captured = null;
$this->capturingPage($captured)->maybeHandleSubmit();
self::assertSame('https://studio.test/family/?us_family=added', $captured);
}
public function testAddIsBlockedByAQuestionRequiredOnlyOfTheStudents(): void
{
$_POST = [
'us_family_action' => 'add',
'child_name' => 'Ada',
'child_birth_year' => '2015',
'us_answers' => [7 => ''],
];
$question = new Question(
offeringId: null,
label: 'Instrument',
isRequired: false,
scope: Question::SCOPE_ACCOUNT,
isRequiredChild: true,
id: 7
);
$this->questions->shouldReceive('findByScope')->once()->andReturn([$question]);
$this->guardians->shouldNotReceive('createChild');
$captured = null;
$page = $this->capturingPage($captured);
$page->shouldNotReceive('redirect');
$page->maybeHandleSubmit();
self::assertNull($captured);
}
public function testAddSurfacesAServiceErrorInsteadOfRedirecting(): void public function testAddSurfacesAServiceErrorInsteadOfRedirecting(): void
{ {
$_POST = ['us_family_action' => 'add', 'child_name' => '']; $_POST = ['us_family_action' => 'add', 'child_name' => ''];
@@ -0,0 +1,85 @@
<?php
declare(strict_types=1);
namespace Unsupervised\Schedular\Tests\Unit\Registration;
use Unsupervised\Schedular\Registration\Question;
use Unsupervised\Schedular\Registration\QuestionField;
use Unsupervised\Schedular\Tests\Unit\TestCase;
class QuestionFieldTest extends TestCase
{
public function testRendersATextInputNamedAndLabelledAsAsked(): void
{
$html = QuestionField::render(new Question(7, 'Your level?', id: 3), 'us_answers[3]', 'us-q-3');
self::assertStringContainsString('<label for="us-q-3">Your level?</label>', $html);
self::assertStringContainsString('<input type="text" name="us_answers[3]" id="us-q-3">', $html);
}
public function testARequiredQuestionIsMarkedAndEnforced(): void
{
$question = new Question(7, 'Your level?', isRequired: true, id: 3);
$html = QuestionField::render($question, 'us_answers[3]', 'us-q-3');
self::assertStringContainsString('us-required', $html);
self::assertStringContainsString(' required', $html);
}
/**
* A block that may not apply at all keeps the marker and drops the attribute,
* so the browser cannot refuse a submit over a field that is out of play.
*/
public function testNotEnforcingRequiredKeepsTheMarkerButDropsTheAttribute(): void
{
$question = new Question(7, 'Your level?', isRequired: true, id: 3);
$html = QuestionField::render($question, 'us_answers[3]', 'us-q-3', enforceRequired: false);
self::assertStringContainsString('us-required', $html);
self::assertStringNotContainsString(' required>', $html);
}
/**
* Which of the question's two required flags applies depends on whose block
* this is, and only the caller knows that.
*/
public function testTheCallerCanOverrideWhichRequiredFlagApplies(): void
{
$question = new Question(
null,
'Previous experience',
scope: Question::SCOPE_ACCOUNT,
isRequired: false,
isRequiredChild: true,
id: 3
);
$forSelf = QuestionField::render($question, 'us_answers[3]', 'us-q-3', isRequired: $question->isRequiredForSelf());
$forChild = QuestionField::render($question, 'children[0][answers][3]', 'us-child-0-q-3', isRequired: $question->isRequiredForChild());
self::assertStringNotContainsString('us-required', $forSelf);
self::assertStringNotContainsString(' required', $forSelf);
self::assertStringContainsString('us-required', $forChild);
self::assertStringContainsString(' required', $forChild);
}
public function testASelectRendersItsOptionsBehindAnEmptyChoice(): void
{
$question = new Question(
7,
'Pick a level',
fieldType: Question::FIELD_SELECT,
options: ['Beginner', 'Advanced'],
id: 3
);
$html = QuestionField::render($question, 'us_answers[3]', 'us-q-3');
self::assertStringContainsString('<select name="us_answers[3]" id="us-q-3">', $html);
self::assertStringContainsString('<option value="Beginner">Beginner</option>', $html);
self::assertStringContainsString('<option value="Advanced">Advanced</option>', $html);
}
}
@@ -156,6 +156,59 @@ class QuestionRepositoryTest extends TestCase
self::assertSame(30, $this->repo->insert($question)); self::assertSame(30, $this->repo->insert($question));
} }
public function testInsertStoresAudienceAndTheStudentsRequiredFlag(): void
{
Functions\expect('current_time')->andReturn('2026-04-01 12:00:00');
$this->db->shouldReceive('insert')
->once()
->with(
'wp_us_questions',
Mockery::on(static function (array $data): bool {
return $data['audience'] === Question::AUDIENCE_CHILD
&& $data['is_required'] === 0
&& $data['is_required_child'] === 1;
}),
// One placeholder per column, in the same order.
Mockery::on(static fn (array $format): bool => count($format) === 11)
);
$this->db->insert_id = 31;
$question = new Question(
null,
'School and grade',
scope: Question::SCOPE_ACCOUNT,
audience: Question::AUDIENCE_CHILD,
isRequiredChild: true
);
self::assertSame(31, $this->repo->insert($question));
}
public function testBackfillChildRequiredCopiesTheOldRequiredFlagAcross(): void
{
$this->db->shouldReceive('prepare')
->once()
->with(Mockery::pattern('/UPDATE %i SET is_required_child = 1 WHERE is_required = 1/'), 'wp_us_questions')
->andReturn('UPDATE `wp_us_questions` SET is_required_child = 1 WHERE is_required = 1');
$this->db->shouldReceive('query')
->once()
->with('UPDATE `wp_us_questions` SET is_required_child = 1 WHERE is_required = 1')
->andReturn(2);
self::assertTrue($this->repo->backfillChildRequired());
}
public function testBackfillChildRequiredReportsFailureWhenQueryFails(): void
{
$this->db->shouldReceive('prepare')->once()->andReturn('UPDATE ...');
$this->db->shouldReceive('query')->once()->andReturn(false);
self::assertFalse($this->repo->backfillChildRequired());
}
public function testFindByScopeActiveOnlyPreparesQuery(): void public function testFindByScopeActiveOnlyPreparesQuery(): void
{ {
$this->db->shouldReceive('prepare') $this->db->shouldReceive('prepare')
+102 -1
View File
@@ -101,11 +101,112 @@ class QuestionTest extends TestCase
$question = new Question(7, 'Label', Question::FIELD_TEXT, id: 9); $question = new Question(7, 'Label', Question::FIELD_TEXT, id: 9);
$arr = $question->toArray(); $arr = $question->toArray();
foreach (['id', 'offering_id', 'scope', 'label', 'field_type', 'options', 'is_required', 'sort_order', 'is_active'] as $key) { foreach (['id', 'offering_id', 'scope', 'label', 'field_type', 'options', 'audience', 'is_required', 'is_required_child', 'sort_order', 'is_active'] as $key) {
self::assertArrayHasKey($key, $arr); self::assertArrayHasKey($key, $arr);
} }
} }
public function testDefaultsToBeingAskedOfEveryoneAndRequiredOfNobody(): void
{
$question = new Question(null, 'Instrument', scope: Question::SCOPE_ACCOUNT);
self::assertSame(Question::AUDIENCE_ALL, $question->audience);
self::assertTrue($question->askedOfSelf());
self::assertFalse($question->isRequiredForSelf());
self::assertFalse($question->isRequiredForChild());
}
public function testAChildAudienceQuestionIsNeverAskedOfTheAccountHolder(): void
{
$question = new Question(
null,
'School and grade',
scope: Question::SCOPE_ACCOUNT,
audience: Question::AUDIENCE_CHILD,
isRequired: true,
isRequiredChild: true
);
self::assertFalse($question->askedOfSelf());
// Required-ness cannot outlive the audience: a question the account
// holder is never shown must never be one they are held to.
self::assertFalse($question->isRequiredForSelf());
self::assertTrue($question->isRequiredForChild());
}
public function testAQuestionCanBeOptionalForYouAndRequiredForYourStudents(): void
{
$question = new Question(
null,
'Previous experience',
scope: Question::SCOPE_ACCOUNT,
isRequired: false,
isRequiredChild: true
);
self::assertTrue($question->askedOfSelf());
self::assertFalse($question->isRequiredForSelf());
self::assertTrue($question->isRequiredForChild());
}
public function testFromRowReadsAudienceAndTheStudentsRequiredFlag(): void
{
$row = (object) [
'id' => '6',
'offering_id' => null,
'scope' => Question::SCOPE_ACCOUNT,
'label' => 'School and grade',
'field_type' => Question::FIELD_TEXT,
'options' => null,
'audience' => Question::AUDIENCE_CHILD,
'is_required' => '0',
'is_required_child' => '1',
'sort_order' => '0',
'is_active' => '1',
];
$question = Question::fromRow($row);
self::assertSame(Question::AUDIENCE_CHILD, $question->audience);
self::assertFalse($question->askedOfSelf());
self::assertTrue($question->isRequiredForChild());
}
/**
* A row read before dbDelta has added the columns — or one carrying a value
* no longer recognised — falls back to the behaviour every question had
* before the distinction existed: asked of everyone.
*/
public function testFromRowFallsBackToEveryoneWhenAudienceIsMissingOrUnknown(): void
{
$base = [
'id' => '7',
'offering_id' => null,
'scope' => Question::SCOPE_ACCOUNT,
'label' => 'Instrument',
'field_type' => Question::FIELD_TEXT,
'options' => null,
'is_required' => '1',
'sort_order' => '0',
'is_active' => '1',
];
$missing = Question::fromRow((object) $base);
$unknown = Question::fromRow((object) ($base + ['audience' => 'grown-ups']));
self::assertSame(Question::AUDIENCE_ALL, $missing->audience);
self::assertTrue($missing->isRequiredForSelf());
self::assertFalse($missing->isRequiredForChild());
self::assertSame(Question::AUDIENCE_ALL, $unknown->audience);
}
public function testValidAudienceConstants(): void
{
self::assertContains(Question::AUDIENCE_ALL, Question::VALID_AUDIENCES);
self::assertContains(Question::AUDIENCE_CHILD, Question::VALID_AUDIENCES);
}
public function testValidFieldTypeConstants(): void public function testValidFieldTypeConstants(): void
{ {
self::assertContains(Question::FIELD_TEXT, Question::VALID_FIELD_TYPES); self::assertContains(Question::FIELD_TEXT, Question::VALID_FIELD_TYPES);
+2 -2
View File
@@ -3,7 +3,7 @@
* Plugin Name: Unsupervised Scheduler * Plugin Name: Unsupervised Scheduler
* Plugin URI: https://git.unsupervised.ca/Unsupervised/unsupervised-scheduler * Plugin URI: https://git.unsupervised.ca/Unsupervised/unsupervised-scheduler
* Description: Instructor/student lesson scheduling for WordPress. * Description: Instructor/student lesson scheduling for WordPress.
* Version: 1.4.2 * Version: 1.5.0
* Requires at least: 6.2 * Requires at least: 6.2
* Requires PHP: 8.1 * Requires PHP: 8.1
* Author: Unsupervised * Author: Unsupervised
@@ -21,7 +21,7 @@ if (! defined('ABSPATH')) {
exit; exit;
} }
define('USC_VERSION', '1.4.2'); define('USC_VERSION', '1.5.0');
define('USC_PLUGIN_FILE', __FILE__); define('USC_PLUGIN_FILE', __FILE__);
define('USC_PLUGIN_DIR', plugin_dir_path(__FILE__)); define('USC_PLUGIN_DIR', plugin_dir_path(__FILE__));
define('USC_PLUGIN_URL', plugin_dir_url(__FILE__)); define('USC_PLUGIN_URL', plugin_dir_url(__FILE__));