Reference

Files methods are registered with the filesMethods extension.

Default files methods

For a full list of default files methods, please check out the Reference.

Getting started

You can extend the set of defined files methods very easily in a plugin file.

Kirby::plugin('my/plugin', [
    'filesMethods' => [
        'listAll' => function () {
            foreach($this as $file) {
                echo '- ' . $file->filename() . '<br>';
            }
        }
    ]
]);

This example shows the basic architecture of a files method. You define the method name with the key for the filesMethods extension array. $this in the callback function is the $files object.

Working with method arguments

In some cases it might be helpful to be able to pass arguments to the method:

<?php if($files->moreThan($num)) : ?>
  Page has more then $num files.
<?php endif ?>

The definition for such a method with arguments is very simple:

Kirby::plugin('my/plugin', [
    'filesMethods' => [
        'moreThan' => function ($num) {
            return $files->count() > $num;
        }
    ]
]);