Neben den mit Redmine standardmässig ausgelieferten Makros kann man durch installierte Plugins auch Makros von Drittanbietern in der Wiki und / oder dem Ticketbereich anwenden. Durch den Einsatz von Makros wertet man den Dokumentationsbereich nicht nur optisch auf, sondern liefert (abhängig vom Makro) seinen Anwendern einen gewissen Mehrwert an Informationen. In unserem Artikel stellen wir das Google Maps Makro des Redmine Additionals Plugins kurz vor.
Mit Makros die Redmine Projektwiki aufwerten
Das neuste Update des Additionals Plugin liefert unter anderem ein neues Makro zur Einbindung einer Google Maps (Google Maps API Key notwendig). Wer eine Google Maps Karte in seine Redmine Wiki oder ein Ticket implementieren will kann durch das Additionals Plugin auf diese Funktion zugreifen.
Alles was ihr nach erfolgreicher Plugin-Installation braucht ist ein Google Maps API Key entsprechend eurem Einsatzzweck. Dieser wird in den Plugin-Einstellungen unter Additionals -> Web APIs ins Feld Googel Maps Embed API Key eingetragen werden. Das Makro funktioniert erst nachdem der API Key hinterlegt worden ist. Solltet ihr ein Makro irgendwo verwenden und nicht (mehr) die gewünschte Karte angezeigt bekommen, dann überprüft bitte die Plugin-Einstellungen in diesem Bereich.
Makro Optionen für Google Maps Karte
Der API Key ist implementiert? Dann könnt ihr auch gleich los legen. Die Makroparamter sind realtiv simpel.
{{gmap([q=QUERY, mode=MODE, width=WIDTH, height=HEIGHT])}}
Verfügbare Parameter
- q (string) – query, z.B. Ort oder Location
- mode (string) – place, directions, search, view oder streetview (Default: search)
- width (int) – Breite des Widgets
- height (int) – Höhe des Widgets
- avoid (string) - z.B. tolls, ferries oder highways
- language (string) - z.B. DE, EN (Default: english)
- waypoints (string) - Ort oder Location
Beispiele
Wer lediglich einen Ort (z.B. München) auf der Karte anzeigen will verwendet das Makro folgendermassen:
{{gmap(Munich)}}
Oder mit konkreter Location Angabe wie folgt:
{{gmap(p=Marienplatz,Munich+Germany, language=DE)}}
oder per Adresseingabe so:
{{gmap(p=Bavariafilmpatz+3,Grünwald+Germany)}}
Wer eine Route von einem Ort zum anderen ausgeben möchte setzt das Makro so ein:
{{gmap(mode=directions, origin=Munich+Rosenheimerstr, destination=Arco+Italy)}}
Man erhält dann die Routenansicht von der Implerstraße in München nach Arco in Italien. 
Möchte man auch gebührenpflichtige Straßen oder Autobahnen auf der Route vermeiden verwendet man den parameter “avoid”. Um die Info in DE auszugeben den entsprechenden Länderparameter. Das sieht dann so aus:
{{gmap(mode=directions, language=DE, origin=Munich+Rosenheimerstr, destination=Arco+Italy, avoid=tolls|highways)}}
Probiert es am Besten selbst einmal aus. Wir finden dass es sich um eine ganz nützliche Funktion handelt. Die Routenansicht ist beispielsweise für Fahrten mit dem Firmenwagen interessant. Für Außendienstmitarbeiter um die Strecke zu einem Kunden festzuhalten. Oder um bei der Planung von Veranstaltungen Vorschläge für diverse Locations fest zu halten.
Redmine Additionals Plugin
Redmine ist ein Open Source basiertes Projekt- und Aufgabenmanagement Tool für kleine oder große Teams. Es ist über den Browser aufrufbar und stellt eine zentrale Anlaufstelle für alle Aktivitäten innerhalb eines Projekts dar. Deswegen ist es bei Unternehmen und Freiberuflern beliebt, die bevorzugt auf Open Source Lösungen setzen.
Das Redmine Additionals Plugin ist eine kostenlose Funktionserweiterung für Redmine. Es bietet zahlreiche Möglichkeiten seine Redmine Installation etwas benutzerfreundlicher zu gestalten und auch ohne Entwicklerkenntnisse kleine Anpassungen durchzuführen. Es ist beispielsweise möglich eigene Menüpunkte als auch eigene Texte in verschiedenen Bereichen zu definieren. Zusätzlich stellt es auch zahlreiche Makros für Wiki und Tickets bereit, die in herkömmlichen Projekten unverzichtbar sind. Eine vollständige Dokumentation der Funktionen ist in Englisch verfügbar. Das multilinguale Plugin kann auf Github herunter geladen werden. Dort befindet sich auch eine Installationsanleitung dir ihr auf jeden Fall lesen solltet. Das hier vorgestellte Makro ist ein Feature der neu verfügbaren Additionals Version v2.0.5.