popnoire/site/OFF_plugins/quickselect/README.md

28 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2026-02-12 15:22:46 +01:00
# Kirby Quickselect v1.3 <a href="https://www.paypal.me/medienbaecker"><img width="99" src="http://www.medienbaecker.com/beer.png" alt="Buy me a beer" align="right"></a>
This field is based on the core select field and adds a filter and placeholder functionality. It uses the [select2](https://github.com/select2/select2) jQuery plugin.
When displaying the images of a page with `options: images` it will display thumbs automatically.
## Installation
Simply put the `quickselect` folder into your `site/plugins` folder.
## Example
![Preview](https://user-images.githubusercontent.com/7975568/27504121-082d8ca4-5885-11e7-8983-9159593cdbb4.gif)
````
featured:
label: Image
type: quickselect
options: images
placeholder: Choose an image...
````
Just like you do with the regular `select` field, you can specify what elements should be listed. `pages`, `children`, `files`, `images`, [...](https://getkirby.com/docs/cheatsheet/panel-fields/select). Even a more complex `query` or options from another field.
Anything that's printed in the list can be searched for. So if you set the `text` of a `query` to `{{title}} ({{uri}})`, you can find pages by their ancestors, too.
Compared to the core `select` field, you can also define a `placeholder` that can make things clearer for the editor.