Die Liste der Unterelemente: Einstellungen und ihre Spalten #

Lesen Sie diese Seite, wenn Ihre Redakteure die Liste der Unterelemente in der Administration verwenden, wenn Sie children_detailed.tpl oder dessen JavaScript überschreiben oder wenn Sie eine eigene Spalte hinzufügen möchten. In Exponential 6.0.15 bieten die Einstellungen (Table options) der Liste unter jedem Knoten (content/view/full/<node id>) einen Katalog von mehr als hundert Spalten statt 15 fester, gruppiert, auf dem Server sortierbar, umsortierbar, mit Vorgaben und CSV-Export. Ein Website-Entwickler fügt eine Spalte mit ein paar Zeilen INI und einer PHP-Funktion oder einem Template hinzu.

Alles, was eine Spalte zeigt, wird auf dem Server berechnet, nur für die Spalten, die der Benutzer sichtbar gemacht hat, und nur für die Zeilen der Seite auf dem Bildschirm. Eine Spalte, die der Benutzer nicht sehen darf (ihr Policy[]), wird nicht angeboten, nicht berechnet und nicht gesendet.

Kurz gesagt #

Was Benutzer sehen #

Einstellungen (die Schaltfläche über der Liste) enthält:

• Anzahl der Elemente pro Seite: 10, 25, 50, 100 (subitems.ini [SubitemsSettings] PageSizes[]) oder eine eigene Zahl.
• Spalte suchen: ein Filterfeld; geben Sie einen Teil eines Namens ein („Alias“, „Anzahl“), und nur die passenden Spalten bleiben in der Liste.
• Die Spalten nach Gruppe: Grunddaten, Knoten, Objekt, Version, Ort, URLs, SEO, Zeitangaben, Personen, Verknüpfungen, Übersetzungen, Workflow, Benutzer, Medien, Technisch, Individuell, und eine Gruppe „Attribute: <Klasse>“ pro Klasse unter den Unterelementen. Ein Kontrollkästchen pro Spalte; die Beschreibung der Spalte ist ihr Tooltip.
• Reihenfolge der sichtbaren Spalten: Ziehen Sie eine Spalte, um sie zu verschieben, oder verwenden Sie ihre Pfeiltasten.
• Spaltenvorgaben: Wählen Sie eine (SEO, Redaktionell, Technisch, Übersetzungen werden mit dem System ausgeliefert), Aktuelle speichern als..., um die aktuellen Spalten unter einem eigenen Namen zu behalten, Vorgabe löschen für Ihre eigenen.
• CSV exportieren: lädt jedes Unterelement (bis zu CSVLimit) mit den sichtbaren Spalten in ihrer Reihenfolge herunter.

In der Tabelle selbst sortiert ein Klick auf den Kopf einer sortierbaren Spalte die Liste danach, auf dem Server (sodass die Reihenfolge über Seiten hinweg stimmt). Eine Zelle einer mit Copy=true gekennzeichneten Spalte (IDs, Pfade, URLs, der Seitentitel ...) kopiert ihren Wert bei einem Klick und meldet „Kopiert“.

Die Wahl wird für den Benutzer gespeichert, pro Bereich der Administration (der Inhaltsbaum, die Medien-Bibliothek und die Benutzer behalten ihre eigene), auf dem Server: Sie folgt dem Benutzer in jeden Browser. Die früher im Cookie eZSubitemColumns gewählten Spalten werden beim ersten Mal übernommen.

Die Liste funktioniert so in jedem Admin-Design: admin und admin4 haben ihr eigenes children_detailed.tpl, die anderen Admin-Designs (admin2, admin3, sevenx_site_admin) verwenden das des Designs, auf das sie zurückfallen. Ohne die Server-Funktionen (eine alte ezjscore.ini) fällt sie auf die klassischen 15 Spalten zurück.

Der Spaltenkatalog #

