$pages->sortBy()

Alias for Kirby\Toolkit\Collection::sort

• kirby/src/Toolkit/Collection.php#L1111

$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