Wofür ist die Extension gedacht?

Die Extension wurde entwickelt um Feuerwehreinsätze in TYPO3 Webseiten zu verwalten. Ganz ursprünglich hat die Freiwillige Feuerwehr der Stadt Thale, vor langer Zeit, diese Extension von mir in einer TYPO3 Website bekommen. Mittlerweile kümmert sich da jemand anderes und dieser Jemand findet halt Wordpress ganz toll. Naja, was soll man dazu sagen ;-). Wenn's denn glücklich macht, gerne. Die Downloadzahlen der Extension lassen aber auch darauf schließen, dass es noch andere TYPO3 Seiten gibt welche die Extension nutzen. Das aber nur am Rande.

Die Daten werden hier im TYPO3 Backend von einem Redakteur über eine spezielle Oberfläche eingegeben. Viele einzelne Informationen können so angegeben werden.

Benutzte Fahrzeuge, Hilfsmittel, Unterstützung von anderen Einsatzkräften (Polizei, Feuerwehr, THW etc.) kann man einmal anlegen und dann in den Einsatzberichten leicht wiederverwenden.

Natürlich kann man diese Extension auch für andere Einrichtungen nutzen. Beispielsweise Polizei, Sicherheitsagenturen oder das THW könnten hiermit auch Berichte von vergangenen Einsätzen abbilden.

Im Frontend sind verschiedene Darstellungen möglich.

Frontend Screenshots

Hier sind einige Screenshots der Ansichten im Frontend. Das Aussehen wird durch das Site Package der Extension fire department bestimmt, welche für die Fluid Templates in operations optimiert sind. Damit habt ihr die Extension operations sofort einsatzfähig.

Liste der Einsätze im Frontend mit Filter und Blätternavigation

Frontend Detailansicht für einen Einsatz

Frontend Listenansicht für Hilfsmitteln

Frontend Listenansicht für Fahrzeuge

Frontend Ansicht der Statistiken, gruppiert nach Typ und Jahr

Backend Screenshots

Hier sind ein paar Beispiele der Datensätze im Backend mit zugehöriger Einsatzart, Hilfsmittel, Fahrzeugen oder Unterstützung. Die einzelnen Datentypen sind durch individuelle Icons gekennzeichnet.

Liste von Einsatzdaten im Backend

List der Einsatzarten im Backend

Liste der Hilfsmittel im Backend

Liste der Fahrzeuge im Backend

Liste der Datensätze für Unterstützung

Issue Tracker auf Github

Hier operations auf Github könnt ihr ein Ticket erstellen und euer Problem schildern.

Slack

Am schnellsten bekommt ihr wahrscheinlich Hilfe auf Slack. Es gibt einen Slack Channel, dort könnt ihr Hilfe von anderen Usern oder auch von mir bekommen.

Die Web Adresse ist: https://typo3.slack.com/messages/ext-operations/

Wenn ihr Slack bereits auf dem Rechner habt, geht einfach in den Slack Channel ext-operations vom TYPO3 Workspace.

Sponsoring

Falls ihr ein Feature benötigt welches noch nicht implementiert ist, schreibt mir einfach eine Mail. Dann sehen wir weiter.

Pfade in den TypoScript Konstanten anpassen

Hier ein Beispiel TypoScript um im Feld Konstanten die Pfade zu ändern:

plugin.tx_operations {
        view {
                templateRootPath = EXT:your_site_package/Resources/Private/Extensions/operations/Templates/
                partialRootPath = EXT:your_site_package/Resources/Private/Extensions/operations/Partials/
                layoutRootPath = EXT:your_site_package/Resources/Private/Extensions/operations/Layouts/
        }
}

Statisches TypoScript einbinden

Die Extension bringt eine TypoScript Konfiguration mit. Damit euer TYPO3 die Einstellungen auch kennt, müsst ihr das TypoScript einbinden. TypoScript könnt ihr auf verschiedene Arten einbinden. Die empfohlene Variante für die Einbindung von TypoScript aus Extensions ist in einem Site Package. Wie das geht ist hier beschrieben: TypoScript von Extensions im Site Package

Ein anderer möglicher Weg, so wurde das früher einmal gemacht, ist die Einbindung im Root-TS Template in der Datenbank eurer Seite. Dazu wären die folgenden Schritte nötig:

1. Wählt im Seitenbaum die Seite auf der sich euer Root-TS Template befindet
2. Wechselt links bei den Modulen auf das Modul Template und wählt dann oberhalb im Dropdown Info/Bearbeiten aus
3. Über den Button Vollständigen Template-Datensatz bearbeiten kommt ihr in die Bearbeitungsmaske für den Template-Datensatz. Dort müsst ihr zum Reiter Enthält wechseln, wenn ihr da nicht schon seid
4. Jetzt könnt ihr bei dem Feld Statische Templates einschließen (aus Erweiterungen) in der rechten Box Operations (operations) auswählen

