sylvainjule/kirby-multilist

Quickly manage lists with multiple fields in Kirby

1.0.1 2021-12-07 18:52 UTC

Requires

• getkirby/composer-installer: ^1.1

MIT

• Sylvain Julé

README

This plugin helps dealing with long lists with multiple fields.

Overview

This plugin is completely free and published under the MIT license. However, if you are using it in a commercial project and want to help me keep up with maintenance, please consider making a donation of your choice or purchasing your license(s) through my affiliate link.

• 1. Installation
• 2. Setup
• 3. Supported fields
• 4. Field properties
• 5. Front-end usage
• 6. Drawbacks
• 7. License

1. Installation

Download and copy this repository to /site/plugins/multilist

Alternatively, you can install it with composer: composer require sylvainjule/kirby-multilist

2. Setup

Use is as you would use a Structure :

multilist:
  label: Multilist example
  type: multilist
  fields:
    name:
      label: Item name
      type: text
    date:
      label: Release date
      type: date
    toggle:
      label: Listed?
      type: toggle

3. Supported fields

The field supports all inline field types:

• text
• url
• email
• select
• multiselect
• number
• tel
• tags
• range
• toggle
• time
• date
• hidden

More complex fields (files, pages, blocks, layout, etc.) are not supported.

4. Field properties

You have access to a lot of the Structure field properties, with a few tweaks:

• There is no columns property, instead you can directly set a width: x/x property on your inner fields.
• There is no duplicate property.

5. Front-end usage

Use it as you would use a structure field, with either the ->toStructure() ou ->yaml() method.

6. Drawbacks

I have intended this field for websites where editors edit content on desktops. Due to the complex naure of the field, it doesn't have any mobile aternate view.

7. License

MIT