General

The blogpost macro allows you to collect and display blogposts in a central customizable overview using the label feature of confluence.

1.0 Setting up a simple blogpost

1. First, you have to create a main page, on which you want to display your blogpost/blogposts.

2. Add a blogpost macro to the main page.

3. Configure the blogpost macro.

Setting	Function
height	Determines the height of the height of the listed blogposts. (number)
width	Determines the width of the blogpost/blogposts. (number)
maxelements	Determines the maximum amount of displayed blogposts. (number)
list	If checked: The blogs with this label will be listed in a list instead of blogposts.
showlabels	If checked: Displays the labels entered into the labels field on the blogpost.
showshortdesc	If checked: The description will be shown below the heading.
showspace	If checked: Displays the space of the target page on the blogpost.
labels	Determines the label group to which the displayed blogposts have to belong to. All pages that have this label and contain an excerpt will be displayed as blogposts here. (If the amount of existing pages is higher than the amount of "maxelements", only the most recent pages will be taken.
datefieldstyle	Determines the background color of the date field.
bigtitlefieldstyle	Determines the background color of the title field.
descriptionfieldstyle	Determines the background color of the description field.
opacity	Determines the contrast between the background and the foreground content.

Each "Blogpost macro" represents one row of blogposts. To add multiple rows of blogpost you need to add one macro for each row.

For this example, we will use the following settings: height: 500; width: 800; maxelements: 1; list: no; showlabels: yes; showshotdesc: yes; showspace: yes; labels: exampleBlogPost. The other settings were left at the default settings.

4. Add the macro and publish the page.

1	2

5. Create a blog for the blogpost content.

Select the type "Blog post".

Click "Create".

6. Add an "Excerpt" macro to the page.


1	2	3

7. Add content to the excerpt macro.

The following parts are important for the Blogpost:

Number	Description
1	The Heading of the blogpost
2	The description of the blogpost.
3	The cover image of the blogpost (background).

The blog content needs to be below the Excerpt.

8. Add the correct "Label" group to your blog. Click on the Label icon above the heading.

Now enter the correct label into the input field and click on "Add".


1	2

9. Publish the blog.

10. The blogpost is now visible on the page with the "Blogpost macro".

1.1 Setting up advanced blogpost page

We will create create a 2x2 Blogpost homepage in this documentation chapter.

1. Create blogs with label groups (Chapter 1.0, step 5-9).

The following Table represents the sample Blogs we will use in this example.

Blog	Label	Heading	Description
1	group1	Testing procedures	Rapidiously revolutionize holistic testing procedures and integrated vortals.
2	group1	Business metrics update	Holisticly impact business metrics through superior collaboration and idea-sharing.
3	group2	E-Market vision	Continually brand client-centered internal or "organic" sources and ubiquitous e-markets.
4	group2	Advanced administration management	Completely build e-business synergy via cross functional communities. Phosfluorescently administrate value-added convergence without market positioning solutions.

2. Create a new Confluence page (normal page) and add a "Blogpost macro" (Chapter 1.0, step 1-2).

3. Configure the "Blogpost macro".

Information
If you want to display more than one blogpost in a row, you have to set the setting "maxelements" to more than one or to the desired amount.
The width and height is set per blogpost. That means if you set a height of 400 and a width of 200 e.g. and allow 2 blogposts, then the combined size of the blogposts will be 400 h x 400 w.
If more than one blogposts is enabled. The macro will try to display the blog posts next to each other horizontally. If the combined width of the blogposts exceeds the screen space, the blogposts will be displayed among themselves.

For this example we configured the "Blogpost macro" (1) the following way:

1	2

Insert the macro.

Note: The other settings are left at their default values.

4. (Optional) Create one more "Blogpost macro" and configure it the same way, except the labels. The the labels group has to be different from the other "Blogpost macro"s. This is important to prevent duplicated blogposts on the page.

Our second "Blogpost macro" is configured is configured as the second(2) seen above,

5. Save and publish the page with the "Blogpost macro"s.

6. The blogposts are now visible:

Allgemeines

Das Blog-Post-Makro ermöglicht es Ihnen, Blog-Posts in einer zentralen und anpassbaren Übersicht zu sammeln und anzuzeigen, indem Sie die Label-Funktion von Confluence verwenden.

Erstellen eines einfachen Blogposts

1. Als Erstes müssen sie eine leere Hauptseite zum anzeigen der Blogposts erstellen.

2. Das Blogpost Makro auf die Hauptseite hinzufügen

3. Konfigurieren des Blogpost Makros

Einstellung	Funktion
height	Bestimmt die Höhe der Blogposts. (Nummer)
width	Bestimmt die Breite der Blogpost Reihe. (Nummer)
maxelements	Bestimmt die maximale Anzahl an Blogposts in der Reihe. (Nummer)
list	Wenn angehakt: Zeigt die Blogs mit der Stichwörtergruppe in einer Liste untereinander anstatt in einem Blogpost.
showlabels	Wenn angehakt: Zeigt die labels der Blogpost Seiten auf dem Blogpost an.
showshortdesc	Wenn angehakt: Die Beschreibung wird unterhalb der Überschrift, dem Label und dem Bereich angezeigt.
showspace	Wenn angehakt: Zeig den Breich der Zielseite des Blogposts an.
labels	Bestimmt die Stichwörter Gruppe, zu welcher die Blogpost Zielseiten gehören müssen. Alle Seiten, welche zu dieser Stichwörter Gruppe gehören und einen Auszug enthalten werden als Blogpost angezeigt. (Wenn mehr Seiten in der Stichwörter Gruppe existieren als bei maxelements angegeben, werden die aktuellsten Blogs angezeigt.
datefieldstyle	Bestimmt die Hintergrundfarbe des Datumfeldes.
bigtitlefieldstyle	Bestimmt die Hintergrundfarbe des Überschriftfeldes.
descriptionfieldstyle	Bestimmt die Hintergrundfarbe des Beschreibungsfeldes.
opacity	Bestimmt die Sichtbarkeit des Blogposts. *******

Jedes "Blogpost macro" representiert eine Reihe an Blogposts. Um mehrere Reihen an Blogposts untereinander anzuzeigen müssen Sie für jede Reihe ein neues Makro einfügen.

Für dieses Beispiel werden hier folgende Einstellungen verwendet: height: 500; width: 800; maxelements: 1; list: no; showlabels: Ja; showshotdesc: Ja; showspace: Ja; labels: beispielBlogPost. Die restlichen Einstellungen werden auf ihrem Standard belassen.

4. Das Makro auf die Seite hinzufügen und die Seite veröffentlichen.