Confluence Add-on

Maprosoft Confluence Add-on

Do you use Confluence Server? It's a wiki providing team collaboration capabilities used by thousands of companies around the world.

The Maprosoft Confluence Add-on makes it easy to add maps and other Maprosoft generated content into Confluence pages.

Confluence Macros Dialog

Here's how it works. Whilst editing any Confluence page, select 'Other macros' from the 'Insert' menu and then select one of various Maprosoft options:

  • Add Maprosoft map: This allows a map to be embedded into the Confluence page. The map can provide any functionality provided by Maprosoft. You may like to use Maprosoft's Map Builder Control Panel to select the map features and generate the map link.
  • Add Maprosoft map gallery: This allows a map gallery to be added to the Confluence page. This allows readers to browse your different types of maps.
  • Add popup Maprosoft map link: This allows a map link to be added to the Confluence page. When clicked, a map will be displayed within a popup over the Confluence page. Once again, use Maprosoft's Map Builder Control Panel to select the map features and generate the map link.

Tip: To find the above options more easily, select the 'External Content' section within the insert dialog.

Detailed Instructions

Detailed instructions for using the Maprosoft Confluence add-on are below. Please Contact Us if you need more help.

Adding a Map

The 'Add Map' macro allows a Maprosoft to be embedded within a Confluence page.

Fill in the macro fields as follows:

  • team: This is the name or key of your Maprosoft team (you need to be signed up to Maprosoft).
  • mapApi: Select the type of map system to use - GoogleMaps or MapQuest.
  • showMapToolbar: Indicates whether to show a toolbar allowing the control of certain features. More info.
  • showStackToolbar: This only has effect if showMapToolbar is true. If this is set to true, then the 'Stack Toolbar' will be chosen, otherwise a regular toolbar will be chosen. More info.
  • showAllFeatureTypes: Indicates whether all feature types should be made visible. If showMapToolbar is false, then this will result in all map data being downloaded. More info.
  • showFeatureTypes: Indicates specific feature types to make available to the map. More info.
  • width: The width of the map. Use HTML notation (e.g. 600px, 100%).
  • height: The height of the map. Use HTML notation.

Adding a Popup Map

The 'Add Map Popup' macro allows a link to be created that, when clicked, results in a Maprosoft map popping up.

Fill in the macro fields as follows:

  • team: This is the name or key of your Maprosoft team (you need to be signed up to Maprosoft).
  • mapApi: Select the type of map system to use - GoogleMaps or MapQuest.
  • tooltip: A tooltip to display when the cursor hovers over the link. More info.
  • focusFeatureType: If the map should initially focus on an item within it, then this parameter specifies the type of the feature. More info.
  • focusFeatureKey: If the map should initially focus on an item within it, then this parameter specifies the feature's key. More info.
  • focusAction: If the map should initially focus on an item within it, then this parameter specifies the type of focus action to occur. More info.

Adding a Map Gallery

The 'Add Map Gallery' macro allows a Maprosoft map gallery to be embedded within a Confluence page.

Fill in the macro fields as follows:

  • team: This is the name or key of your Maprosoft team (you need to be signed up to Maprosoft).
  • width: The width of the map gallery. Use HTML notation (e.g. 600px, 100%).
  • height: The height of the map gallery. Use HTML notation.

Source Code

The Maprosoft Confluence Add-on source code is available on GitHub at https://github.com/Maprosoft/maprosoft-confluence.

Contributing

We'd love you to get involved and make some improvements. Please push your changes to a branch, create a pull request and get us to review it.