NeoWiki Demo - Recent changes [en]

Validation Demo

NeoWiki — Thu, 11 Jun 2026 11:31:15 GMT

Importing NeoWiki demo data

New page

A live testbed for trying out NeoWiki's backend validation and seeing how the editor surfaces server-side errors next to each field.

== Setup ==

Turn enforcement on in <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">
$wgNeoWikiEnforceValidation = true;
</syntaxhighlight>

With this flag on, writes that introduce new violations are rejected with HTTP 422 and the editor renders the violations inline. With it off, writes always go through and the violations come back in the 200 response for informational purposes only.

== Demo subjects ==

* [[Validation Clean]] — a Subject with every property filled in correctly. Use it as the starting point for the recipes below.

The [[Schema:Validation Demo|Validation Demo]] schema has four properties spanning the validation surface:

{| class="wikitable"
! Property !! Type !! Notes
|-
| Title || text, required || A simple required text field.
|-
| Homepage || url, required || A single required URL. Empty triggers a "required" error inline.
|-
| Tags || url, multi || Optional list of URLs. Changing one entry to a non-http(s) URL triggers a per-entry <code>invalid-url</code> violation under enforcement; only the offending sub-input is decorated.
|-
| Status || select, required || A required choice between three options.
|}

== Recipes ==

;'''See an inline error.'''
Open [[Validation Clean]], switch to the Subjects tab, and click '''Edit''' on the main subject. Backspace the value in '''Title''' and click '''Save changes'''. The dialog stays open, the Title field gets a red border with "Please provide a value.", and a toast appears: ''Validation failed for "Validation Clean". Please fix the highlighted fields.'' The PUT in the network panel returns <code>422</code>.

;'''See the error clear as you type.'''
Trigger the inline error above, then type any character into the Title field. The red border disappears immediately, before you click Save again. The dialog wires the input back up to drop the matching server-side violation as soon as you edit.

;'''See the success path still work.'''
Set <code>$wgNeoWikiEnforceValidation = false</code> and repeat the empty-Title save. The PUT now returns <code>200</code>, the dialog closes, and the success toast fires. The 200 body still mentions the violation but it's advisory only — no inline marking, no rejection. This proves the step-1 contract from PR #855 still holds.

;'''See a create-side error.'''
With enforcement on, click '''Add subject''' under "Other Subjects on this Page", choose '''Validation Demo''', leave Title empty, and click '''Create subject'''. The create dialog behaves the same as the edit dialog: 422, dialog stays open, Title decorated, validation-failed toast.

;'''See a per-entry error on a multi-value field.'''
With enforcement on, open [[Validation Clean]] → edit the main subject. Change the second '''Tags''' entry from <code>https://example.com/b</code> to <code>ftp://example.com/b</code> and click '''Save changes'''. Confirm: only the second sub-input gets the red border, the first stays clean. The 422 body carries <code>valuePartIndex: 1</code>, which the editor uses to target just that input.

;'''Form-level banner.'''
This one is reachable only when a violation has no field anchor (e.g. <code>schema-not-found</code>, or a property removed from the schema after a Subject was saved). The component tests cover it; there's no clean UI reproduction against this schema. Verify in the test suite.

== Backend wire shape ==

A 422 body from the persistence layer looks like:

<syntaxhighlight lang="json">
{
"status": "error",
"message": "Validation failed",
"violations": [
{ "propertyName": "Title", "code": "required", "args": [], "valuePartIndex": null }
]
}
</syntaxhighlight>

The frontend parses this in <code>RestSubjectRepository</code> and throws a typed <code>ValidationFailedError</code>. Both <code>SubjectEditorDialog</code> and <code>SubjectCreatorDialog</code> catch it and feed the violations into the editor's reactive state. Each violation routes by <code>propertyName</code> (and <code>valuePartIndex</code> for multi-value inputs) to the matching field. Violations without an anchor fall into a form-level banner above the editor.

== References ==

* [[Schema:Validation Demo]] — the schema source
* [[Special:Schemas]] — all schemas in the wiki

Validation Clean

NeoWiki — Thu, 11 Jun 2026 11:31:08 GMT

Importing NeoWiki demo data

New page

A demo Subject with every property of the [[Schema:Validation Demo|Validation Demo]] schema filled in correctly. The starting point for the recipes on the [[Validation Demo]] hub page.

Schema:Validation Demo

NeoWiki — Thu, 11 Jun 2026 11:29:57 GMT

Importing NeoWiki demo data

New page

{
"description": "A demo schema for trying out backend validation. Use it together with the Validation Demo hub page to see how the editor surfaces server-side errors next to each field.",
"propertyDefinitions": {
"Title": {
"type": "text",
"required": true,
"description": "Required. Save with this empty to see an inline error."
},
"Homepage": {
"type": "url",
"required": true,
"description": "Required. Must be a valid http or https URL."
},
"Tags": {
"type": "url",
"multiple": true,
"description": "Optional list of URLs. Each entry must be a valid http or https URL."
},
"Status": {
"type": "select",
"required": true,
"options": [
{
"id": "o1valida1aaaaaa",
"label": "Draft"
},
{
"id": "o1valida2aaaaaa",
"label": "Approved"
},
{
"id": "o1valida3aaaaaa",
"label": "Archived"
}
],
"description": "Required. Pick one of the three statuses."
}
}
}

Module:SubjectRow

NeoWiki — Wed, 10 Jun 2026 10:18:46 GMT

Importing NeoWiki demo data

← Older revision		Revision as of 10:18, 10 June 2026
Line 34:		Line 34:
	local view		local view
	if viewLayout and viewLayout ~= '' then		if viewLayout and viewLayout ~= '' then
	view = frame:preprocess( '{{#view:' .. id .. '\|' .. viewLayout .. '}}' )		view = frame:preprocess( '{{#view:' .. id .. '\|layout=' .. viewLayout .. '}}' )
	else		else
	view = frame:preprocess( '{{#view:' .. id .. '}}' )		view = frame:preprocess( '{{#view:' .. id .. '}}' )

ACME Inc

NeoWiki — Wed, 10 Jun 2026 10:18:42 GMT

Importing NeoWiki demo data

neo
← Older revision		Revision as of 10:18, 10 June 2026
Line 25:		Line 25:
	"type": "number",		"type": "number",
	"value": 42		"value": 42
			},
			"Is public": {
			"type": "boolean",
			"value": true
	},		},
	"Products": {		"Products": {

Rijksmuseum

NeoWiki — Wed, 10 Jun 2026 10:18:37 GMT

Importing NeoWiki demo data

@@ Line 152: / Line 152: @@
                     "value": [
                         "https://www.rijksmuseum.nl/en/press/press-releases/the-rijksmuseum-in-2020"
+                    ]
+                }

Schema:Company

NeoWiki — Wed, 10 Jun 2026 10:18:25 GMT

Importing NeoWiki demo data

← Older revision		Revision as of 10:18, 10 June 2026
Line 61:		Line 61:
	"type": "number",		"type": "number",
	"default": 0		"default": 0
			},
			"Is public": {
			"type": "boolean"
	}		}
	}		}

Schema:Everything

NeoWiki — Wed, 10 Jun 2026 10:18:25 GMT

Importing NeoWiki demo data

@@ Line 40: / Line 40: @@
 			"minimum": 42,
 			"maximum": 100
 		},
 		"select/select": {
@@ Line 105: / Line 117: @@
 			],
 			"multiple": true
 		},
 		"relation/relation": {