Social Share for Confluence - Manual

In this tutorial, We will see how to configure Social Share for Confluence - With this app at hand, you can easily make your wiki shareable.

Social Share Settings Screen

Social Share settings screen allows to configure the plugin. You can custumize how the page will be displayed in the social feeds and display share buttons.

Navigate to the settings screen:

  • After installing the plugin, login with user who has administrator's privileges.
  • Click at Confluence Administration icon in top right menu. In popup menu click General Configuration
  • Go To Social Share section in the left menu and click Settings

OpenGraph Tab

The OpenGraph meta tags allows you to custumize how the page will be displayed in the social feeds.

The social share plugin add the tags based on specified values in this tab

Title

The title of your wiki page

  • {title} will be replaced with the current page title.
  • The title should be short and concise - No more than several words
  • The title should be descriptive and clear.
  • Facebook recommends that title should not contains branding or mentioning the wiki's domain

Description

1-4 sentences which describe your wiki page.

  • {about} will be replaced with the current page description :
    • If not empty , the output of Excerpt Include macro for the current page (The content of the first Excerpt macro)
    • Otherwise, the first sentence of the current page ( In other words, The text until the first period )

Website link

The Website link should be the a URL for your wiki or your top level domain.

Image

A URL to the default image representing the content of the page.

The image displayed in shared item:

  • if attached to the current page , og.jpg
  • if attached to the current page , og.png
  • Otherwise, The the default URL will be used

Facebook recommends :

  • The minimum image size is 200x200 pixels.
  • Images can be up to 8MB in size.
  • For best display on high resolution devices, the image should be at least 1200x630 pixels.
  • For display link page posts with larger images, the image that should be at least 600x315 pixels.
  • Otherwise, The small link page will be displayed in the feed.
  • Try to keep your images as close to 1.91:1 aspect ratio as possible to display the full image in News Feed without any cropping.

Twitter Tab

In Twitter tab you can customize specific data for twitter.

Card

The twitter card. Can be Summary Card or Summary Card with Large Image

Site

The Twitter @username for the website used in the card footer.

Creator

The Twitter @username for the content creator/author.


AddThis Tab

If you have AddThis Account, you can easily add share buttons.

First, Create inline share buttons unit in your AddThis account and customize it to your needs. Click Get The Code button of the inline share buttons unit.

Find the AddThis public ID

The id has the following format ra-xxxxxxxxxxxxxxxx
Find in the AddThis public ID

Find the AddThis Class Name

The class name has the following format addthis_inline_share_toolbox_xxxx
Find in the AddThis class Name

Fill the values

Fill the values you extract from AddThis unit code and verify that the share are displayed below the title of the page