129 Spalten werden in settings/subitemscolumns.ini ausgeliefert; dazu kommen die automatischen Attributspalten (siehe unten). „Sortierung“ nennt das Feld, nach dem die Liste sortiert, wenn der Kopf angeklickt wird (leer: nicht sortierbar); „Richtlinie“ die Funktionen, die ein Benutzer braucht, damit ihm die Spalte überhaupt angeboten wird. „Art“ ist, wie der Wert entsteht: eingebaut (wie bisher von der Liste aus dem Knoten gerendert), eine Klasse und ihr Field=, ein Handler oder ein Template. Name und Beschreibung stehen hier so, wie die deutsche Administration sie zeigt.

Grunddaten (5) #

Knoten (16) #

Objekt (14) #

Version (7) #

Ort (5) #

URLs (10) #

SEO (5) #

Zeitangaben (10) #

Personen (5) #

Verknüpfungen (6) #

Übersetzungen (6) #

Workflow (12) #

Benutzer (9) #

Medien (12) #

Technisch (4) #

Individuell (3) #

Wie manche Spalten ihren Wert ermitteln #

• Seitentitel im Browser (pagetitle) ist der <title>, den die öffentliche Website für die Seite des Elements ausgibt, ermittelt aus dem Knoten und den Einstellungen des öffentlichen Siteaccess, ohne die Seite zu rendern. Der öffentliche Siteaccess ist SiteAccess= im Block, sonst site.ini [SiteSettings] DefaultAccess (auf der Referenzinstallation: site). TitleFormat= wählt die Regel des Designs, das dieser Siteaccess verwendet:

  • name (der Standard; das Media-Design, extension/sevenx_themes_media/design/media/templates/pagelayout/head/title.tpl): <page title> - <SiteName>, wobei der Seitentitel der Meta-Titel des xrowmetadata-Attributs des Elements ist, wenn es einen hat, sonst der Name des Elements; der Seitentitel allein, wenn er SiteName entspricht. Auf der Referenzinstallation ist die Medienwurzel daher „Media - Fit & Healthy“, und der Knoten der Startseite „Fit & Healthy“ ist einfach „Fit & Healthy“.
  • path (design/standard und page_head.tpl von ezwebin): die Namen des Elements und seiner Vorfahren, das Element zuerst, verbunden mit „ / “, dann „ - <SiteName>“: „Banners / Media - Bold Agency“ (das Beispiel unter „Die ausgelieferten Familien“).

  SiteName ist das [SiteSettings] SiteName des öffentlichen Siteaccess; Namen werden in seiner ersten Sprache aus SiteLanguageList[] genommen, wenn das Element sie hat. Der Wert ist der reine Text (mit &, nicht &), wie der Browser ihn zeigt. Ein Meta-Titel wird so verwendet, wie er gespeichert ist; der Operator metadata() von xrowmetadata lässt Platzhalter im Stil [name] stehen, und die Spalte ebenso.

• URL-Alias (urlalias) ist der Alias, den die Administration verwendet (url_alias des Knotens). Der Kernel antwortet in zwei Fällen mit einem leeren Alias, und die Spalte löst beide stattdessen aus der Alias-Tabelle auf, statt eine leere Zelle zu zeigen: Der Knoten, dem das Wurzelelement von ezurlalias_ml gehört (die Zeile mit Elternteil 0 und leerem Text), ist die Seite an der Wurzel der Website und zeigt /; die Inhaltswurzel ([NodeSettings] RootNode), deren pathWithNames() immer leer ist, zeigt ihren eigenen Alias, wenn das Wurzelelement einem anderen Knoten gehört. Auf der Referenzinstallation gehört das Wurzelelement dem Knoten 89 („Fit & Healthy“, die Startseite), der außerdem den benannten Alias fit-healthy hat, unter dem seine Unterelemente hängen, und Knoten 2 ist unter websites erreichbar. Alle URL-Aliase (allaliases) führt jeden eigenen Alias des Elements auf.

