Confluence compatibility

Plugin	5.3	5.4	5.5	5.6	5.7	5.8	5.9
Release 2.2
Release 2.1
Release 2.0
Release 1.5
Release 1.3
Release 1.0

Topic configuration

All microposts now belong to a topic to improve the information structure of your microblog.

In the Confluence administration you can configure the topic structure under Microblog → Topics.

Adding a timeline to a wiki page

This information has moved to the User Guide: Inserting the macro / Inserting a timeline in a wiki page.

Adding a global timeline to the Confluence wiki dashboard

1. Go to the "Confluence Admin".
2. Click on "Layouts" in the left menu.
3. Edit the Global Layout.

4. Add the snippet $helper.renderConfluenceMacro("{globaltimeline:source=global}") where you want the global timeline to be displayed on your dashboard.

   ...
   <div class="dashboard-group left">
   	<div class="dashboard-item">
       	$helper.renderConfluenceMacro("{globaltimeline:source=global}")
       </div>
   ...

   We recommend adding the microblog macro at the top of the left column so that people can stay on top of important information in your company.

5. With the snippet you just added, users will have to choose a topic for each new micropost. If you want to choose a default topic, replace {globaltimeline:source=global} with {globaltimeline:source=global|defaultTopic=<TopicID>}, where <TopicID> is the ID of the topic you want as default. You can find the topic IDs in the topic configuration.
6. Save the Global Layout. On the dashboard you should now see the global timeline.

Adding a space timeline to the Confluence wiki dashboard

1. Follow the instructions under "Adding a global timeline to the Confluence wiki dashboard", but use the following snippet:
   $helper.renderConfluenceMacro("{globaltimeline:source=space|defaultSpace=<SpaceKey>}") where <SpaceKey> is the space you want to have displayed initially.
2. If you want to choose a default topic for your users, add |defaultTopicInSpace=<TopicID> after <SpaceKey>. The topic ID must be within the chosen space.
3. You can also restrict the available timeline filters to the chosen space by adding |restrictTopicListToSpace=true. The sidebar and topic selection dropdown will now only display topics in the chosen space.

Adding a topic timeline to the Confluence wiki dashboard

1. Follow the instructions under "Adding a global timeline to the Confluence wiki dashboard", but use the following snippet:
   $helper.renderConfluenceMacro("{globaltimeline:source=topic|topic=<TopicID>}") where <TopicID> is the topic you want to have displayed initially.
2. You can also restrict the available timeline filters to the space containing the chosen topic by adding |restrictTopicListToSpace=true after <TopicID>. The sidebar and topic selection dropdown will now only display topics in this space.

Daily digest configuration

By default, your users can subscribe to a daily digest and receive all unread microposts once a day.

In the Confluence administration you can configure the daily digest under Microblog → Daily digest.

The daily digest job

Attachments handling

Before version 2.2, files were attached to the space home page of the selected topic. This could lead to a large number of attachments to this page and produce long loading times. With this release, files are directly attached to microposts and therefore only the needed content is loaded, which improves performance. Furthermore, there is no need for a space homepage.

 We don't provide an upgrade task in this release. If you want to keep old attachments of microposts in a given topic, don't delete the attachments from the corresponding space homepage (or move it).

 Unfortunatly you can't delete certain attachments. Only deleting a micropost will remove all files.

MySQL Database Issues with Emoticons

MySQL < 5.5 has problems with some Emoticons which use a utf8mb4 Character Set (4-Byte UTF-8 Unicode Encoding), see example. This leads to problems saving a micropost and causes an exception in the logs. Your users will only see that nothing happens, so they may be confused. We are having difficulties catching the exception and displaying a meaningful error message.

You may see something like this in the logs:

ERROR [...] [...] logExceptions Incorrect string value: '\xF0\x9F\x91\xBD a...' for column 'TITLE' at row 1
 -- referer: https://... | url: /rest/microblog/1.0/micropost | userName: admin

See also Charset MySQL 5.0 and Charset MySQL 5.5.