Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: MOTION-157

...

This means that you do not need to provide keys for all UI elements in your app. Keys for commonly reused elements such as buttons and subapps are in Magnolia's own modules. Just reuse the UI element in your app, and Magnolia will find the existing key automatically. In simple terms, the shorter the form of the key, the more places it will be applicable toapply to.

Example: The contact edit form has Save changes and Cancel buttons.

The Contacts app does not provide the text for either button in its own message bundle. They are provided in the module-ui-framework-messages_en.properties file of the ui-framework module.

...

Therefore, it is not necessary to insert two specific keys such as the following into the .properties file of the Contacts app:.

Code Block
languagepowershell
titlecontacts-app-messages_en.properties
contacts-app.actions.commit=save changes
contacts-app.actions.cancel=cancel

If your app needs these buttons, just name your actions commit and cancel.

...

enableHeadingAttributesfalse
enableSortingfalse
classm5-configuration-tree
enableHighlightingfalse

...

Mgnl n
actions

...

Mgnl n
commit

...

Mgnl p
class

...

info.magnolia.ui.form.action.SaveFormActionDefinition

...

Mgnl p
implementationClass

...

info.magnolia.contacts.app.form.action.SaveContactFormAction

...

Mgnl n
cancel

...

Mgnl p
class

...

info.magnolia.ui.form.action.CancelFormActionDefinition

Image Added

Providing a key to other modules or apps

...

  • [<app>.][<subapp>.]views.numerator<column>[.label]

(warning) If used in the key, <subapp> requires <app>.

...

Tabs

  • <module>.<dialogPath>.<tab>[.label]
  • dialogstabs.<dialogPath><tab>[.label]

Chooser dialogs

Dialogs

  • <module>.<dialogPath>
  • Generic: dialogs.chooseDialog[.label]
  • App-specific: <app>.chooseDialog[.label] Action
  • -specific: dialogs.<action><dialogPath>[.label]

...

Fields

  • <module>fields.<dialogPath>.<tab><field>[.label]
  • tabs<app>.<action>.<tab><field>[.label]

...

Select fields

  • Generic: fields.<field>.options[.label]
  • App-specific: <app>.<action>.<field>.options[.label]

Field validators

The generic i18n key for a field validator is validators.<validatorName>.errorMessage.

...

  • [<module>.]<dialogPath>.[<tab>.]<field>.validation.errorMessage
  • <tab>.<field>.validation.errorMessage
  • fields.<field>.validation.errorMessage

Templates

Pages/components

  • [<module>.]templates.<templatePath>
  • [<module>.]templates.<templatePath>.description

Areas

  • templates.areas.<areaName>
  • templates.areas.<areaName>.description