17.06.09 1

Plugins of the Conference

Veröffentlichung von zwei freien open source Plugins anlässlich der Konferenz:1st UserConference 2009 in Düsseldorf.

17.06.09 2

Agenda

● panelbox Plugin● navitabs Plugin● Download / Dokumentation● Fragen

17.06.09 3

panelbox Plugin● Wie werden Panels in Confluence erstellt?

{panel:title=Wisdom}Life is something that everyone should try at least once.{panel}

{panel:title=Wisdom|borderStyle=dotted}Life is something that everyone should try at least once.{panel}

{panel:title=Wisdom|borderStyle=dotted|borderWidth=4px}Life is something that everyone should try at least once.{panel}

{panel:title=Wisdom|borderStyle=dotted|borderWidth=4px|borderColor=#990000}Life is something that everyone should try at least once.{panel}

{panel:title=Wisdom|borderStyle=dotted|borderWidth=4px|borderColor=#990000|titleBGColor=#FFCB04}Life is something that everyone should try at least once.{panel}

{panel:title=Wisdom|borderStyle=dotted|borderWidth=4px|borderColor=#990000|titleBGColor=#FFCB04|bgColor=#AAA}Life is something that everyone should try at least once.{panel}

17.06.09 4

panelbox Plugin● Probleme:● User muss sich viele Parameter (Farbe, Style,

Syntax) für ein Panel merken.● Konsistenz / Einheitlichkeit aller Panels einer

Confluence-Instanz ist nur sehr schwer durchzuziehen.

● Wenn der Style eines Panels geändert wird, müssen ggf. hunderte von Seiten editiert werden.

● Wiki-Syntax im Titel, z.B. für einen Link, ist nicht möglich.

17.06.09 5

panelbox Plugin● Wie werden Panelboxen mit dem panelbox

Plugin erstellt?

{box:gelb1|Follow this [link|http://en.wikipedia.org/wiki/Wisdom] to Wisdom}I'm in shape. Round is a shape, isn't it?{box}

17.06.09 6

panelbox Configuration● panelbox Configuration

17.06.09 7

panelbox Plugin● Vorteile:

● User muss sich nur den Namen einer panelbox-Konfiguration merken.

● Konsistenz / Einheitlichkeit ist garantiert, da der User “nur” eine beschränkte Anzahl von vordefinierten panelboxen zur Verfügung hat.

● Änderungen an einer panelbox-Konfiguration wirken sich sofort in der ganzen Confluence-Instanz aus, keine einzige Seite muss editiert wereden.

● Wiki-Syntax ist auch im Titel möglich.

17.06.09 8

panelbox Plugin

Demo

17.06.09 9

navitabs Plugin

...the tabs are gone... / Menü-Tabs in Confluence (live)

Tabs sind als Menüstruktur sehr gut geeignet

Confluence Tabs sollten auch individuell definiert und auf normalen Seiten angewandt werden können

Composition/Decks Plugin lädt gesamten Content auf einen Schlag

Composition/Decks Plugin ist bei umfangreichen Menüs/Inhalten unübersichtlich

Composition/Decks Plugin verwendet nicht die “richtigen” confluence-tabs

17.06.09 10

navitabs Plugin

Die Lösung: navitabs plugin5 Arten, Tabs zu definieren:

Tabs mit einem Attachment-File frei definierenTabs der Parent-/Children-Seiten zeichnenTabs aufgrund eines Labels (im gleichen/allen

Spaces) zeichnenTabs aufgrund eines Prefixes im Seitentitel

zeichnenAdvanced: Tabs anpassen mit Config-File:

Reihenfolge, Name, Anzeige (Ja/Nein)Tab-Name dynamisch rendern

17.06.09 11

Attachment Mode (freie Definition)

Attachment-File (customtabs.txt)

Attachment-Mode|http://www.bitvoodoo.ch/confluence/display/navitabs/Attachment-Mode

Fishes|http://www.bitvoodoo.ch/confluence/display/navitabs/Fish

Ball-fish|http://www.bitvoodoo.ch/confluence/display/navitabs/Fish.Ball-fish

Bone-fish|http://www.bitvoodoo.ch/confluence/display/navitabs/Fish.Bone-fish

Bush-fish|http://www.bitvoodoo.ch/confluence/display/navitabs/Fish.Bush-fish

Fight-fish|http://www.bitvoodoo.ch/confluence/display/navitabs/Fish.Fight-fish

More information about animals|http://www.world-of-animals.com/

Code-Beispiele

{navitabs:attachment=^customtabs.txt}

17.06.09 12

Parent-/Children ModeSeiten

All fishes

bone-fish

big freshwater-needle

little one freshwater-needle

sea-needle

bush-fish

Code-Beispiele {navitabs:searchkey=navitabs:All fishes}

{navitabs:searchkey=:bone-fish|first=Overview}

17.06.09 13

Labels ModeSeiten / Labels

All birds (Labels: bird ) penguins (Labels: penguin bird )

All fishes (Labels: fish ) bone-fish (Labels: fish bonefish ) big freshwater-needle (Labels: bonefish ) little one freshwater-needle (Labels: bonefish ) sea-needle (Labels: bonefish ) bush-fish (Labels: fish bushfish )

Code-Beispiele{navitabs:labels=fish}

{navitabs:labels=fish,bird}

17.06.09 14

Prefix Mode (String/Number)Seiten

BirdBird.Albatrosse

Bird.Albatrosse.black-brow-albatrossBird.Albatrosse.king-albatrossBird.Albatrosse.Laysan-AlbatrosBird.Albatrosse.soot-albatrossBird.Albatrosse.traveling-albatross

Code-Beispiele{navitabs:searchkey=Bird.Albatrosse.}

{navitabs:searchkey=Bird.Albatrosse}, {navitabs:searchkey=2}

{navitabs:searchkey=Bird.Albatrosse|first=Overview},{navitabs:searchkey=2|first=Overview}

17.06.09 15

Advanced Parameters...unzählige Parameter/Möglichkeiten

Attachment-File bei Children-/Label-/Präfix-Mode:Tab-Name individuell festlegen (geht durch Wiki-Engine), daher auch

“dynamische” Tabnamen möglich, Fileformat/-syntax:[originalTab1]{color:blue}neuerBlauerTab{color}[originalTab2]{sql:datasource=...}select...from...{sql}

Tabs ein-/ausblenden

Reihenfolge der Tabs festlegen

URL-Parameter / “virtual pages”Mehrere Ansichten auf einer Seite durch Attachment Mode mit URL-

Parameter in den Links, Beispielfile:Übersicht|http://...../confluence/pages/viewpage.action?pageId=123Einkauf|http://...../confluence/pages/viewpage.action?pageId=123&type=1Produkte|http://...../confluence/pages/viewpage.action?pageId=123&type=2Verkauf|http://...../confluence/pages/viewpage.action?pageId=123&type=3

Coming soon: vertical=true

17.06.09 16

navitabs plugin

Demo

17.06.09 17

Download / DokumentationWeitere Informationen zu...● Ausführliche Dokumentation● Verschiedene Muster- und Anwendungsbeispiele● Download jar-Files / Source-Files● Issue Tracking

... sind zu finden über:● http://www.bitvoodoo.ch “Plugin-Ressources”

“Plugin panelbox”bzw.“Plugin navitab”

oder direkt:● http://www.bitvoodoo.ch/confluence/display/panelbox/

bzw.● http://www.bitvoodoo.ch/confluence/display/navitabs/

17.06.09 18

Fragen

Fragen

Kontakt:Thomas Wendel

thomas.wendel@bitvoodoo.ch

Philipp Klauserphilipp.klauser@bitvoodoo.ch