![Advanced-UI](https://img.shields.io/static/v1?label=UI&message=Advanced&color=lightgrey)

The "Share Menu" plugin allows the user to copy/send/open external links to nodes (configured via properties).

**Links:** The URL may contain the string {nodeId} which will be replaced by the node id of the currently selected node. The URL is determined by looking at the selected node itself, all its parents from parent to root, the defaults for the node's type and the global default in this order. The first link found will be returned.

The menu item is only shown when the selected node has an external url configured.

[MINITOC]

## Properties

To be configured in {home}/appserver/conf/custom.properties

##### shareMenu.license
> type: String, **required: yes**, default: -

The license for the product (provided by brix IT Solutions).

##### shareMenu.allowedUserGroups
> type: list of user group ids (comma-separated), required: false, default: visible for everybody

A list of user groups for which the menu entry is visible. If there are no usergroups defined, it is visible for everybody.

##### shareMenu.nodes.default
> type: string, required: no, default: -

The global fallback URL for all node types. `{nodeId}` will be replaced by the ID of the selected node.

Example: `https://my-external-site.com?show={nodeId}`

##### shareMenu.nodes.{nodeTypeId}.default
> type: string, required: no, default: -

Fallback URLs per node type. `{nodeId}` will be replaced by the ID of the selected node.

Example: `https://my-external-site.com?show={nodeId}`

##### shareMenu.nodes.{name}.nodeIds
> type: list of node ids (comma-separated), required: no, default: -

The node ids for the configuration {name}.

##### shareMenu.nodes.{name}.url
> type: String, required: no, default: -

The URL for the configuration {name}. `{nodeId}` will be replaced by the ID of the selected node.

Example: `https://my-external-site.com?show={nodeId}`

##### shareMenu.nodes.{name}.showOnRoot
> type: Boolean, required: no, default: false

Whether the specified URL is also valid for the node ids of the configuration {name} or not.

## Screenshots

![menu](./share1.png)

![popup](./share2.png)

## Compatibility Matrix
| Share Menu  | CELUM (min. version)
| :-----    | :-----
| 1.0 | 5.13.3 |

## Release Notes

#### 1.0.0
> Released 2019-03-07

Initial version

#### 1.0.5
> Released 2019-07-15

Minor improvements (Chrome mailto link fix, new menu icon, visibility wasn't consistent with access rights)

#### 1.0.7
> Released 2020-01-07

Changed GetMapping to RequestMapping, because the former seems to randomly cause the plugin fail. With the latter it works without problems.