• Öffentlicher Pfad / Öffentliche URL nehmen das PathPrefix des öffentlichen Siteaccess vom Alias weg (sofern PathPrefixExclude[] es nicht behält, wie urlAlias() es tut) und setzen seine SiteURL davor, mit Scheme=https, sofern SiteURL kein Schema hat.

• Verborgen ist das Element, das ein Redakteur versteckt hat; Unsichtbar ist „Besuchern nicht gezeigt“, selbst versteckt oder unter einem versteckten Knoten. Sie unterscheiden sich für alles unter einem versteckten Knoten.

• Anzahl der Unterelemente zählt die Unterelemente, die der aktuelle Benutzer lesen darf; Klassen der Unterelemente zählt jedes Unterelement pro Klasse (nur Zahlen, keine Namen).

• Wortanzahl, Textlänge und Lesezeit lesen den Haupttext: das erste von body, description, intro, short_description (oder Attributes[] im Block), das ein Rich-Text-, XML- oder Textblock mit Inhalt ist, sonst überhaupt das erste solche Attribut; Markup wird weggelassen.

• Die Spalten der Gruppe Benutzer sind für alles leer, was kein Benutzerkonto ist.

• Bewertung und Schlagwörter brauchen die Erweiterungen ezstarrating und eztags und ein Attribut dieser Art; ohne sie sind sie leer, nie ein Fehler.

Jede Spalte liefert eine leere Zelle (null), wenn sie für die Klasse eines Elements nicht zutrifft, und hält die Liste nie an: Eine Spalte, die fehlschlägt, liefert eine leere Zelle und eine Debug-Warnung.

Eine Spalte in 3 Minuten hinzufügen #

Eine Spalte ist ein Block [Column_<key>]. Legen Sie ihn in settings/override/subitemscolumns.ini.append.php ab, oder besser in einer Erweiterung: extension/<yours>/settings/subitemscolumns.ini.append.php (mit der in ActiveExtensions[] aufgeführten Erweiterung). Der Schlüssel besteht aus Kleinbuchstaben, Ziffern und _. Leeren Sie danach den INI-Cache (php bin/php/ezcache.php --clear-tag=ini); laden Sie das PHP-FPM, das die Administration ausliefert, neu, wenn eine PHP-Klasse hinzugekommen ist (und erzeugen Sie die Autoloads neu). Ein neues Template braucht außerdem ein Leeren des Template-Override-Caches (--clear-id=template-override), sonst bleibt die Zelle leer.

Die drei Beispiele unten sind die, die tests/tests/kernel/classes/subitems/columns/fixtures/subitemscolumns.ini.append.php enthält; expSubitemsGuideExamplesTest lädt diese Datei in eine Registry und berechnet die Spalten so, wie es die Server-Funktion rows tut.

1. Ein Handler: eine Funktion #

[Column_mydaysonline]
Name=Days online
Group=Custom
Type=number
Handler=expSubitemsColumnHandlers::daysOnline
SortField=published
Align=right
Order=5000
Description=Whole days since the item was first published.

class expSubitemsColumnHandlers
{
    public static function daysOnline( eZContentObjectTreeNode $node, array $settings, expSubitemsColumn $column )
    {
        $object = $node->attribute( 'object' );
        $published = $object instanceof eZContentObject ? (int)$object->attribute( 'published' ) : 0;
        return $published > 0 ? expSubitemsColumn::days( $published ) : null;
    }
}

Die Funktion erhält den Knoten der Zeile, den Block als Array und das Spaltenobjekt und gibt den Wert zurück: null, einen Skalar oder eine Liste von Skalaren. Type= entscheidet, wie die Zelle und die CSV ihn zeigen (hier eine Zahl). SortField=published lässt den Kopf die Liste nach dem Veröffentlichungsdatum sortieren. Das ausgelieferte kernel/classes/subitems/columns/expsubitemscolumnhandlers.php enthält diesen und editLink.

