new confluence plugins from bitvoodoo at atlassian user conference
TRANSCRIPT
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 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 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 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 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/