$pages->group()

Groups the items by a given field or callback. Returns a collection with an item for each group and a collection for each group.

• kirby/src/Cms/Collection.php#L131

$pages->group(string|\Closure $field, bool $i = true): Kirby\Cms\Collection

Parameters

Name	Type	Default	Description
$field *	string|Closure	–
$i	bool	true	Ignore upper/lowercase for group names

Return type

Kirby\Cms\Collection

Exceptions

Type	Description
Kirby\Exception\Exception

Parent class

Kirby\Cms\Pages inherited from Kirby\Cms\Collection

Example

// return collection of pages grouped by the first character of their title field
$groups = $page->children()->sortBy('title', 'asc')->group(function($item) {
    return Str::substr($item->title()->value(), 0, 1);
});

More information

Grouping collections