This issue has been created
There are 2 updates.
 
 
Release Notes Application / cid:jira-generated-image-avatar-bfd006e0-d7ef-49e0-b15e-5307963cd498 RN-77 Open

Wrong Administration category, default product name and missing field hints in the configuration UI

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-ca4eb051-be70-4cff-b201-5e04b2406e1d Vincent Massol created this issue on 29/Aug/26 21:14
 
Summary: Wrong Administration category, default product name and missing field hints in the configuration UI
Issue Type: cid:jira-generated-image-avatar-bfd006e0-d7ef-49e0-b15e-5307963cd498 Bug
Affects Versions: 2.4
Assignee: Unassigned
Components: Application
Created: 29/Aug/26 21:14
Priority: cid:jira-generated-image-static-major-1614d84b-7ab5-476d-a96f-9e5da4f1ec89 Major
Reporter: Vincent Massol
Description:

Problem

RN-73 registered ReleaseNotes.Code.ReleaseNotesConfig in the wiki Administration through an XWiki.ConfigurableClass xobject, but the result has three defects:

  • Wrong Administration category. The xobject sets displayInCategory to content, which is the category reserved for the categories bundled with XWiki Standard. The Release Notes application is not bundled, so its administration section must be registered under the other category, next to the other non-bundled extensions.
  • A default product name is shipped. The configuration xobject ships with product set to XWiki. Nothing makes XWiki a sensible default for an arbitrary wiki: the application is meant to manage the release notes of whichever product(s) the wiki is about. Shipping that value means every administrator who does not notice it ends up creating release notes for a product literally called "XWiki". The shipped value must be empty so that the administrator has to make a conscious choice.
  • No hints on the configuration fields. The section displays two fields, "Default Product Name" and "Template Reference", with no explanation of what they are used for or what format they expect (in particular, "Template Reference" expects a page reference, and it is not obvious that the field only affects newly created release notes). XWiki.ConfigurableClass displays a hint below each field label when a <classReference>_<property>.hint translation key exists, and both properties should have one.

Proposal

  • Set displayInCategory to other.
  • Ship an empty product value.
  • Add the ReleaseNotes.Code.ReleaseNotesConfigClass_product.hint and ReleaseNotes.Code.ReleaseNotesConfigClass_template.hint keys to the ReleaseNotes.Code.Translations bundle, and set the matching hint attribute on both XClass properties so that the hints also show up in the object editor.
 
 

2 updates

 
cid:jira-generated-image-avatar-ca4eb051-be70-4cff-b201-5e04b2406e1d Changes by Vincent Massol on 29/Aug/26 21:14
 
Fix Version: 2.4.1
Assignee: Vincent Massol