2. Eine Klasse: eine eigene Spalte #

[Column_myreadingtime]
Name=Reading time
Group=Custom
Type=number
Class=expSubitemsReadingTimeColumn
WordsPerMinute=250
Align=right
Order=5010
Description=Minutes a reader needs for the main text.

class expSubitemsReadingTimeColumn extends expSubitemsColumn
{
    public function value( eZContentObjectTreeNode $node )
    {
        $count = $this->wordCount()->value( $node );
        if ( !$count )
            return null;
        $perMinute = max( 1, (int)$this->setting( 'WordsPerMinute', 200 ) );
        return max( 1, (int)ceil( $count / $perMinute ) );
    }

    public function html( eZContentObjectTreeNode $node, $value )
    {
        return $value === null ? '' : self::escape( $value . ' ' . ezpI18n::tr( 'design/admin/node/view/full', 'min' ) );
    }

    public function prefetch( array $nodes )
    {
        $this->wordCount()->prefetch( $nodes );
    }

    protected function wordCount()
    {
        return new expSubitemsObjectColumn( $this->key, array( 'Field' => 'word_count' ) + $this->settings );
    }
}

Eine Klasse erweitert expSubitemsColumn und implementiert value(); sie kann html() (die Zelle; maskieren Sie alles mit self::escape()), text() (die CSV), sortBy(), isAvailable() und prefetch() (siehe Leistung) überschreiben. Sie liest ihre eigenen Einstellungen mit $this->setting( 'Name', $default ), sodass eine Klasse mehreren Blöcken dienen kann. Die Basisklasse hat die Formatierung, die alle Spalten teilen, zur Verwendung in value() und html(): escape(), oneLine(), markupToText(), linkHtml(), formatDate(), formatAge() („vor 3 Tagen“), days(), formatBytes() („245 kB“) und memo( $bucket, $key, $compute ) für eine Abfrage, die einmal pro Anfrage erledigt wird. Das ist die ausgelieferte Spalte readingtime (kernel/classes/subitems/columns/expsubitemsreadingtimecolumn.php).

3. Ein Template: Markup ohne PHP #

[Column_mystatus]
Name=Status
Group=Custom
Type=html
Template=design:subitems/columns/statusbadge.tpl
Order=5020
Description=What visitors see of the item.

{def $exp_badge = 'visible'}
{if $node.is_hidden}{set $exp_badge = 'hidden'}
{elseif $node.is_invisible}{set $exp_badge = 'invisible'}
{elseif $node.object.state_identifier_array|contains( 'ez_lock/locked' )}{set $exp_badge = 'locked'}{/if}
{switch match=$exp_badge}
{case match='hidden'}<span class="exp-subitems-badge exp-subitems-badge-hidden">{'Hidden'|i18n( 'design/admin/node/view/full' )}</span>{/case}
...
{case}<span class="exp-subitems-badge exp-subitems-badge-visible">{'Visible'|i18n( 'design/admin/node/view/full' )}</span>{/case}
{/switch}
{undef $exp_badge}

Das Template erhält $node (die Zeile), $column (den Block als Hash: $column.Length, $column.Attributes) und $key. Seine Ausgabe ist die Zelle; sein Text ohne Tags („Sichtbar“) ist der Wert und der CSV-Text. Maskieren Sie, was Sie ausgeben (|wash). Die ausgelieferten design/standard/templates/subitems/columns/statusbadge.tpl und teaser.tpl sind beides Beispiele; teaser.tpl zeigt das Lesen von Block-Einstellungen und einen XML-Textblock.

Die ausgelieferten Familien #

