Label, Suchen & Filtern

Sobald du deine Installation erfolgreich mit dem Contao Manager verbunden hast, wird dir die Contao- und PHP-Version als Label ausgegeben. Wenn du z. B. verschieden Versionen von Contao 4.13 hast, wird zusätzlich ein Standardfilter für die Minor-Versionen angelegt. So kannst du beispielsweise mit nur einem Klick alle 4.13er-Versionen filtern. Es gibt auch noch ein Label «Manager» für alle mit dem Contao Manager verbunden Installationen und ein Label «Monitoring» für alle überwachten Installationen. Ausserdem wird ein Filter für die installierten Pakete hinzugefügt.

Es gibt zwei Möglichkeiten, Labels für eine Installation hinzuzufügen. Zum einen direkt beim Hinzufügen einer neuen Installation und zum anderen jederzeit in der Detailansicht der Installation.

Du kannst Labels auch gruppieren. Dazu verwendest du zur Trennung der Gruppe und des Labels einen «Doppelpunkt». Wenn du z. B. eine Gruppierung für die verschiedenen Webhoster anlegen willst, gehst du wie folgt vor:

Webhosting: Hostingwerk

Labels lassen sich bei mehreren Installationen gleichzeitig bearbeiten (Mehrfachauswahl). Dazu wählst du die betreffenden Einträge durch einen Klick auf das trakked-Logo aus. Anschliessend gehst du am unteren Bildschirmrand auf den grünen Button und dann auf «mehrere Labels bearbeiten». Nun kannst du die entsprechenden Labels hinzufügen oder löschen. Zum Speichern auf den Button «Installationen aktualisieren» klicken.

Du kannst die Reihenfolge der einzelnen Gruppen ändern, indem du oben rechts auf das «Zahnrad-Symbol» klickst, danach vor dem Gruppen-Namen auf die sechs Punkte klickst und per Drag & Drop die Gruppe an den gewünschten Ort ziehst.

Über das von Contao bekannte Auge, kannst du einzelne Gruppen aus der «Suchen & Filtern»-Liste ausblenden. Klicke dazu auf das «Zahnrad-Symbol» und wähle danach die auszublendende Gruppe.

Bestehenden Labels kannst du umbenennen, ohne diese neu anzulegen. Dazu klickst du zuerst rechts oben auf das «Zahnrad-Symbol» und kannst anschliessend das jeweilige Label über das «Stift-Symbol» bearbeiten.

Um die Übersichtlichkeit bei umfangreichen Gruppen sicherzustellen, werden die Labels automatisch zu einer Dropdown-Liste, wenn eine Gruppe zu viel Platz einnehmen würde. Damit die Suche nach Labels innerhalb des Dropdowns schnell geht, wurde zudem eine Autovervollständigung integriert.

Bei Bedarf kannst du jetzt mit einem Mausklick auf die Labels deine Installationen finden. Die Filter lassen sich zudem beliebig kombinieren oder sogar umkehren. Klicke dazu einfach 2x auf das Label.

z. B. zeige mir alle Installation, die «NICHT» Contao 4.13.12 installiert haben.

Standardmässig wird immer der «UND-Filter» verwendet. Wenn es für das Label allerdings Sinn ergibt, wird dir ein Schalter für den ODER-Filter innerhalb von Gruppen angezeigt. So kannst du beispielsweise herausfinden, welche Installationen getrakked werden und Kosten generieren. Dazu einfach die Labels «Manager» und «Monitoring« mit «ODER» verbinden.

Damit ist es möglich, anhand von Versionsbedingungen gezielt nach Versionen von Erweiterungen bzw. Paketen zu suchen und diese Installationen entsprechend zu filtern. Dazu wählst du zunächst beim Paket-Filter ein Paket aus. Anschließend klickst du auf das Icon «123» oder drückst so lange auf das Label, bis sich das Overlay öffnet um die Versionsbedingung festzulegen.

Hier noch 3 Beispiele, wie du die Funktion nutzen kannst.

1) Alte Versionen von Erweiterungen finden

Nehmen wir an, du verwendest die Erweiterung terminal42/contao-pageimage. Aktuell ist die Version 3.4.3 installiert. Es ist aber bereits Version 4.1.7 verfügbar. Diese wird jedoch nicht installiert, da dies per Definition in der composer.json nicht erlaubt ist.

Wir würden in trakked also nach der Erweiterung terminal42/contao-pageimage einschränken und zusätzlich die Versionsbedingung <4.0 eingeben. Nun zeigt dir trakked alle Installation an, die noch eine ältere Version wie 4.0 verwenden. Diese Installationen kannst du gezielt prüfen und entsprechend die Version über den Contao Manager bzw. direkt in der composer.json ändern.

2) Gezielt Updates durchführen

Ein weiteres Beispiel wäre die Suche nach einer konkreten Version einer Erweiterung, um gezielt Updates durchzuführen.

Nehmen wir an, eine Erweiterung beinhaltet in der Version 1.2.2 einen Fehler und es wurde ein Update auf Version 1.2.3 bereitgestellt. Du möchtest jetzt herausfinden, welche Installationen von diesem Bug betroffen sind und nur diese Installationen aktualisieren.

Dazu filterst du im ersten Schritt nach der Erweiterung und gibst dann in der Versionsbedingung die fehlerhafte Version an. In unserem Beispiel =1.2.2.

Jetzt markierst du nur diese Installationen und lässt das Update von trakked durchführen.

3) Fixierte Versionen finden

Manchmal kann es vorkommen, dass eine bestimmte Version eines Pakets fixiert wurde. D. h. in der composer.json wurde eine konkrete Version festgelegt, die installiert werden darf. Dadurch wird allerdings verhindert, dass zukünftig eine neuere Version eines Pakets installiert werden kann.

Das Problem, du hast vergessen zu dokumentieren, auf welche Version fixiert wurde und bei welchen Installationen du das gemacht hast. Genau hier kann wieder die Versionsbedingung helfen.

Du prüfst im ersten Schritt über den Contao Manager oder Packagist, welches die aktuelle Version der Erweiterung (z. B. Notification Center) ist. Stand heute wäre das 1.7.2. Anschließend filterst du in trakked nach dem Paket notification_center und gibst bei der Versionsbedingung <1.7.2 ein. Jetzt musst du nur noch die betroffenen Installationen prüfen. Dazu kannst du die Paketliste nutzen und entsprechend die Versionsbedingung der composer.json ansehen.