PHPackages                             beebmx/kirby-policy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Security](/categories/security)
4. /
5. beebmx/kirby-policy

ActiveKirby-plugin[Security](/categories/security)

beebmx/kirby-policy
===================

Blueprint Policies for Kirby

1.2.1(8mo ago)22164MITPHPPHP ^8.2CI passing

Since May 29Pushed 8mo ago3 watchersCompare

[ Source](https://github.com/beebmx/kirby-policy)[ Packagist](https://packagist.org/packages/beebmx/kirby-policy)[ RSS](/packages/beebmx-kirby-policy/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (8)Used By (0)

[![Kirby Policy Logo](https://github.com/beebmx/kirby-policy/raw/main/assets/logo.svg?raw=true)](https://github.com/beebmx/kirby-policy)

[![Build Status](https://camo.githubusercontent.com/37309f93c93307470c2a2aa37511c907db1822029a6f15d8ba90090e63e5d17e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f626565626d782f6b697262792d706f6c6963792f74657374732e796d6c3f6272616e63683d6d61696e)](https://github.com/beebmx/kirby-policy/actions)[![Total Downloads](https://camo.githubusercontent.com/3a181b7841984d28ffe4bcd6ccfaf787e4867213408ceb4a0b2554224a4a701b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626565626d782f6b697262792d706f6c696379)](https://packagist.org/packages/beebmx/kirby-policy)[![Latest Stable Version](https://camo.githubusercontent.com/acd9ebaf147fafb383b9a12be432fc9603499be62b55cfca295a6bde56ef5895/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626565626d782f6b697262792d706f6c696379)](https://packagist.org/packages/beebmx/kirby-policy)[![License](https://camo.githubusercontent.com/516130861108b0c7a643555627e5f5042737899bf0c17cf72cb5fc3b74c6c4eb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f626565626d782f6b697262792d706f6c696379)](https://packagist.org/packages/beebmx/kirby-policy)

Policy for Kirby
================

[](#policy-for-kirby)

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

---

Overview
--------

[](#overview)

- [1. Installation](#installation)
- [2. Usage](#usage)
- [3. Options](#options)
- [4. License](#license)
- [5. Credits](#credits)

Installation
------------

[](#installation)

### Download

[](#download)

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

### Composer

[](#composer)

```
composer require beebmx/kirby-policy

```

Usage
-----

[](#usage)

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

### File structure

[](#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

[](#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
-------

[](#options)

OptionDefaultTypesDescriptionbeebmx.policy.excludedusers`array` `string`Excluded blueprintsbeebmx.policy.suffixpolicy`string`Blueprint suffix (e.g. file.policy.yml)Warning

Since version `1.2.0`, `Policy` changes the plugin prefix from `beebmx.kirby-policy` to `beebmx.policy`.

License
-------

[](#license)

Licensed under the [MIT](LICENSE.md).

Credits
-------

[](#credits)

- Fernando Gutierrez [@beebmx](https://github.com/beebmx)
- [jonatanjonas](https://github.com/jonatanjonas) `logo`
- [All Contributors](../../contributors)

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance62

Regular maintenance activity

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~74 days

Recently: every ~111 days

Total

7

Last Release

262d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/434a3fd09c4701e824184e720b3d2fd97814ed8d1275417f6762c411bf146328?d=identicon)[beebmx](/maintainers/beebmx)

---

Top Contributors

[![beebmx](https://avatars.githubusercontent.com/u/2191576?v=4)](https://github.com/beebmx "beebmx (11 commits)")

---

Tags

kirby-pluginkirby4kirby5securitykirbykirby-pluginkirby5policiesPolicykirby4

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/beebmx-kirby-policy/health.svg)

```
[![Health](https://phpackages.com/badges/beebmx-kirby-policy/health.svg)](https://phpackages.com/packages/beebmx-kirby-policy)
```

###  Alternatives

[bnomei/kirby3-redirects

Setup performant HTTP Status Code Redirects from within the Kirby Panel

269.1k](/packages/bnomei-kirby3-redirects)[beebmx/kirby-env

Enable env variables to Kirby

2037.9k2](/packages/beebmx-kirby-env)[beebmx/kirby-courier

Courier offers a convenient and painless solution for creating emails tailored for your Kirby website.

403.0k2](/packages/beebmx-kirby-courier)[beebmx/kirby-db

Enable database support for Illuminate\\Database in Kirby

192.6k](/packages/beebmx-kirby-db)[wagnerwagner/merx

A toolkit to create online shops with Kirby

1152.7k](/packages/wagnerwagner-merx)[lyquidity/xml-signer

A PHP to create and verify XAdES signature

2164.6k1](/packages/lyquidity-xml-signer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)