Using custom enum select picker for Wiki Macro parameters

There might be cases where you want to display a Wiki Macro parameter as a select picker. However, for this you will need a Java Enum defined in the wiki that will correspond to the possible values your parameter can take. The easiest way to have that (for now) is to create a Java Enum and bundle it as a jar dependency of your project.

Here is, for example, how to implement a custom Ascending / Descending select picker for a sort order parameter.

Step 1: Java enum

Write your custom java enum:

Then bundle it as a jar, and import it in your instance (by manually placing it in the WEB-INF/lib directory, or using the extension manager).

Step 2: Wiki Macro parameter type

Simply set your parameter type to your.enum.package.SortOrderEnum in the Wiki Macro page.

Step 3: Translations

For now, values are being displayed as is. To display a custom title for each value, you'll have to setup translation keys.
Create a page with a XWiki.TranslationDocumentClass object, where translation keys are your enum full name concatenated with the enum value: