Sammlungsliste, Feldbindung und Detail-Vorlagen
Listen aus Sammlungen oder Fach-Apps bauen, Blöcke mit Feldern verbinden und eine Seite als Vorlage für jeden Eintrag nutzen.
Worum es geht
Mit der Sammlungsliste zeigen Sie viele gleichartige Einträge, etwa Beiträge, Produkte, Veranstaltungen oder Termine. Sie gestalten eine einzige Vorlage für einen Eintrag, die Website wiederholt sie für jeden Datensatz der Quelle. Mit Mit Feld verbinden legen Sie fest, welches Feld des Eintrags in welcher Eigenschaft eines Blocks erscheint. Und mit einer Detail-Vorlage wird eine einzige Seite zur Seite jedes Eintrags.
Für alle drei gilt derselbe Grundsatz: Die Daten bleiben dort, wo Sie sie pflegen. Beiträge und eigene Sammlungen bearbeiten Sie in Sites, Produkte in E-Commerce, Veranstaltungen im Eventmanager, buchbare Angebote in Termine. Die Website hält nur die Quelle (woher) und die Darstellung (wie). Ändern Sie einen Preis in E-Commerce, steht er ohne weiteres Zutun auch in der Liste. Allgemeines zu Daten-Blöcken steht unter Seiten.
Wichtig: Code-Blöcke zeichnet die Website selbst. Die Sammlungsliste erscheint auf der veröffentlichten Seite erst, wenn das Projekt Ihrer Website sie enthält. Der Starter bringt sie mit; in einem älteren Projekt holen Sie sie mit
hcms add sammlungslistenach und prüfen mithcms pruefen, ob die Website alles darstellen kann. Siehe auch Neue Bausteine.
Eine Sammlungsliste anlegen
Ziehen Sie im Seiten-Editor die Sammlungsliste aus der Palette auf die Seite. Sie enthält einen Sammlungseintrag: die Vorlage, die für jeden Datensatz wiederholt wird. Alles, was Sie in den Sammlungseintrag legen (Überschrift, Text, Bild, Knopf, auch Komponenten), erscheint pro Eintrag.
Im Inspektor der Liste stehen diese Abschnitte:
| Abschnitt | Was Sie dort einstellen |
|---|---|
| Quelle | Woher die Einträge kommen |
| Filter und Sortierung | Welche Einträge erscheinen und in welcher Reihenfolge |
| Anzahl und Blättern | Wie viele Einträge pro Seite und wie weitere erreichbar sind |
| Leerzustand | Was erscheint, wenn nichts passt |
| Darstellung | Raster, Liste oder Karussell, Spalten und Abstand |
Im Seitenbaum tragen Liste und Eintrag kleine Marken: Quelle an der Liste (sie wiederholt ihren Eintrag für jeden Datensatz) und Kontext am Sammlungseintrag (er gibt allen Blöcken darin seine Felder). Blöcke mit verbundenen Feldern zeigen Verbunden: und die Feldnamen.
Quelle
Unter Quelle wählen Sie entweder eine Collection von Sites (Collection wählen) oder, unter Oder Daten aus einer Fach-App, eine der Karten Produkte (E-Commerce), Events (Ticketing) oder Termine (Terminbuchung). Die Karte Gerichte (Gastro) ist sichtbar, aber noch nicht wählbar: Speisekarten lassen sich in der Sammlungsliste zurzeit nicht zeigen. Eine bereits gespeicherte Liste mit dieser Quelle bleibt leer.
- Bei einer Fach-App legen Sie darunter fest, was genau gezeigt wird. Beim Shop sind das der Kanal, die Kategorie und die Liste (Produkte oder Kategorien), beim Ticketing der Ticketshop und der Zeitraum, bei Terminen die Strecke.
- Die Kategorien des Shops eignen sich zum Beispiel als Einstieg in den Shop: Name, Adresse, Bild, Kurztext und Anzahl der Produkte stehen als Felder zur Verfügung.
- Ein Hinweis nennt, aus welcher App die Daten kommen („Daten aus E-Commerce · dort bearbeiten“). Der Link In E-Commerce öffnen, Im Eventmanager öffnen, In Termine öffnen oder In Sites öffnen erscheint nur, wenn Ihre Organisation die App abonniert hat und Sie sie öffnen dürfen.
- Eine Karte ist gesperrt und nennt den Grund, wenn die App nicht abonniert ist (App nicht abonniert) oder Ihnen der Zugriff fehlt (Kein Zugriff).
- Gibt es die gewählte Collection nicht mehr oder ist bei ihr API aktiv ausgeschaltet, sagt der Inspektor das, statt stillschweigend etwas anderes zu wählen.
- Ohne Quelle erscheint Wählen Sie eine Quelle. Auf der veröffentlichten Seite bleibt eine Liste ohne Quelle unsichtbar.
Filter und Sortierung
Bei einer Collection bilden Sie Bedingungen mit Filter hinzufügen. Jede Zeile hat ein Feld, eine Bedingung (ist, ist nicht, ist eine von) und einen Wert. Mehrere Werte trennen Sie mit Komma. Die Zahl der Filter ist begrenzt; der Inspektor nennt die Obergrenze. Mit einem Platzhalter wie {{item.feld}} setzen Sie den Wert eines äusseren Eintrags oder der Seite ein.
Unter Sortieren nach wählen Sie Veröffentlicht am, Erstellt am oder Zuletzt geändert und bei Reihenfolge Neueste zuerst oder Älteste zuerst.
Bei einer Fach-App legen Sie oben bei der Quelle fest, welche Einträge erscheinen. Hier bestimmen Sie nur die Reihenfolge.
Anzahl und Blättern
Bei Einträge pro Seite stellen Sie die Anzahl mit Weniger und Mehr ein, von 1 bis höchstens 20. Unter Blättern wählen Sie:
| Art | Verhalten |
|---|---|
| Keines | Nur die erste Seite der Einträge |
| Seitenzahlen | Seitenzahlen unter der Liste, bis höchstens Seite 50 |
| Mehr laden | Ein Knopf lädt weitere Einträge nach. Bei einer Collection erscheinen insgesamt höchstens 60 Einträge, bei einer Fach-App höchstens 20. |
So funktioniert das Blättern für Besucherinnen: Jeder Klick öffnet die Seite neu, und die gewählte Seite steht in der Adresse, zum Beispiel ?seite.<Block-ID>=2. Die Adresse lässt sich daher weitergeben oder als Lesezeichen speichern, und es braucht kein JavaScript. Eine ungültige Seitenzahl oder eine über 50 führt zur ersten Seite. Eine Seitenzahl hinter der letzten vorhandenen Seite zeigt den Leerzustand der Liste. Pro Adresse blättern höchstens fünf Listen unabhängig voneinander.
Blättern gibt es nur bei Listen auf oberster Ebene.
Leerzustand
Unter Meldung, wenn keine Einträge passen schreiben Sie den Text, der erscheint, wenn die Quelle nichts liefert. Mit Ganze Liste ausblenden, wenn leer erscheint auf der veröffentlichten Seite stattdessen nichts.
Darstellung
Unter Anordnung wählen Sie Raster, Liste oder Karussell. Dazu kommen Spalten Desktop, Spalten Handy und der Abstand zwischen Einträgen (Klein, Mittel, Gross). Das Karussell hat Pfeile zum Blättern.
Verschachtelte Listen
Eine Sammlungsliste darf in einem Sammlungseintrag stehen, etwa eine Liste von Kategorien und darin je eine Liste der zugehörigen Produkte. Bei der inneren Liste schalten Sie Nur Einträge des übergeordneten Eintrags ein und wählen das Bezugsfeld, das auf den äusseren Eintrag zeigt. Das ist nur möglich, wenn die äussere Liste eine Sammlung ist und die innere Collection ein solches Bezugsfeld hat; sonst nennt der Inspektor den Grund. Verschachtelt sind höchstens drei Ebenen möglich.
Der Kontext wird dabei gestapelt: Blöcke im inneren Eintrag können ihre Eigenschaften mit dem Aktuellen Eintrag und dem Übergeordneten Eintrag verbinden. Der nächstgelegene Eintrag steht in der Liste zuerst.
Mit Feld verbinden
Jede Komponente unter einem Sammlungseintrag kann ihre Eigenschaften mit den Feldern des Eintrags verbinden. Das gilt für Grundbausteine und für Instanzen Ihrer Komponenten.
- Wählen Sie den Block im Sammlungseintrag.
- Klicken Sie neben der Eigenschaft, die Sie verbinden wollen, auf Mit Feld verbinden. Ist die Eigenschaft schon verbunden, heisst der Knopf Feld ändern.
- Im Menü suchen Sie unter Feld suchen und wählen mit Pfeiltasten und Eingabe. Esc schliesst das Menü.
- Der Inspektor zeigt danach „verbunden mit“ und das Feld, dazu eine Vorschau mit einem Beispielwert.
Das Menü gliedert sich in Aktueller Eintrag, Übergeordnet und Seite (Seitentitel und Adresse der Seite). Passende Felder stehen zuerst. Felder, die nicht zur Eigenschaft passen, sind ausgegraut und nennen den Grund, zum Beispiel „Text, ein Bild wird erwartet“. Für Links sind passende Felder als Empfohlen für Links markiert, bei Fach-Apps etwa die Adresse oder die Detailseite.
- Mit Lösen heben Sie die Verbindung auf. Der feste Wert der Eigenschaft gilt dann wieder.
- Felder, die erst beim Aufruf der Seite geholt werden (Lagerstand, Restplätze, freie Plätze), tragen den Hinweis Wird beim Aufruf der Seite aktualisiert. Für die Sichtbarkeit sind sie nicht verfügbar.
- Unter Sichtbarkeit blenden Sie einen Block abhängig von einem Feld ein oder aus, zum Beispiel nur bei Produkten, die Neu sind. Bedingungen sind ist gleich, ist nicht gleich, höchstens, mindestens und ist vorhanden. Ohne Bedingung ist der Block Immer sichtbar.
- Wiederholte Bereiche und Plätze für eigene Blöcke lassen sich nicht mit einem Feld verbinden.
- Steht ein Block nicht in einem Sammlungseintrag, nennt der Inspektor: „Kein Sammlungseintrag in diesem Zweig“. Wird ein verbundenes Feld später gelöscht, erscheint Feld fehlt.
Platzhalter statt Verbindung
Texte dürfen auch Platzhalter wie {{item.name}} enthalten. Sie gelten weiter; mit In Bindung umwandeln machen Sie daraus eine Verbindung. Fehlt das Feld im Eintrag, bleibt die Stelle leer. Der Wert wird immer als Text eingesetzt, nie als Anweisung an die Seite.
Wenn Rechte fehlen
Die Felder einer Quelle sehen Sie im Menü nur, wenn Sie die Einträge lesen dürfen. Fehlt das Recht, Einträge zu lesen, oder ist die App der Quelle nicht abonniert, bleibt das Menü leer und nennt den Grund („Ihnen fehlt der Zugriff auf diese Quelle“, „Die App dieser Quelle ist nicht abonniert“). Felder, die für Ihre Rolle gesperrt sind, erscheinen nicht. Was Besucherinnen auf der Website sehen, richtet sich nach der Schnittstelle der Sammlung. Eine Collection, bei der API aktiv ausgeschaltet ist, liefert nichts aus:
- Eine Sammlungsliste auf dieser Collection zeigt auf der veröffentlichten Seite keine Einträge. Die Seite selbst erscheint trotzdem, die Stelle der Liste bleibt leer, und die Vorschau im Editor zeigt den Hinweis „Keine Quelle gewählt“, auch wenn eine Quelle gewählt ist.
- Eine Detail-Vorlage auf dieser Collection liefert die Fehlerseite 404, genau wie bei einer Adresse, die es nicht gibt. Die Website verrät nicht, dass die Vorlage existiert.
Schalten Sie dazu in den Einstellungen der Collection API aktiv ein (siehe Collections), damit beide wieder Inhalt zeigen.
Detail-Vorlagen: eine Seite für jeden Eintrag
Statt für jeden Beitrag, jedes Produkt oder jede Veranstaltung eine eigene Seite anzulegen, bauen Sie eine einzige Vorlage.
- Legen Sie eine Seite an, deren Adresse ein Segment in eckigen Klammern enthält, zum Beispiel
/blog/[slug]. Schalten Sie den Platzhalter in Schritt 2 ein, hängt der Schalter/[slug]selbst an. - Öffnen Sie die Seite im Editor und schalten Sie in der Seitenleiste Diese Seite ist eine Vorlage ein.
- Wählen Sie die Quelle: eine Collection oder eine Fach-App (E-Commerce · Produkte, Eventmanager · Events, Termine · Angebote). Beim Shop wählen Sie den Kanal des Shops; ohne Kanal liefert die Vorlage keine Seite. Beim Ticketshop und bei der Strecke können Sie die Auswahl auch auf Alle lassen.
- Gestalten Sie die Seite. Der Eintrag, der zur Adresse gehört, steht allen Blöcken als Kontext zur Verfügung; Sie verbinden Eigenschaften wie bei einer Sammlungsliste mit seinen Feldern.
Der Inspektor „Seite · Vorlage“
Sobald die Seite eine Vorlage ist, ersetzt der Inspektor Seite · Vorlage die gewohnten Einstellungen in der Seitenleiste. Über der Leinwand steht ein Band: „Diese Seite ist eine Vorlage für jeden Eintrag aus …“ mit dem Adressmuster. Der Inspektor hat drei Reiter:
| Reiter | Inhalt |
|---|---|
| Vorlage | Adresse, Quelle, Slug-Feld und das Verhalten, wenn kein Eintrag passt |
| Seite | Die Einstellungen der Seite: Sprache, Sichtbarkeit, gebundene Collection |
| Suchmaschinen | Seitentitel, Beschreibung und Vorschaubild, verbindbar mit Feldern des Eintrags |
Im Reiter Vorlage finden Sie:
- Adresse: Sie erscheint als „/blog / [slug]“: vorn der Teil, den Sie ändern, dahinter der feste Platzhalter, der für den Eintrag steht. Eine Vorlage hat immer genau einen Platzhalter. Fehlt er, bietet der Inspektor Platzhalter [slug] anfügen an. Passt das Adressmuster der Collection nicht zur Adresse der Vorlage, warnt der Inspektor, dass Links auf Einträge sonst ins Leere führen. Den Pfad ändern Sie weiterhin auch im Feld Pfad unter Stammdaten.
- Quelle: mit dem Hinweis, aus welcher App die Daten kommen („Daten aus … · dort bearbeiten“). Der Link zur App erscheint nur, wenn Ihre Organisation sie abonniert hat und Sie sie öffnen dürfen.
- Slug-Feld: Der Slug kommt aus der Quelle und lässt sich nur dort ändern: aus der Collection, aus E-Commerce (Produktadresse), aus dem Eventmanager (Adresse des Events) oder aus Termine (Schlüssel der Strecke). Das Feld ist nur zum Lesen da.
- Wenn kein Eintrag passt: Die Website liefert die Fehlerseite 404. Die Auswahl Zur Übersicht ist ausgegraut und nennt den Grund: Sie ist noch nicht wählbar.
- Entwürfe nicht ausliefern: Dieser Schalter ist immer eingeschaltet und lässt sich nicht ausschalten. Nur veröffentlichte Einträge erhalten eine Seite; Entwürfe werden nie öffentlich ausgeliefert, sonst würden unfertige Inhalte sichtbar.
Ansehen mit
Über der Leinwand wählen Sie mit Ansehen mit: einen echten Eintrag, an dem Sie die Vorlage ansehen. Voriger Eintrag und Nächster Eintrag blättern durch die Einträge, ein Zähler zeigt zum Beispiel „3 von 40“. Das ändert nur die Ansicht im Editor, nicht die Seite. Gibt es noch keine Einträge oder dürfen Sie sie nicht lesen, steht das dort.
Ist Vorschau mit echten Daten ausgeschaltet, zeigt das Vorschaufenster einen Beispiel-Eintrag statt eines echten; die Auswahl Ansehen mit listet weiterhin Ihre echten Einträge. Mehr dazu unter Vorschau mit echten Daten.
Titel und Beschreibung für Suchmaschinen verbinden
Im Reiter Suchmaschinen verbinden Sie Meta-Titel, Meta-Beschreibung und das Vorschaubild (Open-Graph-Bild) mit Feldern des Eintrags, mit Mit Feld verbinden wie bei jedem Block. So bekommt jeder Beitrag und jedes Produkt seinen eigenen Titel und seine eigene Beschreibung für Suchmaschinen, ohne dass Sie sie zweimal pflegen.
- Der Text, den Sie vorher fest eingetragen haben, bleibt als Rückfall erhalten: Ist das Feld im Eintrag leer, gilt er.
- Mit Lösen heben Sie die Verbindung auf. Der zuletzt in der Vorschau gezeigte Wert bleibt dabei als fester Text stehen.
- Der Wert wird als reiner Text eingesetzt: Formatierung wird entfernt, Leerraum zusammengezogen, zu lange Texte werden gekürzt.
- Alle weiteren SEO-Angaben (kanonische Adresse, Open Graph, Robots, Strukturierte Daten) stehen wie bei jeder Seite im Bereich SEO unter dem Inhalt.
Sitemap
Die Detailseiten Ihrer Vorlagen erscheinen automatisch in der Sitemap neuer Websites, die auf dem Standard-Starter beruhen: für jeden veröffentlichten Eintrag eine Adresse, in jeder Sprache der Vorlage. Die Vorlage selbst, also die Adresse mit dem Platzhalter, steht nicht in der Sitemap. Eine Website, die vor dieser Funktion angelegt wurde, und der Shop-Starter zeigen die Detailseiten erst nach einer Aktualisierung des Starters durch Ihren Entwickler. Wollen Sie die Detailseiten einer Vorlage nicht in der Sitemap haben, schalten Sie im Bereich SEO der Vorlage In Sitemap aufnehmen aus und speichern Sie die Seite. Ein Schalter, den Sie nie gespeichert haben, gilt als eingeschaltet, auch wenn er im Editor ausgeschaltet aussieht.
Die Sammlungsliste ersetzt die frühere Collection-Wiederholung. Bestehende Seiten mit dem älteren Baustein funktionieren unverändert weiter, neue Listen legen Sie nur noch mit der Sammlungsliste an.