Page tree
Skip to end of metadata
Go to start of metadata

Microblogging for Confluence

Share information, have conversations, write messages and updates

See the documentation for your Release

Write a micropost


Mention a user by typing "@" and you'll get suggestions.


Choose a topic for your micropost.

The microblog editor to write a micropost is similar to the one used by Confluence for comments. Use it to share information and style your micropost.

You can use:

  • Text formatting
  • Links
  • Images
  • @ to mention a user
  • # to label / hashtag a micropost
  • Some macros ((warning) Please note that not all macros work within the microblog. Especially if you insert them via copy / paste.)

You also have to choose a microblog topic to store your micropost in ("Cat content" in the screenshot). In most cases, a suggested topic is preselected. If you cannot see the option to select a topic, the topic is predefined by context or macro configuration.

Reply to a micropost


Replying to a micropost uses the same editor as writing a new one.

Replying to a micropost is pretty much the same as writing a new one. By clicking the "Reply"-Button the related micropost will be moved to the top of the timeline and you can answer while seeing the context. Obviously, you can not change the microblog topic when writing an answer.

You can not only reply to top-level microposts, but also to replies. Currently, no actually nested replies are created. Instead, your reply goes to the top-level post, but the post you refer to will be highlighted in the context and an @-mention will be inserted in the editor. Also, the editor now always shows up directly under the post you refer to so that you don't have to scroll through all the reply context.

 

Edit a micropost


By clicking the "edit" button, you get the well known editor to change your post.

After editing, the micropost is marked as "edited". You can open the version history by clicking this word.

The version history shows every change that was made.

You can edit your microposts to correct a typo, fix a link or whatsoever.
(info) Note that every Confluence administrator can also edit or remove your post!

After saving an edited micropost, it will be marked as "edited", so that others are aware that the post has been modified.

Click the "(edited)" link to show a version history overlay. It includes all modifications that have been made to this post, including date, time, the modifying user and the post contents.

Note that editing a micropost will not change the order of the timeline. The edited micropost will not be on top.

Delete a micropost

As a regular user you can delete your own microposts. Confluence or Space admins can also delete other users' microposts. But there is one rule: Only the last post of a conversation can be deleted at any given time. This rule applies to both regular users and admins. The idea behind this rule is to prevent anyone from distorting the meaning of a post by changing its context. 

If you want to remove a whole thread, you'll have to do so one post at a time.


Topic sidebar

With the topic sidebar you can decide which topic or space you want to see in your timeline.

The topic sidebar on the right

Show or hide the topic sidebar

You can choose between...

  • the "Global Timeline" to see all microposts from all spaces that you are permitted to view,
  • a space timeline (bold) to see all microposts in all topics inside this space,
  • or a topic timeline to see all microposts inside this topic.

Using the "Show / Hide topics" button you can show the sidebar or hide it to save some space for the micrpost contents.

(warning) The macro can be configured to restrict the topic sidebar to a given space.
The macro can also be configured to only show a given topic and not display the sidebar at all.
(See Configure Macro)


Inserting the macro / Inserting a timeline in a wiki page

Within the "Microblog Timeline" macro you have a powerful configuration to customize your timeline.

Add macro

 
2. Add "Other macro"

  1. Create or edit a page.
  2. Add "Other macro".
  3. Search for "microblog timeline" in the macro selector and add the "Microblog Timeline".
  4. Configure Macro (See Configure macro)
  5. Click on "Insert".
  6. Click on "Save". - You should see microposts - if any exist - in your Confluence wiki.
    (warning) Your admin has to configure at least one topic to get the microblog timeline to work - otherwise you are not able to write a micropost.

Configure macro

 