Die meisten ausgelieferten Spalten sind eine Klasse pro Familie, wobei Field= die Spalte wählt, sodass ein eigener Block sie mit anderen Einstellungen wiederverwenden kann (ein anderes SiteAccess= für den Seitentitel, Limit= für Namen von Verknüpfungen, Attributes[] für den Haupttext oder das Bild):

Zum Beispiel der Titel des Siteaccess bold, nach der Pfadregel (Stil von design/standard):

[Column_pagetitle_bold]
Name=Page title (bold)
Group=SEO
Type=text
Class=expSubitemsSEOColumn
Field=page_title
SiteAccess=bold
TitleFormat=path
Copy=true
Order=701
Description=The <title> of the bold siteaccess.

Auf der Referenzinstallation zeigt das erste Unterelement der Medienwurzel dann „Banners / Media - Bold Agency“. Ein SiteAccess=, das nicht in AvailableSiteAccessList[] steht, ergibt eine leere Zelle.

Automatische Attributspalten #

Mit subitems.ini [SubitemsSettings] AttributeColumns=enabled bieten die Einstellungen außerdem eine Spalte pro Attribut jeder Klasse unter den Unterelementen des Elternknotens an, in einer Gruppe „Attribute: <Klassenname>“, mit dem Schlüssel attr:<class identifier>/<attribute identifier> (eine Abfrage findet die Klassen). Der Wert ist der Titel des Attributs, sonst sein Text ohne Tags (höchstens 300 Zeichen); die Spalte sortiert, wenn der Datentyp einen Sortierschlüssel hat, und das Sortieren danach beschränkt die Liste auf diese Klasse (die Attributsortierung von subTree lässt die anderen Klassen weg; die Anzahl bleibt richtig). AttributeColumnsExcludedDataTypes[] hält Datentypen heraus (standardmäßig ezuser: sein Text enthält den Passwort-Hash), und AttributeColumnsDataTypePolicy[<datatype>]=module/function gibt den Spalten eines Datentyps eine Richtlinie.

Richtlinien #

Einträge Policy[]=module/function in einem Block müssen alle gewährt sein (jede Einschränkung zählt als gewährt), sonst existiert die Spalte für diesen Benutzer nicht: nicht in den Einstellungen, nicht berechnet, nicht in den Zeilen oder der CSV, und eine gespeicherte Wahl oder Vorgabe, die sie nennt, lässt sie einfach weg. Mehrere Einträge können auch in einer Zeile, getrennt durch ;, geschrieben werden. Die Zeilen selbst beachten immer content/read: Die Liste und die CSV zeigen nur Unterelemente, die der Benutzer lesen darf, und die Funktion rows verlangt Lesezugriff auf den Elternknoten.

Die ausgelieferten Richtlinien: Die Gruppe Benutzer braucht role/read (die Personen, die die Einrichtung der Rollen sehen), und E-Mail und Fehlgeschlagene Anmeldungen brauchen role/assign. Spalten, die Namen anderer Objekte aufführen (verknüpfte Objekte), lassen diejenigen weg, die der Benutzer nicht lesen darf.

Standardwerte pro Teilbaum und Klasse #

Was ein Benutzer sieht, bevor er eine eigene Wahl speichert, kommt aus subitems.ini: Der erste Block [Defaults_<id>], dessen Subtree[] den Elternknoten oder einen seiner Vorfahren enthält oder dessen ParentClassIdentifiers[] die Klasse des Elternknotens enthält, gewinnt, in der Reihenfolge der Datei; sonst DefaultColumns[]. Die ausgelieferten Blöcke behalten die früheren Standardwerte der Liste für die Medien-Bibliothek (thumbnail;name;visibility;type) und den Benutzerbaum.

[Defaults_fitness]
Subtree[]
Subtree[]=92
ParentClassIdentifiers[]
ParentClassIdentifiers[]=ng_blog
Columns[]
Columns[]=name
Columns[]=published
Columns[]=publishedage
Columns[]=pagetitle