Nutzung vom Constant Editor

Wenn ihr das TypoScript der Extension eingefügt habt, gibt es einige Einstellungen in dem TYPO3 Konstanten Editor. Die meisten wichtigen Einstellungen können hir vorgenommen werden.

plugin.tx_operations {
  # Hier die Uid von eurem Sys-Ordner mit den Einsatzdaten im Backend angeben
  persistence.storagePid = 45
  settings {
    # Hier die Uid der Einzelansichtsseite für die Einsätze angeben
    operationSinglePid =
    # Hier die Uid der Einzelansichtsseite der Fahrzeuge angeben
    vehicleSinglePid =
    # Hier die Uid der Einzelansichtsseite der Hilfsmittel angeben
    resourceSinglePid =
  }
}

Komplette Liste der TypoScript Einstellungen

Ihr könnt euch alle verfügbaren TypoScript Einstellungen in folgender Datei anschauen:

Configuration/TypoScript/setup.typoscript

Die Einstellungen fangen hier an:

plugin.tx_operations {
   settings {
      …
   }
}

Die verschiedenen Inhaltstypen

Einsatzstatistik(en) anzeigen

Erstellt einfach ein neues Inhaltselement vom Typ "Einstzverwaltung Statistiken". Wenn ihr wollt, könnt ihr noch eine Kategorieauswahl vornehmen und ihr solltet die Anzahl der zurückliegenden Jahre einstellen. Ich gehe davon aus, dass die Einstellungen für den SysOrdner mit den Einsatzdaten im TypoScript bereits gesetzt wurde. Wenn nicht, müsste ihr das natürlich auch noch im Plugin einstellen.

Das Plugin zeigt euch im Frontend eine Statistik der Einsätze gruppiert nach Jahr und Typ.

Die Einstellung "letzte Jahre" legt fest, wieviele Jahre rückwirkend für die Statistik genutzt werden sollen. Es ist die gleiche Einstellung wie bei der normalen Listenansicht. Jahre in denen keine Einsätze stattfanden, werden ignoriert und nicht mit ausgegeben.

JavaScript für Statistiken anpassen

Wenn ihr die Statistiken anpassen wollt, könnt ihr das mit einem eigenen JavaScript machen. Kopiert dazu die Templatedatei Resources/Private/Templates/Operation/Statistics.html an einen Ort eurer Wahl und passt den Pfad für das JavaScript hier an:

<f:section name="FooterAssets">
    <!-- chart library -->
    <script src="{f:uri.resource(path: 'Js/Chart.bundle.js')}"></script>
    <!-- change path to your own js file if you need -->
    <script src="{f:uri.resource(path: 'Js/MyChart.js')}"></script>
</f:section>

Am besten nutzt ihr dafür ein eigenes Site Package / Theme Extension.

Ändert dann die Templatepfade wie hier beschrieben Templates .

Kategorien nutzen

Ihr könnt Kategorien nutzen um die Einsatzdaten zu strukturieren. Damit lassen sich Dinge wie: Haupt-Feuerwehrwache und Unter-Feuerwehrwachen abbilden. Durch die Auswahl der verschiedenen Kategorien im Plugin könnt ihr die Ausgabe im Frontend für die Liste oder die Statistiken entsprechend einschränken.

Wenn ihr keine Kategorien braucht, dann ignoriert sie einfach.

Definition für eure Site Configuration

Schöne und lesbare Url's werden in TYPO3 mit Hilfe von sogenannten "Route Enhancern" konfiguriert. Eine Beschreibung dieser Funktionalität findet ihr hier: Advanced routing configuration.

Mehr Information zum Url Routing von TYPO3: Speaking Urls

Information zur Nutzung der Site Configuration in TYPO3: Sitehandling

Damit werden auch die schönen/lesbaren Url's für die Einzelansichten der Einsätze, Fahrzeuge und Hilfsmittel gebaut. Diese Konfiguration muss dazu in eurer "Site Configuration" eingefügt werden.

Nachfolgend findet ihr ein Beispiel für eine solche Konfiguration, wie ich sie in meiner Testumgebung einsetze. Damit bekommt ihr lesbare Url's für die Einzelansichten, sowie die Seiten/Blätternavigation bei längeren Listen.

