Templates – Einsatzverwaltung

Mit Templates kann das Aussehen verschiedener Elemente nach eigenen Wünschen gestaltet werden. Das ist zum einen bei einem der Widgets möglich, ebenso kann die Einzelansicht von Einsatzberichten angepasst werden. Sofern das verwendete Theme Auszüge (separater Text zur Vorschau in Übersichten, auch Textauszug oder Exzerpt genannt) unterstützt, kann auch hier ein Template verwendet werden.

Ein Template ist dabei ein Stück Text, das mit Platzhaltern versehen ist. Diese Platzhalter werden bei der Anzeige mit den Angaben des jeweiligen Einsatzberichts ersetzt. Die Templates können mit HTML-Code versehen werden und unterstützen auch Shortcodes.

Eingetragen werden die Templates unter Einstellungen → Einsatzverwaltung → Einsatzberichte.

Platzhalter

Daten aus einem Einsatzbericht

Folgende Platzhalter beziehen sich auf einen einzelnen Einsatzbericht:

%title% Titel des Einsatzberichts
%date% Datum der Alarmierung
%time% Zeitpunkt der Alarmierung
%endTime% Datum und Uhrzeit des Einsatzendes
%content% Der Beitragstext des Einsatzberichts
%location% Ort des Einsatzes
%duration% Dauer des Einsatzes
%incidentType% Art des Einsatzes
%incidentTypeHierarchical% Art des Einsatzes (ggf. mit übergeordneten Einsatzarten)
%incidentTypeColor% Farbe der Art des Einsatzes
%vehicles% Auflistung der Fahrzeuge
%vehiclesByUnit% Auflistung der Fahrzeuge, gruppiert nach Einheit
%additionalForces% Ausflistung der weiteren am Einsatz beteiligten Kräfte
%typesOfAlerting% Auflistung der Alarmierungsarten
%url% URL zum Einsatzbericht
%number% Einsatznummer
%seqNum% Laufende Nummer
%annotations% Vermerke
%featuredImage% Beitragsbild, sofern vorhanden und das Theme post-thumbnails unterstützt
%featuredImageThumbnail% Beitragsbild in Vorschaugröße, sofern vorhanden
%yearArchive% URL zum Jahresarchiv (bezogen auf das Kalenderjahr des aktuellen Einsatzes)
%workforce% Mannschaftsstärke
%incidentCommander% Einsatzleiter
%units% Beteiligte Einheiten

Allgemeine Platzhalter

Folgende Platzhalter sind unabhängig von einem Einsatzbericht:

%feedUrl% URL zum Feed mit den neuesten Einsatzberichten
%yearArchive% URL zum Jahresarchiv des aktuellen Jahres

Hinweise

Der Platzhalter %incidentTypeColor% ist für die Verwendung in CSS-Anweisungen (z.B. color oder background-color) gedacht. Sollte kein Farbwert gefunden werden, wird der Platzhalter mit inherit gefüllt.
%annotations% sollte mit einem Container wie p, div oder span umschlossen werden
Derzeit gibt es keine Elemente für bedingte Anweisungen oder Verzweigungen (z. B. um nicht ausgefüllte Angaben komplett auszublenden)

Beispiele

Einzelansicht von Einsatzberichten

Um die klassische Einzelansicht eines Einsatzberichts nachzubauen und anzupassen, kann das folgende Template als Einstieg benutzt werden.

<p>
	<b>Datum:</b> %date%<br>
	<b>Alarmzeit:</b> %time% Uhr<br>
	<b>Alarmierungsart:</b> %typesOfAlerting%<br>
	<b>Art:</b> %incidentType%<br>
	<b>Einsatzort:</b> %location%<br>
	<b>Mannschaftsstärke:</b> %workforce%<br>
	<b>Fahrzeuge:</b> %vehicles%<br>
	<b>Weitere Kräfte:</b> %additionalForces%
</p>
<hr>
<h2>Einsatzbericht:</h2>
%content%

Widget

Dieses Template kann als Vorlage für das Widget verwendet werden. Dabei wird im Feld HTML-Code vor den Einsatzberichten <ul> eingetragen, im Feld HTML-Code nach den Einsatzberichten </ul>.

HTML-Template pro Einsatzbericht:

<li>
  <a href="%url%" rel="bookmark">%title%</a><br>
  <span>%date%</span> &#124; <span>%time%&nbsp;Uhr</span><br>
  <span>Ort:&nbsp;%location%</span>
</li>

Das Widget lässt sich am Besten über den Customizer von WordPress bearbeiten, da dort direkt eine Live-Vorschau generiert wird.

Farbe für Einsatzart

Die Einsatzart entsprechend der Einstellungen einzufärben, könnte folgendermaßen gelöst werden:

Art: <span style="color: %incidentTypeColor%">%incidentType%</span>

Changelog

Version	Bemerkung
1.1.0	Template für Widget eingeführt
1.2.2	Platzhalter `%seqNum%` hinzugefügt
1.3.2	Platzhalter `%annotations%` hinzugefügt
1.4.0	Layout von Einsatzbericht und Auszug per Template; Platzhalter `%incidentTypeColor%`, `%vehicles%`, `%additionalForces%`, `%typesOfAlerting%`, `%content%`, `%featuredImage%` und `%yearArchive%` hinzugefügt
1.4.2	Platzhalter `%workforce%` hinzugefügt
1.5.0	Platzhalter `%incidentCommander%` hinzugefügt
1.6.0	Platzhalter `%incidentTypeHierarchical%` und `%units%` hinzugefügt, Shortcodes werden unterstützt
1.7.0	Platzhalter `%endTime%` hinzugefügt, der Platzhalter `%yearArchive%` kann auch außerhalb von Einsatzberichten verwendet werden
1.8.0	Platzhalter `%featuredImageThumbnail%` hinzugefügt
1.9.0	Platzhalter `%vehiclesByUnit%` hinzugefügt