Auf der Referenzinstallation ergibt das name, published, publishedage, pagetitle unter „Fitness“ (Knoten 92) und unter jedem Knoten darunter. Blöcke, die eine Override-Datei hinzufügt, kommen nach den ausgelieferten; um die Standardwerte der Medien-Bibliothek oder der Benutzer zu ändern, überschreiben Sie daher Columns[] von [Defaults_media] / [Defaults_users], statt einen Block für dieselbe Stelle hinzuzufügen.

Vorgaben #

Blöcke [Preset_<id>] in subitems.ini (ID: a-z, 0-9, _, -) werden allen angeboten: Name= und Columns[] in Reihenfolge. Ausgeliefert: seo, editorial, technical, translations. Benutzer speichern ihre eigenen daneben („Aktuelle speichern als...“), höchstens 20, und können nicht die ID einer Vorgabe aus der INI übernehmen. Die Spalten einer Vorgabe, die der Benutzer nicht sehen darf, werden für diesen Benutzer weggelassen.

INI-Referenz #

settings/subitemscolumns.ini #

settings/subitems.ini #

Die Server-API #

Drei Funktionen von ezjscore, [ezjscServer_expsubitems] in extension/ezjscore/settings/ezjscore.ini (Klasse expSubitemsServerFunctions), und eine Inhaltsansicht. Jeder Aufruf braucht einen angemeldeten Benutzer mit Zugang zur Administration und Lesezugriff auf den Elternknoten; Schlüssel werden gegen die Registry geprüft, und nichts aus der Anfrage wird je als Name einer Klasse, Funktion oder eines Templates verwendet. ezjscore verpackt jede Antwort als { "error_text": "", "content": ... }.

• ezjscore/call/expsubitems::columns::<parent>: die Spalten, die der Benutzer sehen darf (key, name, group, type, sortable, align, description, copy, builtin, order), defaults, presets (source: ini oder user), die gespeicherte preference (visible, preset, page_size, saved), page_sizes, csv_export. Auf der Referenzinstallation bietet die Medienwurzel als admin 138 Spalten an (129 aus der INI, 9 Attributspalten):

  {"key":"pagetitle","name":"Page title in the browser","group":"SEO","type":"text","sortable":false,"align":"",
   "description":"The public site's title for the item's page, worked out as its pagelayout does, without rendering the page.",
   "copy":true,"builtin":false,"order":700}

• ezjscore/call/expsubitems::rows::<parent>::<limit>::<offset>::<sort key>::<order 0|1>[::<name filter>] mit columns=a,b,c (POST oder GET): die Antwort von ezjscnode::subtree, jedes Element mit columns: { <key>: { v: <value>, h: "<html>" } } für die angefragten nicht eingebauten Schlüssel. Der Sortierschlüssel ist ein Spaltenschlüssel, dessen Spalte sortiert, oder einer der alten Namen (published_date, modified_date, node_id ...); alles andere sortiert wie der Elternknoten. Zwei Unterelemente der Medienwurzel auf der Referenzinstallation, mit columns=parentnodeid,urlalias,pagetitle,childrencount,version,readingtime:

  {"parentnodeid":{"v":43,"h":"43"},"urlalias":{"v":"media/banners","h":"<code>media/banners</code>"},
   "pagetitle":{"v":"Banners - Fit & Healthy","h":"Banners - Fit &amp; Healthy"},"childrencount":{"v":4,"h":"4"},
   "version":{"v":1,"h":"1"},"readingtime":{"v":null,"h":""}}
  {"parentnodeid":{"v":43,"h":"43"},"urlalias":{"v":"media/clients-partners","h":"<code>media/clients-partners</code>"},
   "pagetitle":{"v":"Clients & Partners - Fit & Healthy","h":"Clients &amp; Partners - Fit &amp; Healthy"},
   "childrencount":{"v":12,"h":"12"},"version":{"v":1,"h":"1"},"readingtime":{"v":null,"h":""}}

