Reference

Text

KirbyText
Markdown

Templates

Field methods
Helpers

Panel

Blueprints
Presets
Fields
Sections
Icons
Samples

Objects

$file
$files
$kirby
$language
$languages
$page
$pages
$pagination
$request
$session
$site
$user
$users

Router

Patterns
Response types

System

Options
Urls
Roots
Validators

Plugins

Extensions
Hooks
Core components
UI Kit

API

Authentication
Languages
Pages
Roles
Site
System
Translations
Users

Tools

A
Cookie
Data
Dir
Escape
F
Header
Html
Mime
Server
Str
Url
Xml

$pages->add()
Adds a single page or an entire second collection to the current collection
$pages->append()
Appends an element to the data array
$pages->audio()
Returns all audio files of all children
$pages->children()
Returns all children for each page in the array
$pages->clone()
Returns a cloned instance of the collection
$pages->code()
Returns all code files of all children
$pages->count()
Counts all elements
$pages->current()
Returns the current element
$pages->data()
Getter and setter for the data
$pages->documents()
Returns all documents of all children
$pages->drafts()
Fetch all drafts for all pages in the collection
Pages::factory()
Creates a pages collection from an array of props
$pages->files()
Returns all files of all children
$pages->filter()
Filters elements by a custom filter function or an array of filters
$pages->filterBy()
Filters elements by one of the predefined filter methods.
$pages->find()
Find one or multiple elements by id
$pages->findBy()
Find a single element by an attribute and its value
$pages->findById()
Finds a page in the collection by id.
$pages->findByIdRecursive()
Finds a child or child of a child recursively.
$pages->findByKey()
Uses the specialized find by id method
$pages->findByUri()
Alias for Pages::findById
$pages->findOpen()
Finds the currently open page
$pages->first()
Returns the first element
$pages->flip()
Returns the elements in reverse order
$pages->get()
Custom getter that is able to find extension pages
$pages->group()
Groups the elements by a given callback
$pages->groupBy()
Groups the items by a given field
$pages->has()
Checks if the given object or id is in the collection
$pages->images()
Returns all images of all children
$pages->index()
Create a recursive flat index of all pages and subpages, etc.
$pages->indexOf()
Correct position detection for objects.
$pages->invisible()
Deprecated alias for Pages::unlisted()
$pages->isEmpty()
Checks if the number of elements is zero
$pages->isEven()
Checks if the number of elements is even
$pages->isNotEmpty()
CChecks if the number of elements is more than zero
$pages->isOdd()
Checks if the number of elements is odd
$pages->key()
Returns the current key
$pages->keyOf()
Tries to find the key for the given element
$pages->keys()
Returns an array of all keys
$pages->last()
Returns the last element
$pages->limit()
Returns a new object with a limited number of elements
$pages->listed()
Returns all listed pages in the collection
$pages->map()
Map a function to each element
$pages->merge()
Include all given items in the collection
$pages->next()
Moves the cursor to the next element and returns it
$pages->not()
Returns a Collection without the given element(s)
$pages->nth()
Returns the nth element from the collection
$pages->nums()
Returns an array with all page numbers
$pages->offset()
Returns a new object starting from the given offset
$pages->paginate()
Add pagination
$pages->pagination()
Get the previously added pagination object
$pages->parent()
Returns the parent model
$pages->pluck()
Extracts all values for a single field into a new array
$pages->prepend()
Prepends an element to the data array
$pages->prev()
Moves the cursor to the previous element and returns it
$pages->published()
$pages->query()
Runs a combination of filterBy, sortBy, not offset, limit and paginate on the collection.
$pages->remove()
Removes an object
$pages->rewind()
Moves the cusor to the first element
$pages->search()
Searches the collection
$pages->set()
Adds a new element to the collection
$pages->shuffle()
Shuffle all elements
$pages->slice()
Returns a slice of the object
$pages->sortBy()
Sorts the elements by any number of fields
$pages->template()
Filter all pages by the given template
$pages->toArray()
Converts all objects in the collection to an array. This can also take a callback function to further modify the array result.
$pages->toJson()
Converts the object into a JSON string
$pages->toString()
Convertes the object to a string
$pages->unlisted()
Returns all unlisted pages in the collection
$pages->valid()
Checks if the current element is valid
$pages->videos()
Returns all video files of all children
$pages->visible()
Deprecated alias for Pages::listed()
$pages->without()
Alias for $this->not()

$pages->first()

Returns the first element

$pages->first(): mixed

Return type

mixed

Example

<?= $page->children()->first()->title() ?>

Source code

kirby/src/Toolkit/Collection.php#L396