Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
styledisc
exclude
typelist
class
printablefalse

Back to the Tryout page: Easy Dropdown Menu

Easy Dropdown Menu Documentation: https://doc.eps.ch/pedmc/latest/get-started

...

Overview

Edit Mode Macro

Panel
bgColor#FFBDAD

The Edit Mode Macro renders the currently chosen option/s in view mode, but the option/s can only be selected in edit mode.

Example:

Edm menu edit mode
multiselectfalse
currentOption["23184c57-4e5b-4c4d-9a52-ce0d770e1c15"]
currentOptionValuePlannig
currentSet89b3633f-756a-43bd-89cc-19b3e32c4e0b
customSeparator,
Yes

Edm menu edit mode
multiselecttrue
currentOption["a3d93311-5979-4f1f-9eb1-80943d9819db","ab78a570-0fcc-48f1-8519-6883ac2afd44","4ddc8f60-44cf-4824-92f9-52aaa7407aec","d42f687a-8263-48d9-aea7-e3e119df3f59"]
currentOptionValuePhoebe Smith,Eliza Foster,Anna Benson,Jack Gregory
currentSetb0400b3d-3968-414b-9301-c964afd40b76
customSeparator,

...

Not Predefined Macro

Panel
bgColor#FFBDAD

The Not Predefined Macro gives you the possibility to directly configure your option set and renders a drop-down in view mode.

Example:

Edm menu
multiselectfalse
valuesYes,No, Maybe, Of course
blankOptionfalse
macroWidth0
currentGroup
currentValueYes
referenceLockfalse

...

Predefined Macro

Panel
bgColor#FFBDAD

The Predefined Macro also renders a drop-down, but lets you use predefined option sets that you configured in the space and global configurations of the plugin.

Example:

Edm menu predefined
multiselectfalse
currentOption["2292020c-2035-441a-8eff-1d5590c30f6b"]
blankOptionfalse
macroWidth0
currentOptionValueAnna Coleman
currentGroup
currentSetb5804065-6076-4ab5-a7db-776a0e360721
referenceLockfalse

Edm menu predefined
multiselectfalse
currentOption["314ccba3-fd94-4c4a-9bf0-4914a5930c7b"]
blankOptionfalse
macroWidth0
currentOptionValueBowling
currentGroup
currentSet9dfeabac-dc41-4773-9b8c-8b9b2c98c90f
referenceLockfalse

...

Status Macro

Panel
bgColor#FFBDAD

The Status Macro uses predefined status sets that you can configure for colors, texts and styling in the space and global configurations. It replaces the basic confluence status macro.

Example:

Edm menu status
currentStatusValueCOMPLETED
currentStatusInvertfalse
currentStatus21ec96bd-ec4b-4394-b90e-104d4f60b0bd
currentStatusTextColor#000
currentStatusColor#2cec26
currentGroup
currentSeta99e80af-a32b-42c0-91a8-8d408c45a5a8
referenceLockfalse

...

Admin Guide

Space and Global Configuration

On the Space and Global Configuration new sets can be added

To add a new Set just define a new set name

...

Now click on the + icon to add a new option

...

You can also pick a color and also invert it with the text color if you want by clicking on subtle.

you can create Predefined and Status sets.

Create a new Text Set

  1. Create a new text set by pressing the + button in the Predefined Sets section.

  2. Enter the name of your set in the Set Name input field.

  3. To create your options for your set, press the + icon and enter the option value in the input field.

  4. If you are finished, then save the newly created set by clicking the Save button in the dialog.

At the end your text set could look like this:

...

Create a new Status Set

  1. Create a new text set by pressing the + button in the Status Sets section.

  2. Enter the name of your set in the Set Name input field.

  3. To create your options for your set, press the + icon and enter the option value in the input field.

  4. Then click on the pencil icon to change the color of the option.

  5. If you are finished, then save the newly created set by clicking the Save button in the dialog.

At the end your text set could look like this:

...

...

Use Cases

Filtering with the Page Properties Report Macro

You can just place the EDM macros inside the page property macro. (Works with every EDM Macro)

...

EDM All Dropdowns

Filter by value for all Dropdown macros

EDM Dropdown

Filter by value for Easy Dropdown Menu Predefined, Not Predefined and Edit-Mode macros

EDM Dropdown Fuzzy

Filter for a rough match by value for Easy Dropdown Menu Predefined, Not Predefined and Edit-Mode macros

EDM Status

Filter by value for Easy Dropdown Menu Status macros

EDM Status Fuzzy

Filter for a rough match by value for Easy Dropdown Menu Status macros

Filtering with the Confluence Advanced Search

Currently the search of dropdown macros or values through the Confluence Advanced Search is not supported. However, you are able to make the CQL search in the URL. Navigate to the Confluence Advanced Search page.

Query for EDM Macros

Modify the URL to filter for your desired macro:

Code Block
https://{confluence-cloud-instance-name}.atlassian.net/wiki/search?cql=macro="{macro-name}"

Macro

Name

Edit Mode Macro

edm-menu-edit-mode

Not Predefined Macro

edm-menu

Predefined Macro

edm-menu-predefined

Status Macro

edm-menu-status

Query for EDM Values

Modify the URL to filter for your desired values:

Code Block
https://{confluence-cloud-instance-name}.atlassian.net/wiki/search?cql={property-name}="{value}"

Macro

Property Name

Edit Mode Macro

edmTextProp1

Not Predefined Macro

edmTextProp1

Predefined Macro

edmTextProp1

Status Macro

edmStatusProp1

All EDM Macros

edmAllProp