Model Validation UI

Last modified by Admin on 2024/05/11 00:12

cogAdmin UI for Model Validation
Developed by

XWiki Development Team

Active Installs1437
0 Votes
LicenseGNU Lesser General Public License 2.1
Bundled With

XWiki Standard


Since XWiki 12.0RC1

Installable with the Extension Manager


To learn more about Model Validation, check the following:

This extension allows configuring the validation strategies to use in XWiki.

The Name Strategies can be configured from the Administration Application, on the Editing tab.

Current Naming Strategy


You can select there which name strategy you want to use for the whole wiki.
The different strategies available in XWiki are detailed in the dedicated section.
Note that if you don't want to use any strategy, you can just disable the two following values to not use transformation or validation.
By default the Character Replacement Strategy is selected.

Transform Names Automatically


This option allows you to automatically transform the page names before they are created, in order to comply with the selected strategy.
Note that only the page names will be transformed: the page titles will remain untouched.
By default this option is enabled.

Validate Names Before Saving

This option allows you to automatically validate a page name when it is created: if the page is not valid, the user will get an error and will be asked to use another name.
Note that this concerns the whole path of the page: not only its name, but also the name of its parents.
This validation check is only perform when creating new pages, so even if you enable it you should be able to edit existing documents that don't comply with the naming strategy.
Nevertheless, this feature is still experimental, so it is disabled by default.

Test the Strategy you selected


This text input allows you to type any text to check how the name strategy will behave: it will show you if a potential name is valid or not with the currently selected strategy, and how the strategy would transform the names. You don't need to save for performing the tests, so you can easily change the strategy and validate it before saving. 

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Get Connected