routeEnhancers:
  OperationsPlugin:
    # set `limitToPages:` for route enhancer directly in your site config
    type: Extbase
    extension: Operations
    plugin: List
    routes:
      -
        routePath: '/{localized_page}-{page}'
        _controller: 'Operation::list'
        _arguments:
          page: currentPage
      -
        routePath: '/{operation_title}'
        _controller: 'Operation::show'
        _arguments:
          operation_title: operation
      -
        routePath: '/{vehicle_title}'
        _controller: 'Vehicle::show'
        _arguments:
          vehicle_title: vehicle
      -
        routePath: '/{resource_title}'
        _controller: 'Resource::show'
        _arguments:
          resource_title: resource

    defaultController: 'Operation::list'
    defaults:
      page: '1'
    requirements:
      page: \d+
    aspects:
      page:
        type: StaticRangeMapper
        start: '1'
        end: '200'
      operation_title:
        type: PersistedAliasMapper
        tableName: tx_operations_domain_model_operation
        routeFieldName: path_segment
      vehicle_title:
        type: PersistedAliasMapper
        tableName: tx_operations_domain_model_vehicle
        routeFieldName: path_segment
      resource_title:
        type: PersistedAliasMapper
        tableName: tx_operations_domain_model_resource
        routeFieldName: path_segment
      localized_page:
        type: LocaleModifier
        default: 'page'
        localeMap:
          - locale: 'de_DE.*'
            value: 'seite'

Dieses Beispiel findet ihr auch in der TYPO3 Extension fire_department im Ordner: Configuration/Yaml/Routes/Operations.yaml. Das könnt ihr dann einfach mit einem @import in eure "Site Configuration" einbauen und dann noch die Einstellung für limitToPages setzen.

imports:
  - { resource: "EXT:fire_department/Configuration/Yaml/Routes/Operations.yaml" }
routeEnhancers:
  OperationsPlugin:
    limitToPages: [5,7,9]

Update to 8.0.0

Diese Version bringt TYPO3 12 Kompatibilität mit und behält die Kompatibilität zu TYPO3 11. operations läuft aktuell also mit beiden LTS Versionen von TYPO3.

Die feste Abhängigkeit zu Georg Ringers numbered_pagination wurde aufgelöst, da es zum aktuellen Zeitpunkt der Entwicklung noch keine 12er kompatible Version davon gab. Wird es vielleicht auch gar nicht geben, da der TYPO3 Kern mittlerweile eine eigene Lösung mitbringt. Für TYPO3 11 Installationen bedeutet dies, dass man selbst darauf achten muss, dass die Extension numbered_pagination installiert ist. operations wählt abhängig von der TYPO3 Version entweder die NumberedPagination Klasse (wenn vorhanden) oder die neuere SlidingWindowPagination aus. Wenn keins von beiden verfügbar ist, wird dann die SimplePagination genutzt. Im TypoScript gibt es die Möglichkeit diese genutzte Klasse zu überschreiben und eine andere Klasse für die Paginierung zu verwenden.

plugin.tx_operations {
   settings {
      paginate {
         class = Vendor/YourOwn/PaginationClass
      }
   }
}

Update to 7.1.0

• Vor dem Update gab es immer ein Limit bei den Einsatzdaten. Auch für die Statistiken. Das ist da aber eher nicht sinnvoll. Jetzt gibt es erstmal kein Limit für die Statistikdaten. Ihr könnte das aber deaktivieren um das alte Verhalten wieder zu haben. Deaktiviert das einfach mit dem TypoScript setting noLimitForStatistics = 0.
• Die Extension "numbered_pagination" von Georg Ringer wird jetzt für die Paginierung der Liste verwendet. Die ist komfortabler und zeigt nicht immer alle Seiten an sondern nur einen bestimmten Teil. Schaut ins TypoScript und nach euren Fluid Templates/Partials für die Änderungen. Die Extension wird bei Composer basierten Installationen einfach mit installiert. Bei nicht Composer basierten Installationen müsst ihr die Extension extra installieren.
• Die Farbe bei der Einsatzart ist nun bei Übersetzungen ausgenommen. Damit ist es nicht mehr notwendig die Farbe extra bei der Übersetzung anzugeben.

Update auf 7.0.0

Diese Version läuft nur noch unter TYPO3 11. In dieser Version wurden ein paar kleine Bugs behoben und auf verschiedene neue TYPO3 11 Features umgestellt.

settings:
 operations:
   rootCategory: 2

Update to 6.x

In dieser Version wurden kleine und große Fehler behoben und Wartungsarbeiten vorgenommen.

Achtung, Breaking Change! Neue Pagination API von TYPO3 wird benutzt. Die alte Fluid Widget Pagination wurde entfernt.

Das TypoScript Setting maxNumberOfLinks wird nicht länger benutzt und daher ebenfalls entfernt. Wenn ihr die Standard Templates von operations benutzt, solltet ihr nichts weiter tun müssen. Wenn nicht, prüft bitte eure ausgelagerten Templates und führt die Änderungen nach. Folgende Dateien müsst ihr prüfen:

