# Kirby LISTER - a file picker field with a preview

**URL:** <https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706>\
**Category:** Plugins\
**Tags:** discontinued\
**Created:** [July 16, 2016, 8:38pm UTC](https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706 "2016-07-16T20:38:35Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![1n3JgKl9pQ6cUMrW](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/1n3jgkl9pq6cumrw/32/2368_2.png) [@1n3JgKl9pQ6cUMrW](https://forum.getkirby.com/u/1n3JgKl9pQ6cUMrW)\
**Post date:** [July 16, 2016, 8:38pm UTC](https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706/1 "2016-07-16T20:38:35Z")

</div>

![Kirby LISTER](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister/raw/master/kirby-lister_logotype.png "Kirby LISTER")

# [Kirby LISTER](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister)

#### Version 1.0.0 - 2016-07-16

- Initial Public Offering.

* * *

### What is it?

**[Kirby - LISTER](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister)** is a file-picker for the Kirby CMS, which supports a file preview (when available).

It uses the **excellent** jQuery plug-in of **[http://www.selectboxit.com](http://www.selectboxit.com)**

### Installation

- **[Download the .zip](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister)** and extract it to the root of your site.
- Optionally you can configure some settings in `site/config/config.php`.

### Config

By default, no `config` is needed. But you can set your text / string preferences like the one below;

```auto
c::set('lister_loading', 'I am building the asset list, please wait...');
c::set('lister_select', 'You have to select a file first...');

```

### Usage

Kirby LISTER is a field, like the others.

```auto
/* BLUEPRINT */
  lister_example:
    label: Choose your file...
    type: lister

```

* * *

```auto
/* TEMPLATE */
<?php echo $page->file($page->lister_example())->url(); ?>

```

* * *

![Kirby LISTER](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister/raw/master/kirby-lister_screencapture.gif "Kirby LISTER")

_Kirby LISTER - a file picker with a (pre-) view_

---

<div class="post-metadata">

**Author:** ![jenstornell](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/jenstornell/32/546_2.png) [@jenstornell](https://forum.getkirby.com/u/jenstornell)\
**Post date:** [July 17, 2016, 12:38pm UTC](https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706/2 "2016-07-17T12:38:13Z")

</div>

You don’t like this one?

> **[storypioneers/kirby-selector](https://github.com/storypioneers/kirby-selector)**
>
> kirby-selector - file selector panel field for Kirby CMS

---

<div class="post-metadata">

**Author:** ![1n3JgKl9pQ6cUMrW](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/1n3jgkl9pq6cumrw/32/2368_2.png) [@1n3JgKl9pQ6cUMrW](https://forum.getkirby.com/u/1n3JgKl9pQ6cUMrW)\
**Post date:** [July 17, 2016, 1:32pm UTC](https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706/3 "2016-07-17T13:32:29Z")

</div>

Nope 🙂

When you have many files, that one becames inane long - that’s why I created a pull-down list…

I had a portfolio page with about 100 images; the other plug-in did render 100 entries on one page, which became very long. So I prefered the other solution (which is not limited to images).

But I think it’s good people can choose what suites there needs / workflow!

* * *

 ![](https://europe1.discourse-cdn.com/flex017/uploads/getkirby/original/2X/8/85c122bbae4551e05cb012726c0cb3a36a8f5173.png)

_(…and a pulldown works more nicely in a modal)_

---

<div class="post-metadata">

**Author:** ![1n3JgKl9pQ6cUMrW](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/1n3jgkl9pq6cumrw/32/2368_2.png) [@1n3JgKl9pQ6cUMrW](https://forum.getkirby.com/u/1n3JgKl9pQ6cUMrW)\
**Post date:** [February 25, 2017, 12:19pm UTC](https://forum.getkirby.com/t/kirby-lister-a-file-picker-field-with-a-preview/4706/4 "2017-02-25T12:19:40Z")

</div>

Pushed **[https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister/](https://github.com/1n3JgKl9pQ6cUMrW/kirby-lister/)** so it works fine at pages with sub-pages (children) right now.

##Version 1.1.7 - 2017-02-25

1. Bugfix where subpages were treated like media-files.
2. Tested with Kirby 2.4