• ezjscore/call/expsubitems::savepreference[::<parent>], POST preference=<json> (mit dem Formular-Token): { "visible": [...], "preset": "seo"|null, "page_size": 25, "presets": { "<id>": { "name", "columns" } } }, jeder Schlüssel optional; gespeichert für den Navigationsbereich des Elternknotens.

• content/subitemsexport/<parent>?columns=a,b,c&sort=<key>&order=0|1: die CSV (siehe unten).

PHP-Code kann dieselben Teile verwenden: expSubitemsColumnRegistry::instance() (availableColumns( $parent ), column( $key, $parent ), resolveColumns( $keys, $parent ), defaults(), presets(), sortFor()) und expSubitemsServerFunctions::columnValues( $nodes, $columns ) für die Zellen (es lädt vorab; prefetch() und cell( $column, $node ) sind die beiden Schritte für sich).

Leistung #

Berechnet werden nur die sichtbaren Spalten und nur für die Zeilen der Seite (die Seitengröße), nie für den ganzen Teilbaum. Die 15 eingebauten kosten nichts zusätzlich: Sie kommen wie bisher mit dem Knoten. Die meisten anderen Spalten lesen den geladenen Knoten oder das geladene Objekt und kosten keine Abfrage.

Die übrigen laden, was sie lesen, einmal für die Seite, nicht einmal pro Zeile: Bevor eine Zelle berechnet wird, rufen die Funktion rows und der CSV-Export prefetch( $nodes ) für jede angefragte Spalte mit den Knoten der Seite auf, und die Spalte lädt ihre Daten für alle in einer Abfrage, in dasselbe Memo pro Anfrage, das ihr value() liest. Ein Vorabladen ändert nur die Zahl der Abfragen, nie einen Wert (die Tests berechnen jede Spalte auf beide Arten und vergleichen), und eines, das fehlschlägt, überlässt der Spalte einfach das Laden pro Zeile. Einmal pro Seite geladen:

Spalten einer Zeile, die dieselben Daten lesen, teilen sie sich, und Abfragen, die für jede Zeile gleich sind (der Name des Elternknotens, die Gruppen einer Klasse, eine Sektion, die Einstellungen des öffentlichen Siteaccess, der Name eines Benutzers), werden einmal pro Anfrage erledigt. Die Funktion rows und der CSV-Export leeren zuerst das Memo, sodass ein persistenter Worker nie aus einer früheren Anfrage antwortet. Unter MongoDB werden die gruppierten Abfragen übersprungen, und die Spalten laden pro Zeile. Weiterhin pro Zeile: Größe des Teilbaums (eine Zählung über jeden ganzen Teilbaum), Neuestes Unterelement, die auf URL-Aliasen basierenden Spalten für den seltenen Knoten, dessen Alias der Kernel leer lässt, die Benutzerspalten und Anrisstext (er rendert einen XML-Textblock); behalten Sie die schweren für kleine Seiten.

Eine Familienklasse (expSubitemsFieldColumn) führt in prefetchSets() auf, welche Werte von Field= welchen Satz lesen, und hat für jeden ein prefetch<Set>( $nodes ); eine eigene Spaltenklasse überschreibt prefetch().

Gemessen auf der Referenzinstallation (SQLite, als admin, auf der Kommandozeile; Median aus 5 Läufen, jeder in einem frischen Prozess): jede der 114 nicht eingebauten Spalten auf einmal, für die ersten 10 Unterelemente der Medienwurzel und für die ersten 50 und 100 Knoten des Inhaltsbaums.

CSV-Export #