• Resources/Private/Templates/Operation/List.html
• Resources/Private/Templates/Operation/Search.html
• Resources/Private/Partials/List/Pagination.html

Falls ihr die Ausgabe der aktuellen Seite der PAgination in der Url konfiguroert habt müsst ihr diese anpassen. Das alte @widget Zeug wird nicht mehr genutzt. Schaut einfach mal auf die Beispielkonfiguration für schöne Url's.

Das Verhalten bei der Überprüfung der path_segment Felder (slug) wurde umgestellt auf unique. Damit kann man jetzt den Sysordner mit den Daten auch außerhalb seiner Root-Seite haben. Die Einzelansicht funktioniert damit jetzt auch. Installationen mit mehreren Seiten die sich einen solchen Sysordner teilen hatten bisher ein Problem. Mit einer aktuellen TYPO3 Version sollte das jetzt alles laufen. Falls ihr jedoch den anderen Fall braucht, könnt ihr das in der Extension Konfiguration im BE Modul Einstellungen ändern.

Update to 5.1.0

Fehlerbehebung für eine Exception in der List Ansicht in TYPO3 10 auf.

Die Übersetzungen der Einsätze im Backend zeigen jetzt nur die für eine Übersetzung notwendigen Felder an. Kategorien, Hilfsmittel, Fahrzeuge, Unterstützung, Koordinaten, Typ, Einsatzleitdienst sind nicht sprachabhängig.

Natürlich können die Datensätze für Kategorien, Hilfsmittel, Fahrzeuge, Unterstützung und Typ selbst weiterhin übersetzt werden. Je nachdem wie die Einstellungen für sys_language_mode und sys_language_overlay gesetzt sind, gibt es einen Fallback falls keine Überstezung für die aktueller Sprache existiert.

fallbackType: strict
fallbacks: '0,1'

Update to 5.0.0

TYPO3 10 Kompatibilität.

Update to 4.0.0

Komplettumbau der Template Dateien um das Site-Package fire department ganz einfach zu nutzen. Damit kann man jetzt einfach Standard-Styles verwenden.

Update auf 3.2.2

Behebt einen Fehler wenn Concatenation für JS und CSS Dateien im TYPO3 aktiviert ist.

Update auf 3.2.0

tx_operations {
    categoryRootId = 4
}

Update auf 3.1.0

Kleinere Fehlerbehebungen. Neuer Plugintyp für Statistiken Anzeige im Frontend.

Update auf 3.0.0

plugin.tx_operations {
    persistence {
        storagePid = 99
        recursive = 2
    }
}

settings.listImgWidth -> settings.listMediaWidth
settings.showImgInList -> settings.showMediaInList

UPDATE tx_operations_domain_model_operation LEFT JOIN sys_file_reference ON sys_file_reference.uid_foreign=tx_operations_domain_model_operation.uid AND sys_file_reference.tablenames='tx_operations_domain_model_operation' AND sys_file_reference.fieldname='image' SET tx_operations_domain_model_operation.media=tx_operations_domain_model_operation.image, tx_operations_domain_model_operation.image=0, sys_file_reference.fieldname='media' WHERE tx_operations_domain_model_operation.image > 0;

UPDATE tx_operations_domain_model_vehicle LEFT JOIN sys_file_reference ON sys_file_reference.uid_foreign=tx_operations_domain_model_vehicle.uid AND sys_file_reference.tablenames='tx_operations_domain_model_vehicle' AND sys_file_reference.fieldname='image' SET tx_operations_domain_model_vehicle.media=tx_operations_domain_model_vehicle.image, tx_operations_domain_model_vehicle.image=0, sys_file_reference.fieldname='media' WHERE tx_operations_domain_model_vehicle.image > 0;

UPDATE tx_operations_domain_model_resource LEFT JOIN sys_file_reference ON sys_file_reference.uid_foreign=tx_operations_domain_model_resource.uid AND sys_file_reference.tablenames='tx_operations_domain_model_resource' AND sys_file_reference.fieldname='image' SET tx_operations_domain_model_resource.media=tx_operations_domain_model_resource.image, tx_operations_domain_model_resource.image=0, sys_file_reference.fieldname='media' WHERE tx_operations_domain_model_resource.image > 0;

Ausführliche Liste mit Hilfe des Git-Logs

Klont das Github Repository von 'operations' und nutzt das folgende Kommando um eine Lsite der Commits zu bekommen. Ersetzt die Versionsnummer in dem Beispiel mit der Nummer der Version die ihr momentan benutzt.

git log 2.0.2..HEAD --abbrev-commit --pretty='%ad %s (Commit %h by %an)' --date=short

Wenn ihr das Wort HEAD mit einer Versionsnummer ersetzt, könnt ihr die Commits zwischen zwei Versionen anzeigen lassen.