README

This plugin helps dealing with long lists with multiple fields, by allowing to edit some field types (date, select, tags, text, etc. → listed here) directly from within a structure table without opening the items drawers. Think of it as an inline structure field, or a multi-fields entries list.

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, you can consider making a donation of your choice.

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

1. Installation

Kirby 3, 4: up to 1.0.2 (untested). Kirby 5: 1.1.0+.

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

Since 1.1.0, you can use the structure's columns option to display only a few fields in the table, and edit them all in the usual structure drawer.

3. Supported fields

The field supports all inline field types:

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

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

4. Field properties

You have access to all the Structure field properties.

5. Front-end usage

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

6. Responsive

The field behaves like any Structure field: on mobile only the first column will be shown. All the fields remain editable in the usual structure drawer.

7. License

MIT