CSV exportieren in den Einstellungen, oder content/subitemsexport/<parent node id>?columns=a,b,c&sort=<key>&order=0|1: jedes Unterelement, das der Benutzer lesen darf (bis zu CSVLimit, jeweils 100 auf einmal geholt), die angegebenen Spalten (ohne columns=: die gespeicherte Wahl des Benutzers, sonst die Standardwerte), in Reihenfolge; die Kopfzeile enthält die Spaltennamen. UTF-8 mit BOM, durch Kommas getrennt, CRLF; Zellen, die mit =, +, - oder @ beginnen, erhalten ein führendes ', damit eine Tabellenkalkulation sie nicht ausführt. Eingebaute Spalten sind enthalten (außer der Miniaturansicht), Listen werden mit , verbunden, Daten als Y-m-d H:i:s geschrieben, boolesche Werte als 1/0, Größen in Bytes. Die Datei ist nach dem Elternknoten benannt. CSVExport=disabled entfernt die Schaltfläche und die View.

Wo die Wahl gespeichert wird #

Die Wahl des Benutzers ist ein Wert von eZPreferences, admin_subitems_table, ein kompaktes JSON-Dokument:

{"v":1,"parts":{"ezcontentnavigationpart":{"visible":["name","urlalias","pagetitle"],"preset":null}},
 "page_size":25,"presets":{"mine":{"name":"Mine","columns":["name","nodeid"]}}}

Die sichtbaren Spalten und die gewählte Vorgabe werden pro Navigationsbereich gehalten (*, wenn ohne Elternknoten gespeichert), die Seitengröße und die eigenen Vorgaben einmal. Sie bleiben auf jeder Datenbank unter 4000 Bytes (die Grenze von Oracle); eine Wahl, die nicht passt, wird abgelehnt, nicht abgeschnitten. Die alte Benutzereinstellung für Zeilen pro Seite (admin_list_limit) wird weiterhin verwendet, solange keine Seitengröße gespeichert wurde.

Wo der Code liegt #

Tests #

php vendor/bin/phpunit tests/tests/kernel/classes/subitems/            # everything (100 tests)
php vendor/bin/phpunit tests/tests/kernel/classes/subitems/columns/    # the catalogue and the prefetch (64 tests)

Die Tests des Katalogs starten den Kernel im Admin-Siteaccess mit der eigenen Datenbank der Installation und prüfen jede Spalte gegen echte Knoten: die Inhaltswurzel, die Medienwurzel, die Benutzerwurzel, den Benutzer admin und Knoten, die nach ihrem Inhalt gefunden werden (ein Bild, eine Datei, Schlagwörter, ein XML-Text, Verknüpfungen, eine Bewertung). Sie prüfen, dass jeder Block sich bauen lässt, eine bekannte Gruppe, einen bekannten Typ und ein bekanntes Feld nennt, dass sein Sortierfeld akzeptiert wird, dass jede Spalte für vier sehr verschiedene Knoten einen JSON-sicheren Wert und einzeiligen CSV-Text liefert, dass Spalten, die nicht zutreffen, null liefern, dass Richtlinien über die Verfügbarkeit entscheiden, dass kein Knoten je einen leeren URL-Alias zeigt, und die drei ausgearbeiteten Beispiele oben. expSubitemsPrefetchTest berechnet jede Spalte (und die Attributspalten) für Seiten unter der Inhalts-, Medien- und Benutzerwurzel einmal Zeile für Zeile und einmal mit dem Vorabladen der Seite, als admin und als anonym, und verlangt dieselben Zellen; und dass die Zeilen der vorab geladenen Spalten nach dem Vorabladen keine Abfrage brauchen. Ein Test, der Daten braucht, die die Datenbank nicht hat, wird übersprungen, nicht als fehlgeschlagen gewertet.

Verwandte Seiten #

• Einstellungen der Liste der Unterelemente (Funktion)
• Unterelemente: Auswahl kopieren
• Unterelemente: Verstecken und Einblenden unter Weitere Aktionen
• Mehrere Elemente auf einmal bearbeiten
• Wo die Seitengrößen stehen
• Anleitung zu Inhaltsmodell und Bearbeitung