Inhaltsklassen für Apps #

Diese Seite richtet sich an App-Entwickler, die Inhaltsklassen in Bildschirme und Datenmodelle übersetzen. Sie erklärt, wie Sie erfahren, was eine Klasse enthält, wie Sie classIdentifier in der App verwenden und wie Sie robust bleiben, wenn das Website-Team eine Klasse ändert.

Inhalt #

1. Die Klassen kennenlernen
2. classIdentifier als Weiche
3. Klassenänderungen überstehen
4. Felder, die Apps helfen

Die Klassen kennenlernen #

Drei Wege, vom einfachsten zum vollständigsten:

expclass::identifiers liefert jedem angemeldeten Benutzer eine schlanke Zuordnung von Klassen-IDs, Bezeichnern und Namen. Die Klassendienste sind in extension/expservices/classes/content/expclassservices.php deklariert.

classIdentifier als Weiche #

Jeder Knoten, jedes Objekt und jeder Listeneintrag trägt classIdentifier. Wählen Sie damit die Zelle und den Detailbildschirm:

when (item.classIdentifier) {
    "article" -> ArticleCell
    "event"   -> EventCell
    "folder"  -> FolderCell (drill down with the list route)
    else      -> GenericCell (objectName only)
}

Haben Sie immer den allgemeinen Fall: Redakteure können eine Klasse, die die App nicht kennt, in einen Ordner legen, den sie zeigt, und die App darf deswegen weder abstürzen noch die ganze Liste ausblenden.

Klassenänderungen überstehen #

Administratoren können Felder hinzufügen, entfernen und umsortieren und Klassen ändern, während die App bei den Benutzern ist. So bleiben Sie robust:

• Lesen Sie Felder über identifier, nie über ihre Position.
• Behandeln Sie jedes Feld als optional, auch wenn die Klasse es als Pflichtfeld markiert; alte Inhalte können älter als die Pflicht sein.
• Prüfen Sie type vor dem Parsen; überspringen Sie ein Feld, dessen Typ sich geändert hat.
• Vereinbaren Sie mit dem Website-Team, dass das Umbenennen oder Entfernen eines Felds, das die App nutzt, wie eine API-Änderung angekündigt wird.
• Ergänzen Sie einen Test, der auf einer Testinstallation ein Element jeder Klasse liest, die die App nutzt, und bei unerwarteten Typen fehlschlägt (Eine lokale Testinstallation).

Felder, die Apps helfen #

Wenn das Website-Team Klassen mit Blick auf die App baut oder erweitert, machen einige Felder eine App einfacher:

Wie Klassen entworfen werden, ist Thema des Website-Teams: Inhaltsklassen für Websites, Datentypen auswählen.

Verwandte Seiten #

• Felder und Feldwerte
• Ihr Inhaltsmodell entwerfen
• Inhaltsmodellierung für Apps
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.