Lektion 5.1: Knoten und Listen holen
Mit fetch() fragt ein Template den Kernel nach Daten: nach einem Knoten, einer Liste von Unterelementen, dem
aktuellen Benutzer. Jedes Modul kann Fetch-Funktionen anbieten, und jede ist in seiner function_definition.php
beschrieben. Diese Lektion vermittelt die Inhalts-Fetches, die jedes Template verwendet, und zeigt den Teilnehmenden,
wo sie die Parameter jedes beliebigen Fetches nachlesen.
Auf einen Blick
| Kurs | Entwickler |
| Modul | Modul 5: Fetch-Funktionen |
| Dauer | 45 Minuten (15 Präsentation, 30 Übung) |
| Niveau | Fortgeschrittene |
| Zielgruppe | Entwickler und Template-Entwickler |
| Voraussetzungen | Modul 2: der Template-Spielplatz |
Lernziele
Nach dieser Lektion können die Teilnehmenden:
fetch( '<module>', '<function>', hash( ... ) )schreiben und das Ergebnis lesen;- einen Knoten mit
fetch( 'content', 'node', hash( 'node_id', ... ) )laden; - Unterelemente mit
fetch( 'content', 'list', ... )auflisten und mitlist_countzählen; - eine Fetch-Funktion und ihre Parameter in
kernel/<module>/function_definition.phpfinden; - erklären, warum ein Listen-Fetch ein
limitbraucht.
Hinweise für Trainer
So präsentieren Sie es
Quellen: kernel/content/function_definition.php und
Templates und Design, Teil 6.
- Die Form (3 Minuten).
fetch( 'content', 'list', hash( 'parent_node_id', $node.node_id, 'limit', 5 ) ): Modul, Funktion, benannte Parameter. Das Ergebnis ist das, was die Funktion zurückgibt, hier ein Array von Knoten. - Wo Fetches definiert sind (4 Minuten). Öffnen Sie
kernel/content/function_definition.php. Jedes$FunctionList['<name>']nennt die PHP-Methode (eZContentFunctionCollection::fetchContentNodefürnode) und ihre Parameter mit Typ, Standardwert und der Angabe, ob sie erforderlich sind. Listen Sie die Inhaltsfunktionen auf:grep -o "FunctionList\['[a-z_]*'\]" kernel/content/function_definition.php. node(2 Minuten). Die Parameternode_id,node_path,language_codeundremote_id.listundlist_count(4 Minuten).listnimmtparent_node_id,limit,offset,sort_by,class_filter_type,class_filter_array,attribute_filter,depth,language,load_data_mapund weitere an;list_countnimmt dieselben Filter an und gibt eine Zahl zurück. Holen Sie immer mit einemlimitund zählen Sie für die Seitennavigation mitlist_count.- Berechtigungen (2 Minuten). Inhalts-Fetches geben nur zurück, was der aktuelle Benutzer lesen darf. Ein anonymer Besucher sieht weniger Elemente als ein Redakteur.
Häufige Fragen
fetch oder $node.children? $node.children lädt alle Unterelemente ohne Begrenzung und ohne Kontrolle über
die Sortierung; fetch mit einem limit lädt eine Seite.
Warum gibt mein Fetch in einem Skript nichts zurück? Skripte laufen als anonymer Benutzer, sofern sie keinen Benutzer anmelden; Fetches beachten Berechtigungen.
Kann ich nach Pfad holen? fetch( 'content', 'node', hash( 'node_path', 'about-us' ) ) findet einen Knoten über
seinen URL-Alias.
Stolperfallen
- Eine Liste ohne
limit. Bei einem Ordner mit Tausenden von Elementen wird die Seite langsam und braucht viel Speicher. - Fetches in einer Schleife. Ein
fetchin einemforeachläuft einmal pro Element; holen Sie nach Möglichkeit einmal vor der Schleife. - Parameternamen. Ein falsch geschriebener Parameter wird stillschweigend ignoriert; vergleichen Sie mit
function_definition.php.
Praktische Übung
Verwenden Sie den Template-Spielplatz (extension/mysite_hello/scripts/play.tpl) und führen Sie ihn nach jedem
Schritt aus.
Laden Sie Knoten 2 mit einem Fetch statt über die Variable:
def $top = fetch( 'content', 'node', hash( 'node_id', 2 ) ) [$top.name|wash]Listen Sie seine fünf neuesten Unterelemente auf:
{def $items = fetch( 'content', 'list', hash( 'parent_node_id', 2, 'limit', 5, 'sort_by', array( 'published', false() ) ) )} foreach $items as $item$item.name|wash ($item.class_identifier)delimiter, /delimiter/foreachZählen Sie alle Unterelemente:
{fetch( 'content', 'list_count', hash( 'parent_node_id', 2 ) )}.Listen Sie die Inhalts-Fetch-Funktionen in einer Shell auf:
grep -o "FunctionList\['[a-z_]*'\]" kernel/content/function_definition.php.Lesen Sie die Parameter von
listinkernel/content/function_definition.phpund suchen Sieclass_filter_array.Laden Sie Ihren Kursordner über seine Knoten-ID und listen Sie seine Unterelemente mit einem
limitvon 3 auf.Vergleichen Sie mit der Administration: dieselben Elemente, in der Reihenfolge, die Sie gewählt haben.
Geben Sie die Variablen mit
{undef}frei und committen Sie das Template.
Erwartetes Ergebnis
- Schritt 1 gibt den Namen von Knoten 2 aus.
- Schritt 2 gibt bis zu fünf Namen mit ihren Klassenbezeichnern aus, die neuesten zuerst.
- Schritt 3 gibt eine Zahl aus, die mindestens so groß ist wie die Liste aus Schritt 2.
- Schritt 6 listet die eigenen Elemente der Teilnehmenden aus den früheren Modulen auf.
- Der Trainer lässt alle Teilnehmenden die PHP-Methode hinter
fetch( 'content', 'node', ... )nennen.
Quiz
- Aus welchen drei Teilen besteht ein Fetch-Aufruf?
- Welcher Fetch gibt die Anzahl der Unterelemente zurück, ohne sie zu laden?
A.
listB.list_countC.treeD.node - Wo sind die Parameter der Inhalts-Fetch-Funktionen definiert?
- Warum sieht ein anonymer Besucher in einem Fetch weniger Elemente als ein Redakteur?
- Nennen Sie zwei Parameter von
fetch( 'content', 'node', ... ).
Antworten
- Das Modul, der Funktionsname und ein Hash mit benannten Parametern.
- B.
list_count. - In
kernel/content/function_definition.php. - Inhalts-Fetches geben nur zurück, was der aktuelle Benutzer lesen darf.
- Zwei von
node_id,node_path,language_code,remote_id.
Weiterführende Literatur
- Templates und Design: die Sprache und ein vollständiges Listen-Template.
- Das Inhaltsmodell und das Bearbeiten von Inhalten, Teil 9: der Standard-Klassenfilter für Fetches.
- Zugriffs- und Cache-Filter: wie Erweiterungen an Zugriffsprüfungen und am View-Caching teilnehmen können.
Verwandte Seiten
- Modul 5: Fetch-Funktionen
- Entwickler: Kursüberblick
- Trainer: hier beginnen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.