Dokumentation zu Page Tree Sorter
Page Tree Sorter hält den Seitenbaum in Confluence Cloud von selbst in Ordnung. Für jede Seite und jeden Ordner legen Sie fest, ob die Unterseiten A–Z, Z–A oder manuell geordnet sind. Die Einstellung wird im Baum nach unten vererbt, und neue, umbenannte oder verschobene Seiten landen automatisch an der richtigen Stelle.
Installation
Page Tree Sorter erscheint bald im Atlassian Marketplace. Sobald gelistet:
- Öffnen Sie in Confluence Apps und dann Explore more apps (oder den Atlassian Marketplace) und suchen Sie nach Page Tree Sorter.
- Wählen Sie die Installationsschaltfläche und bestätigen Sie die Berechtigungen. Die Installation erfordert einen Site-Admin.
- Die App ist sofort einsatzbereit. Sortiert wird erst, wenn ein Space-Admin einen Modus setzt.
Nach der Installation und nach größeren Updates baut die App ihre Übersicht der gesetzten Modi automatisch im Hintergrund neu auf. Auf großen Sites kann das eine Weile dauern. Die Schaltfläche „Index neu aufbauen“ (Rebuild index) auf der Space-Seite Sortierung ist nur ein Notbehelf.
Wo Sie die App finden
| Einstieg | Was er bietet |
|---|---|
| Seitenmenü ••• → Apps → Page Tree Sorter | Öffnet den Dialog. Er zeigt den wirksamen Modus und woher er stammt (zum Beispiel „A–Z, geerbt von Handbuch“). Space-Admins setzen dort den Modus, außerdem gibt es Einmalig sortieren… (Sort once). |
| Zeile unter dem Seitentitel | Zeigt den Modus auf einen Blick: ⇅ A–Z, ⇅ Z–A,
⇅ ⋮⋮ (manuell) oder ⇅ ↳ (geerbt; welcher Modus, zeigt der
Dialog). ⇅ ↳ heißt: Die Seite hat keine eigene Einstellung und übernimmt den Modus von oben; ist weiter oben nirgends ein Modus gesetzt, ist der wirksame Modus Manuell und es wird nichts sortiert. Der Tooltip ist immer englisch. Ein Klick öffnet den Dialog. |
| Space-Navigation → Bereichs-Apps → Sortierung (englische Oberfläche: Space apps → Sorting) | Den Baum Ebene für Ebene durchgehen, Modi für Seiten und Ordner setzen und alle im Space gesetzten Modi sehen. Siehe Die Space-Seite Sortierung. |
Die Oberfläche folgt der Confluence-Sprache: Deutsch oder Englisch. Andere Sprachen fallen auf Englisch zurück.
Erste Nutzung: Jede Person muss beim ersten Öffnen der App einmal Zugriff gestatten (Allow access) wählen. Bis dahin zeigt die Zeile unter dem Seitentitel nur ⇅.
Sortiermodi und Vererbung
Der Modus einer Seite oder eines Ordners bestimmt, wie deren Unterelemente sortiert werden.
| Modus | Wirkung auf die Unterelemente |
|---|---|
| Geerbt (Standard) | Übernimmt den Modus der nächsten Seite oder des nächsten Ordners darüber, die einen haben |
| A–Z | Alphabetisch sortiert |
| Z–A | Umgekehrt alphabetisch sortiert |
| Manuell | Die Reihenfolge bleibt so, wie Sie sie per Drag-and-drop anordnen |
- Die tiefste Einstellung gewinnt. Eine manuell geordnete Kapitelliste kann in einer alphabetisch sortierten Wissensdatenbank liegen und ein A–Z-Zweig in einem manuellen.
- Hat keine Seite und kein Ordner darüber einen Modus, ist der wirksame Modus Manuell: Die App tut nichts, und der Space verhält sich wie bisher.
- Um einen ganzen Space zu sortieren, setzen Sie den Modus auf der Startseite des Space.
Beispiel:
Handbuch ← A–Z
├── Anhang erbt A–Z
├── Glossar erbt A–Z, auch seine Unterseiten werden sortiert
└── Installation ← Manuell (logische Reihenfolge)
├── 1. Voraussetzungen bleibt wie angeordnet
├── 2. Download bleibt wie angeordnet
└── Referenz ← Z–A
Ordner
Ordner können wie Seiten einen eigenen Modus haben und geben ihn an alles darunter weiter. Confluence bietet an Ordnern kein App-Menü. Den Modus eines Ordners setzen Sie deshalb auf der Space-Seite Sortierung: Ebene des Ordners öffnen und unter Modus hier einen Modus wählen. Im Dialog einer Seite öffnet Ordner und Unterseiten verwalten die Space-Seite direkt an dieser Seite.
Inhaltstypen und Sortierreihenfolge
- Alle Inhaltstypen einer Ebene werden gemeinsam nach Titel sortiert: Seiten, Ordner, Whiteboards, Datenbanken, Smart Links und Slides.
- Seiten und Ordner tragen einen Modus und geben ihn weiter. Die anderen Typen werden mitsortiert, bilden aber keine eigene Ebene: Unterelemente von Whiteboards, Datenbanken und Smart Links werden nie sortiert.
- Die oberste Ebene eines Space (Seiten ohne übergeordnete Seite) wird nicht sortiert.
- Natürliche Reihenfolge: Zahlen werden nach ihrem Wert sortiert, also „Kapitel 2“ vor „Kapitel 10“ und „Release 2.9“ vor „Release 2.10“.
- Groß- und Kleinschreibung spielt keine Rolle. Buchstaben mit Akzent und Umlaute werden wie ihr Grundbuchstabe einsortiert.
- Gleiche Titel behalten eine stabile Reihenfolge. Elemente ohne Titel kommen ans Ende.
- Entwürfe sieht nur, wer sie angelegt hat. Sie werden beim Veröffentlichen einsortiert. Ihre eigenen Entwürfe erscheinen auf der Space-Seite Sortierung als „Draft“ ohne Modus.
- Archivierte und gelöschte Inhalte werden nie verschoben.
Automatische Sortierung
Unter einer Seite oder einem Ordner mit A–Z oder Z–A sortiert die App die Unterelemente meist innerhalb von Sekunden neu, wenn
- eine Seite angelegt, umbenannt, verschoben oder hineinkopiert wird,
- ein Ordner, ein Whiteboard, eine Datenbank oder ein Smart Link angelegt, verschoben oder hineinkopiert wird,
- jemand die Unterelemente von Hand umordnet,
- eine Seite bearbeitet oder aus dem Papierkorb wiederhergestellt wird. Das löst nur eine Prüfung aus; steht die Reihenfolge richtig, wird nichts verschoben.
Confluence liefert diese Ereignisse teils bis zu etwa drei Minuten später.
- Verschoben werden nur Elemente, die nicht an der richtigen Stelle stehen.
- Wenn Sie einen Modus ändern, wird jede erbende Ebene darunter neu sortiert.
- Seiten, die die App nicht verschieben darf (eingeschränkte Seiten), werden übersprungen. Der Dialog zeigt, wie viele es waren. Seiten, deren Leseeinschränkungen die App ausschließen, sieht die App nicht: Sie bleiben, wo sie sind, und werden nicht mitgezählt.
- Der Seitenbaum in der Seitenleiste aktualisiert sich nicht von selbst. Nach dem Speichern, Zurücksetzen oder Sortieren bietet der Dialog „Seitenbaum neu laden“ (Reload page tree) an, sonst laden Sie die Seite neu.
Einmalig sortieren (Standard und Hardcore)
Einmalig sortieren… (Sort once) im Dialog sortiert den gesamten Teilbaum einer Seite ein einziges Mal, in der gewählten Richtung (A–Z oder Z–A). Dabei wird kein Modus gespeichert, neue Seiten werden danach also nicht einsortiert. Vor dem Start zeigt die Bestätigung, wie viele Seiten und Ordner unterhalb dieser Seite liegen, soweit Sie sie sehen können, auch Zweige auf Manuell (bei sehr großen Bäumen eine Untergrenze wie „Mehr als 1.200“). Der Lauf steigt in Seiten und Ordner ab.
Einmalig sortieren startet nur im Dialog einer Seite, nicht von einem Ordner aus. Ein Standardlauf durch eine bearbeitende Person verschiebt den gesamten Teilbaum mit den Rechten der App; geprüft wird nur die Bearbeitungsberechtigung für die Startseite.
Die Option Auch manuelle Zweige überschreiben macht aus einem Standardlauf einen Hardcore-Lauf:
| Ebene | Standard | Hardcore (Space-Admins) |
|---|---|---|
| Die Seite, auf der Sie starten | gewählte Richtung | gewählte Richtung |
| Wirksamer Modus A–Z oder Z–A | nach ihrem eigenen Modus | nach ihrem eigenen Modus |
| Geerbt manuell | gewählte Richtung | gewählte Richtung |
| Zweig ausdrücklich auf Manuell gesetzt | wird samt Teilbaum übersprungen | in der gewählten Richtung sortiert |
Gespeicherte Modi ändern sich dabei nie.
Die Space-Seite Sortierung
Sie öffnen sie in der Space-Navigation unter Bereichs-Apps → Sortierung (in der englischen Oberfläche Space apps → Sorting). Sie zeigt
- eine Pfadleiste und die aktuelle Ebene mit Modus hier und dem wirksamen Modus,
- die Inhalte dieser Ebene mit Titel, Typ, eigenem und wirksamem Modus. Ein Klick auf eine Seite oder einen Ordner öffnet deren Ebene.
Space-Admins setzen hier den Modus von Seiten und Ordnern. Sie sehen außerdem die Tabelle Gesetzte Sortiermodi in diesem Space mit der Person, die den Modus gesetzt hat, dem Datum und den Aktionen Ebene öffnen und Zurücksetzen auf geerbt (Reset to inherited). Ebene öffnen zeigt diese Ebene oben auf der Seite. Jede Ebene hat eine eigene URL, deshalb funktioniert der Zurück-Button des Browsers. Die Zeile eines Ordners lässt sich auch dann entfernen, wenn der Ordner schon gelöscht wurde.
Index neu aufbauen (Space-Admins) erstellt diese Übersicht aus den Seiten neu, zum Beispiel nach einer Neuinstallation. Modi von Ordnern lassen sich so nicht wiederherstellen. Nach Installation und Upgrade baut die App den Index außerdem automatisch neu auf, die Schaltfläche ist nur ein Notbehelf. Sie funktioniert auch ohne aktive Lizenz, und die Seite Sortierung bleibt lesbar.
Berechtigungen
| Aktion | Wer |
|---|---|
| Modus setzen oder zurücksetzen | Space-Admins |
| Einmalig sortieren (Standard) | Alle, die die Seite bearbeiten dürfen |
| Einmalig sortieren mit Hardcore | Space-Admins |
| Space-Seite Sortierung ansehen | Alle, die den Space sehen dürfen |
| Übersicht der gesetzten Modi, Index neu aufbauen | Space-Admins |
Alle Berechtigungen prüft der Server, nicht nur die Oberfläche. Die Verschiebungen selbst führt die App aus.
Lizenz
Page Tree Sorter ist eine kostenpflichtige App, die über den Atlassian Marketplace lizenziert wird, sobald sie gelistet ist, und für Sites mit bis zu 10 Nutzern kostenlos.
Ohne aktive Lizenz pausiert die automatische Sortierung, Modi lassen sich weder setzen noch zurücksetzen, und einmaliges Sortieren ist gesperrt. Dialog und Space-Seite zeigen dann „Lizenz nicht aktiv – die automatische Sortierung ist pausiert. Gespeicherte Einstellungen bleiben erhalten.“ Gespeicherte Modi werden nie gelöscht. Sobald die Lizenz wieder aktiv ist, gelten sie wieder, und jede Ebene wird bei ihrer nächsten Änderung sortiert.
Es gelten die Nutzungsbedingungen.
Datenschutz und Daten
Page Tree Sorter ist auf Atlassian Forge gebaut, hat keine externen Hosts und sendet keine Daten an Stellen außerhalb von Atlassian. Die App liest und speichert keine Seiteninhalte. Sie behält nur, was sie zum Sortieren braucht: IDs von Seiten und Ordnern, Titel für die Übersicht, Modi und die Konto-ID des Space-Admins, der einen Modus gesetzt hat.
- Der Modus einer Seite liegt als Content Property direkt an der Seite.
- Der Modus eines Ordners und die Übersicht liegen im Forge-Speicher der App.
Einzelheiten stehen in der Datenschutzerklärung.
Bekannte Einschränkungen
- Kein App-Menü im Seitenbaum der Seitenleiste. Confluence lässt dort keine Apps zu. Nutzen Sie das Seitenmenü, die Zeile unter dem Titel oder die Space-Seite Sortierung.
- Der Seitenbaum aktualisiert sich nicht live. Laden Sie ihn nach dem Sortieren neu.
- Umbenannte Ordner: Confluence meldet das Umbenennen eines Ordners nicht. Seine Position wird bei der nächsten Änderung auf dieser Ebene korrigiert.
- Ordner-Modi gehen beim Deinstallieren verloren. Modi von Seiten liegen an den Seiten und sind nach einer Neuinstallation wieder da. Modi von Ordnern müssen Sie neu setzen.
- Entwürfe sieht nur, wer sie angelegt hat. Sie werden beim Veröffentlichen einsortiert.
- Seiten, die die App nicht lesen kann (Leseeinschränkungen, die die App ausschließen), sieht sie nicht. Sie bleiben, wo sie sind, und werden nicht als übersprungen gezählt.
- Blogbeiträge werden nicht sortiert.
Häufige Fragen
Eine neue Seite wurde nicht einsortiert.
Prüfen Sie den wirksamen Modus ihrer übergeordneten Seite, im Dialog oder bei Ordnern auf der Space-Seite Sortierung. Ereignisse können bis zu etwa drei Minuten brauchen. Ist die Seite noch ein Entwurf, wird sie beim Veröffentlichen einsortiert.
Kann ich einen Zweig in logischer Reihenfolge halten?
Ja. Setzen Sie diese Seite oder diesen Ordner auf Manuell. Alles darunter erbt dann „manuell“, solange dort nichts anderes gesetzt ist.
Ich habe eine Seite verschoben, und sie ist zurückgesprungen.
Die übergeordnete Seite ist auf A–Z oder Z–A gesetzt, deshalb stellt die App die Reihenfolge wieder her. Setzen Sie die übergeordnete Seite auf Manuell, wenn Sie selbst anordnen möchten.
Einige Seiten wurden nicht verschoben.
Der App fehlte die Berechtigung, sie zu verschieben (HTTP 403). Der Dialog der übergeordneten Seite zeigt, wie viele bei ihrem letzten Lauf übersprungen wurden. Diese Zahl zählt nur Seiten, die die App sehen, aber nicht verschieben durfte; Seiten mit Leseeinschränkungen, die die App ausschließen, sieht sie nicht, sie bleiben, wo sie sind.
Die Zeile unter dem Titel zeigt nur ⇅.
Wählen Sie beim ersten Öffnen der App Zugriff gestatten. Das muss jede Person einmal tun.
Liest die App meine Seiteninhalte?
Nein. Sie liest nur Titel, IDs und die Baumstruktur.
Was passiert beim Deinstallieren?
Atlassian löscht den Speicher der App, darunter die Ordner-Modi und die Übersicht. Die Modi von Seiten bleiben als Content Properties an den Seiten und gelten nach einer Neuinstallation wieder. Setzen Sie sie vorher auf „geerbt“ zurück, wenn Sie sie entfernen möchten.
Support
Nutzen Sie das Kontaktformular, auf Deutsch oder Englisch. Sie erhalten innerhalb von 2 Werktagen eine erste Antwort (Montag bis Freitag, MEZ/MESZ), bei einem vollständigen Ausfall der Sortierung innerhalb von 1 Werktag. Nennen Sie bitte die URL Ihrer Site, die betroffene Seite und was Sie erwartet haben.
← Zurück zum Überblick