sylvainjule/kirby-multilist

Quickly manage lists with multiple fields in Kirby

Installs: 1 948

Dependents: 0

Suggesters: 0

Security: 0

Stars: 45

Watchers: 3

Forks: 1

Open Issues: 4

Language:Vue

Type:kirby-plugin

1.0.1 2021-12-07 18:52 UTC

This package is auto-updated.

Last update: 2024-10-25 15:51:21 UTC


README

This plugin helps dealing with long lists with multiple fields.

multilist-screenshot


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

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