Skip to content

Kirby 4.1.2

$pages->sortBy()

$pages->sortBy(...$args = null): Kirby\Cms\Pages

Parameters

Name Type Default
... $args mixed null

Return type

Kirby\Cms\Pages

This method does not modify the existing $pages object but returns a new object with the changes applied. Learn more →

Parent class

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

Example

<ul>
  <?php foreach($page->children()->sortBy('title', 'desc') as $subpage): ?>
  <li>
    <a href="<?= $subpage->url() ?>">
      <?= $subpage->title()->html() ?>
    </a>
  </li>
  <?php endforeach ?>
</ul>

It's also possible to sort by more than one field:

$articles = page('notes')->children()->sortBy('date', 'desc', 'time', 'asc');

For more complex sorting examples, check out our "Sorting" recipe