Policy for Kirby

An easy way to display different content in your Kirby panel for different user roles.

Overview

• 1. Installation
• 2. Usage
• 3. Options
• 4. License
• 5. Credits

Installation

Download

Download and copy this repository to /site/plugins/kirby-policy.

Composer

composer require beebmx/kirby-policy

Usage

You can create your YAML files as usual; you only need to follow a file structure and file content.

File structure

In your blueprints directory, you can place your YAML files with the suffix policy:

blueprints
  ├── pages
  │   ├── default.yml
  │   ├── home.policy.yml
  │   ├── simple.policy.yml
  │   ├── multiple.policy.yml
  │   ├── content.yml
  │   ├── blog.yml
  │   └── post.policy.yml
  ├── users
  │   ├── admin.yml
  │   └── editor.yml
  └── site.yml

[!CAUTION] You cannot have a file without the prefix to avoid ignoring the policy file e.g. home.yml and home.policy.yml (just use home.policy.yml)

File Content

The content of your YAML file need to add a policy property with the user role to every element than you need to customize:

title: Page

tabs:

  # Only an admin will see the admin tab
  admin:
    label: Admin
    policy: admin

    columns:

      main:
        type: fields
        fields:

          item:
            label: Item
            type: text

  content:
    label: Content
    icon: page

    columns:

      main:
        width: 2/3
        sections:
          content:
            type: fields
            fields:
              text:
                label: Text
                type: text

              # Only an admin will see the admin field
              admin:
                label: Admin
                type: text
                policy:
                  - admin

              # Only an editor will see the editor field
              editor:
                label: Editor
                type: text
                policy:
                  - editor

              # An admin and editor will see the mixed field
              mixed:
                label: Mixed
                type: text
                policy:
                  - admin
                  - editor

      sidebar:
        sticky: true
        width: 1/3
        sections:
          pages:
            type: pages
            template: default
          files:
            type: files

[!NOTE] The policy property can be a string or an array of roles

Options

[!WARNING] Since version 1.2.0, Policy changes the plugin prefix from beebmx.kirby-policy to beebmx.policy.

License

Licensed under the MIT.

Credits

• Fernando Gutierrez @beebmx
• jonatanjonas logo
• All Contributors