This shows a configuration for a "space timeline".

  1. Default timeline: Choose the default source for this microblog and configure which posts are displayed initially.
    Depending on this configuration you have different parameters to set. (See Configuration combinations)
    1. Global: Initially shows the "global timeline" with posts from all spaces and topics.
    2. Space: Initially shows a "space timeline" with posts from the specified space.
    3. Topic: Initially shows a "topic timeline" with posts from the specified topic. The user can switch to other topics.
    4. Topic (without topic sidebar):  Shows a topic timeline with posts from the specified topic. The user can not switch to other topics.
      Note: The topic sidebar is disabled with this configuration.
  2. Space: Choose the space from which the microposts should be loaded.
  3. Default topic for posting: Select a topic where the microposts should be stored by default. When using a space timeline, the dropdown is restricted to topics from the specified space.
  4. Topic: Choose the topic from which the microposts should be loaded and where they should be stored by default.
  5. Restrict topic list: Should the topic list in the microblog be restricted to the selected space? When using a topic timeline, the topic list will be restricted to the space the specified topic is in.
  6. Hide topic sidebar: Initally hide the topic sidebar instead of showing it. Users can still expand the sidebar (and they still can hide it if you don't select this option).
  7. Limit number of microposts shown: Optionally enter the number of microposts displayed on a page - default is 20 and max is 100. The limit applies to "parent" microposts, not to replies. When there are more posts in the microblog, a "Show more posts" link is displayed.
  8. Limit number of replies shown: Optionally enter the number of initially displayed replies to each micropost - default is 3. When there are more replies to a micropost, they can be viewed by clicking on a "X more replies" link.

(lightbulb) No worries: This configuration looks harder than it is. Just try it and use the preview button in the "Edit 'Microblog Timeline' Macro" view to see the results.

Configuration example

Configuring a so called "space timeline" which only shows microposts from every topic in the given space

This configuration creates a "space timeline" showing microposts from all topics of the configured space "Third Microblog".

Posts will be saved to the topic "Off Topic" in the space "Third Microblog", if the user doesn't change the topic.

The topic sidebar will show all topics in all spaces, but is hidden by default.

No Microposts are shown in the preview, because there aren't any in this space so far.

Configuration combinations

 Space (2)Default topic for posting (3)Topic (4)Restrict topic list (5)Hide topic sidebar (6)Sidebar always hidden
Global(error)(tick)(error)(error)(tick)(error)
Space(tick)(tick)(error)(tick)(tick)(error)
Topic(error)(error)(tick)(tick)(tick)(error)
Topic (without topic sidebar)(error)(error)(tick)(error)(error)(tick)



Microblog action

The microblog now has its own page where you can see the global timeline. You can get there by clicking the link in the application header.

The microblog action is also available under: http://<Confluence-URL>/plugins/microblog.action.

Notifications


A typical notification after a user mentions you in a micropost.

If a user replies to your micropost or you get mentioned in a micropost, you'll get an email notification (if you configured your account to receive notifications).

The notification emails contain the micropost with complete context (i.e., all replies), and with all attached images.

You can directly view, answer and like the micropost.

Receive your daily digest for certain spaces or for all


The subscribe button for the daily digest on your global timeline.

If you want to know what is going on inside your confluence microblog, but you can't access your intranet because you are out of office (and maybe your confluence is behind a firewall), the daily digest feature is what you are looking for.

Simply click the watch button on your global timeline and get an email with all unread posts.

(warning) If you cannot see the watch button, your administrator has disabled the daily digest feature of the microblog.



The subscription dialog after clicking the watch button.

By clicking the checkbox you can subscribe to or unsubscribe from the daily digest. You can also choose the hour when you want to receive your daily digest.

(warning) Please note that your server time can differ from your local time ("current server time: 12:07" in the screenshot). So if your local time is 10:07 you are 2 hours behind your server time.

 

 


This daily digest will deliver only posts from space Marketing.


Depending on the configuration of the microblog you are currently looking at, you'll receive a different daily digest.

If it is configured as a global timeline, it shows all microposts written in all spaces of your wiki you have at least reading access to. You will subscribe to all those microposts, too. The text inside the subscription dialog says "from all spaces" in that case. You'll usually find that kind of configuration in smaller companies.

If it is configured as a timeline showing microposts from a single space only, you'll subscribe to those microposts only. In that case the text inside the subscription dialog says "from space <spacename>".
If you want to subscribe to another space's microposts, please visit the page that microblog is embedded in and click the watch button there.

You'll receive only one daily digest email per day, even if you subscribe to posts of several spaces.

 

  • No labels