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

sylvainjule / kirby-multilist

Maintainers

Details