Create an individual theme for your Confluence and Linchpin
Select the Linchpin Theme Plugin in your configuration
After Plugin installation you can click the "configure" button, it will bring you to site with a info box which says "activate theme". You can use that shortcut to activate the theme quickly. Or you can do it by hand:
As an admin, click on Confluence Administration -> General configuration. Under LOOK AND FEEL click on Themes and then select the Linchpin Theme Plugin as your default site theme.
Linchpin theme configuration
After you activated your theme, you may have to refresh your browser to see the new "Linchpin Theme" menu.
Other Linchpin Plugins may integrate into Linchpin Theme Plugin and offer options which differ from the screenshot below. Click on Configuration for now to see the LTP standalone features, we will cover the other options later:
Choosing this option will remove the fixed Confluence "All updates" panel on the left. You can use the full width for customization.
Default Confluence Dashboard
This Option makes your dashboard look the same as the Confluence default theme. You can still customize your dashboard, see options below.
Also you can set the width of the right section, the left section will adjust.
Here you can upload an image which will be used as background image on your Confluence dashboard. The background will only be visible on the dashboard.
Keep in mind: Since this background image will be scaled to full width of the browser window, choose an image with an appropriate size to avoid blurry effects and performance issues.
Hide Dashboard buttons
Choosing this option will hide the action buttons (Invite users, create space) on your Confluence dashboard.
Dashboard tiles look
If this option is checked the Confluence dashboard will appear in a nice tiles look.
To edit your dashboard layout, you need to edit your Confluence "Default Welcome Message". As an administrator you can find it under: "Configuration" →"Global Templates and Blueprints"
Logo image: You can upload your own Logo here.
Logo position: You can place your logo on the left or right side. Left: Logo and intranet name left, searchbar and user menu on the right side.
Right: Logo and intranet name on the right side, search bar and user menu left.
Header height: Sets the height of your header between 80-140 pixel.
Header background color: The background color for the whole header.
Header background image: An image to use as your header background. You can choose to set your header background image only on your main dashboard or on every page.
Intranet name: A text which will appear next to your logo.
Intranet name color: The color of your intranet name. Only shown if a name is set.
Intranet name size: The font size of your intranet name. Only shown if a name is set.
Color used for header icons: The icon colors in your header, like the notification icon.
Color used for notifications: The color for your notifiction count when someone mentions you, shares something, replies etc.
Subheader background color: The color for the bar below your header.
Buttons and links
For example, you can find a create button on your dashboard. It's used to create a page or post etc.
For example, you can find these in dialogues, like the one you see when clicking on the three dots next to the create button.
Primary button hover color: Changes the button hover color.
Global link color
"back to top" button
You can find the button on the bottom right cornor, when you scroll down a page. It allows you to quickly scroll up to the first lines of your page.
Background color of the "back to top" button: Changes the button background color.
Background hover color of the "back to top" button: Changes the button hover color.
Text color of the "back to top" button:
Page Headline Color: Changes the text color of your page title on every site.
Headline color (1-6): Changes the text color of your headings. Apply a Conflunce "Heading" style to your text.
Information panel color: Changes the border color of the "Info" macro.
Warning panel color: Changes the border color of the "Warning" macro.
Tip panel color: Changes the border of the "Tip" macro.
Note panel color: Changes the border of the "Note" macro.
Panel icon color: Changes the icon color of your information, warning, tip and note panel.
Define your Teaser Styles
The Administrator can define a preset of teaser styles, which can be used in the Linchpin Teaser macro. It is possible to create up to ten teaser styles. Only teaser styles marked as active can be selected in the macro.
Active: Appears as a style selection in the Linchpin Teaser macro if set to active.
Name: A name for your teaser config.
Background: The background color of your teaser macro.
Text: The color of text in your teaser macro.
Border: The border color around your teaser macro.
Use the Linchpin Teaser Macro
Note: The Image and Icon Teaser are available since version 2.12
The Linchpin Teaser macro has several options:
Teaser type: Select the style of your teaser.
Standard teaser: Can display an image and / or text and adjusts to your image size. Text is visible all time.
Image Teaser: Fixed size. To see your teaser text, hover over it.
Icon Teaser: Fixed size, same as image. To see your teaser text, hover over it.
Teaser colors: Choose from a set of predefined colors (created by the Administrator).
Title: The title of your teaser (mandatory).
URL: You can set a link destination for your teaser to for e.g. a Confluence page, a web page, or an image. Linking to a Confluence page, the macro sets a short url to avoid broken links, when the destination page was moved or renamed. The title of the linked Confluence page appears below the input field. Use the Checkbox to open the link in a new window tab. A linked teaser will show an arrow on the right.
Icon: Choose from a set of predefined icons which will appear in the center of your teaser. Only available for icon teasers.
Button text: Enter text for your button. The button will appear below your teaser title. Only available for image teasers.
Image: Upload or link an image, that will appear above your title.
To include more text (below the title), just insert the Macro and wright your text in the macro body.
The Linchpin sidebar is activated as default and sticks to the right side of your browser. To bring it up, click on the arrow or icon, depending on which style you use. After it expands, it will show you a overview of your favorite Confluence pages. Below are pictures of the "tab" and "icon" style of the sidebar.
You can search your added pages if you like, or remove them from your favorites by clicking on the star icon.
To close the sidebar, click the arrow or icon again - it will collapse back to the right side of your screen.
Note: More options (tabs or icons) will be added when you use other of our plugins. See the "First Steps", or "Examples" page for more info.
Activiate linchpin sidebar: Enable or disable the Linchpin sidebar.
Linchpin sidebar style: Here you can set your sidebar style to tabs or icons, see pictures above.
Initial sidebar state: Set the initial state for your sidebar when a user sees it the first time. The state after user interactions are saved in the user's browser and will override this setting.
Scroll behaviour: Choose whether the sidebar should scroll with the content or be at a fixed position.
Expert Finder: Configure the "Custom User Search" macro from our other Plugin "Linchpin Profiles". See notes below.
Background color of tab: Sets the background color for tabs or icons on the left side of the sidebar.
Icon color: Sets the text or icon color.
Active tab icon color: Sets the text or icon color for the active tab or icon.
Footers are highly visible and you can access them from anywhere in your Confluence or Linchpin instance. Use the Linchpin Theme Plugin's footer color configuration to highlight the most important information or customize the footer to match your Corporate Design. You can set the color of the footer background, titles and links.
The Linchpin Theme Plugin gives you the option to create your own footer links. (Available since Linchpin Theme Plugin v2.9.0)
Add new footer columns
You can add new columns with links to your footer by clicking on the button "Add column". At the moment you can set up a total of 2 columns for your footer links.
Insert your footer links
By clicking on the edit icon in you link list columns you can fill them with individual links.
You can change the color of your dashboard but it will only affect the "Linchpin-Dashboard", see here for more information.
All macros in Confluence are designed for white backgrounds. Setting a different color can lead to unwanted effects.
We suggest to place content in a "Layout-Box" macro with a white background to override the dashboard color. It will also allow you to set inner and outer widths and spacings.
Select the Space layouts configuration
The Linchpin Theme Plugin gives you the option to assign a new layout per space.
You can assign your space layouts to a space directly (step 3), or you can add category labels to your spaces to group them and then assign the category to a layout (step 4).
In the next few steps we will show you how to do it.
Space layouts overview
Clicking on the space layout option will bring you to the overview of all configured space layouts. The list will be empty if you just installed LTP.
To add a space layout, simply enter a name for it in the input box and click on "Add space layout". This will create a space layout which you can configure further. To do so, click the edit pencil.
Configure and apply your space layout
Now you will be presented a familiar screen, which almost looks like the "Configuration", which provides a global layout configuration. A space layout will override a global configuration.
Name of space layout: This is the name of the space layout you are editing. You can rename it here.
Assigned spaces: Here you can assign spaces to which your layout will apply.
Assigned space categories: Here you can assign space categories to which your layout will apply. See the next step for how to assign space categories.
Apply a category label to your space
Click on "Space directory" in your footer area, section "Intranet tools".
Click on the space which should have a category set.
Click on "Space tools" in the bottom left corner of your site and select "Overview".
Click on "edit" next to your space categoriy field.
Type in a new or existing label / text and save.
The label you applied can be used in the layout configuration, see below.
Apply your space category to a space layout
Just type in the name of your space category in the "Assigned space categories" field.
Custom Landing Spaces
Enabling the custom landing spaces
The custom landing spaces feature defines which space a user will see when he logs in. You can use this feature to redirect users by profile data.
For example you have a bilingual site with German and English, every language has it's own space in Confluence. When a user logs in, you can redirect him to the proper page, depending on which locale he has set.
Here you can see three attributes which represent a field in a user's profile. Let's choose "Name" for the first attribute and "Locale" for the second, then click save.
The configuration below will extend. Now click on "Add landing space". It will ask you to type in data:
Landing space: The name of a space, here we used "Demonstration Space".
Name: A username in Confluence, here we used "admin".
Local: A locale, here we used "de".
When a user logs in, this feature will check if the user is named "admin" and has the language "de" set (German). If both matches, then the user's site homepage will be set to "Demonstration Space". Each time he logs in, he will see the "Demonstration Space".
Note: If you choose multiple attributes, they all have to match. They are connected by "AND", not "OR".
Space Types and Space Directory
Select the Space types configuration
The Linchpin Theme Plugin gives you the option to create Space types to summarize space categories. Those will be displayed within the space directory in a separate section, so your users can find the spaces they are looking for even easier.
In the next few steps we will show you how to do it.
Space types overview
Clicking on the space type option will bring you to the overview of all configured space types. The list will be empty if you just installed LTP.
To add a space type, simply click on "Create".
Create new space type
By clicking on "Create" you'll get an overlay where you can set the title and the space categories which should be summarized in the new space type. Please notice, that you can only select already existing space categories.
For example you can create a type called "Teams" and add every category which relates to a team space.
If you want a new space category, please visit the relevant space and set the new category.
Configure the drop-down & fly-out menus of the "Navigation Menu Editor" add-on right from your Linchpin Theme Plugin.
Styling cover stories of Enterprise News
Define the look & feel of the macro "cover stories" of the "Enterprise News Bundle"-add-on by pre-defining color sets for different news types. Defining color-sets for "title on color 1 & 2" make them available in the macro for frontend users.