Dieser Shortcode erzeugt eine tabellarische Übersicht von Einsatzberichten aus einem oder mehreren Kalenderjahren. Gezeigt werden dabei standardmäßig die Einsatznummer, Datum und Uhrzeit des Alarms, sowie der verlinkte Titel des Einsatzberichts. Die Spalten und deren Reihenfolge kann in den Einstellungen geändert werden und ist für alle Vorkommen des Shortcodes gleich.

Der Shortcode kommt ohne zusätzliche Angaben aus, allerdings kann die Ausgabe durch die folgenden Parameter angepasst werden.

Zeitraum

Ohne weitere Angabe zeigt der Shortcode nur Einsatzberichte aus dem aktuellen Kalenderjahr an. Mit dem Parameter jahr kann der angezeigte Zeitraum wie folgt verändert werden:

  • vierstellige Jahreszahl, z.B. jahr=2013 → zeigt alle Einsätze aus 2013
  • negative Zahl, z.B. jahr=-3 → zeigt alle Einsätze der letzten 3 Jahre, beginnend mit dem aktuellen Jahr
  • jahr=* → zeigt alle gespeicherten Einsätze

Nach jedem Kalenderjahr wird eine neue Tabelle begonnen (Ausnahme: siehe Option compact).

Sortierung

Die Einsatzberichte werden standardmäßig in absteigender Reihenfolge angezeigt. Eine aufsteigende Sortierung wird durch die Angabe des Parameters sort=auf erreicht.

Trennung nach jedem Monat

Um auch innerhalb eines Kalenderjahres eine Trennung zwischen den einzelnen Monaten einzublenden, muss der Parameter monatetrennen=ja angegeben werden.

Anzahl der Einträge begrenzen

ab Version 1.2.0

Damit in der Übersicht nur eine begrenzte Anzahl an Einsatzberichten angezeigt wird, kann der Parameter limit verwendet werden. Beispielsweise limit=5 für maximal 5 Einsatzberichte.

Link zu den Einsatzberichten

ab Version 1.2.0

Da die Spalte mit dem Titel des Einsatzberichts kein zwingender Bestandteil der Einsatzliste ist, gibt es die Möglichkeit, den Link zum Einsatzbericht in anderen Spalten anzeigen zu lassen. Dazu wird im Parameter link eine Spalte oder mehrere Spalten mit Komma getrennt angegeben. Die folgenden Spaltenbezeichnungen sind dabei erlaubt:

  • number Die Einsatznummer
  • date Das Datum des Einsatzberichts
  • time Die Uhrzeit des Einsatzberichts
  • datetime Uhrzeit und Datum des Einsatzberichts
  • title Titel des Einsatzberichts
  • workforce Die Stärkemeldung des Einsatzberichts
  • duration Dauer des Einsatzes
  • seqNum Die laufende Nummer des Einsatzberichts

Wenn zum Beispiel der Titel und die laufende Nummer den Link zum Einsatzbericht bilden sollen, so lautet der Parameter link=title,seqNum.

Soll in keiner Spalte ein Link zum Einsatzbericht angezeigt werden, so ist der Parameter link=none zu verwenden. Die Einsatzberichte sind dadurch nur nicht verlinkt, aber trotzdem noch aufrufbar.

Verschiedene Optionen

ab Version 1.2.0

Für verschiedene Einstellungen gibt es den Parameter options, der eine oder mehrere durch Kommas getrennte Optionen übergeben bekommt. Es gibt folgende Optionen:

  • special Die Liste zeigt nur als besonders markierte Einsatzberichte an
  • noLinkWithoutContent Wenn ein Einsatzbericht keinen Beitragstext enthält, wird in der Einsatzliste kein Link dafür angezeigt
  • noHeading (ab Version 1.2.2) Die Überschrift „Einsätze <Jahr>“ wird unterdrückt
  • compact (ab Version 1.2.2) Alle Einsatzberichte werden in einer einzigen Tabelle dargestellt, auch wenn sich der Zeitraum über mehrere Jahre erstreckt. Empfiehlt sich bei wenigen Einsatzberichten, beispielsweise in Kombination mit special. Diese Option deaktiviert auch die Trennung zwischen den Monaten.

Beispiele

Einsätze aus dem Jahr 2012 in aufsteigender Reihenfolge, nach Monaten getrennt: [einsatzliste jahr=2012 sort=auf monatetrennen=ja]
Die neuesten 10 Einsatzberichte des aktuellen Jahres in absteigender Reihenfolge: [einsatzliste limit=10]
Alle besonderen Einsätze in einer einzigen Tabelle [einsatzliste jahr=* options=special,compact]

Beim Kopieren der Beispiele in den WordPress-Editor wird die Formatierung (Schreibmaschinenschrift) übernommen. Das kann sich allerdings störend auf den Shortcode auswirken. Deshalb sollte der Editor vor dem Einfügen von Visuell auf Text umgeschaltet werden.