PHPackages                             pixelopen/kirby-customizable-layout - 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. [Utility & Helpers](/categories/utility)
4. /
5. pixelopen/kirby-customizable-layout

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

pixelopen/kirby-customizable-layout
===================================

A plugin for Kirby CMS to add customization to layouts

1.0.2(1y ago)150MITPHPPHP >=8.0.0

Since Oct 4Pushed 1y ago2 watchersCompare

[ Source](https://github.com/Pixel-Open/kirby-customizable-layout)[ Packagist](https://packagist.org/packages/pixelopen/kirby-customizable-layout)[ Docs](https://github.com/Pixel-Open/customizable-layout)[ RSS](/packages/pixelopen-kirby-customizable-layout/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

Kirby Customizable Layout plugin
================================

[](#kirby-customizable-layout-plugin)

[![GitHub release (with filter)](https://camo.githubusercontent.com/4ce91a8841b5c74844d910749dcd6a0ed28b327795313b05b7c3fc61f1690ba4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f506978656c2d4f70656e2f6b697262792d637573746f6d697a61626c652d6c61796f75743f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/4ce91a8841b5c74844d910749dcd6a0ed28b327795313b05b7c3fc61f1690ba4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f506978656c2d4f70656e2f6b697262792d637573746f6d697a61626c652d6c61796f75743f7374796c653d666f722d7468652d6261646765)

[![Dependency](https://camo.githubusercontent.com/5adcc750f8016bd604719a78bd26323bc265c681ad43e507a5cbe771abc91065/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6b697262792d342e782d6363613030302e7376673f7374796c653d666f722d7468652d6261646765)](https://getkirby.com/)

A plugin for [Kirby CMS](http://getkirby.com) to add a customizable layout fields

Commercial Usage
----------------

[](#commercial-usage)

This plugin is free

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

[](#installation)

### Download

[](#download)

[Download the files](https://github.com/Pixel-Open/kirby-customizable-layout/releases) and place them inside `site/plugins/kirby-customizable-layout`.

### Composer

[](#composer)

```
composer require pixelopen/kirby-customizable-layout

```

### Git Submodule

[](#git-submodule)

You can add the plugin as a Git submodule.

```
$ cd your/project/root
$ git submodule add https://github.com/Pixel-Open/kirby-customizable-layout.git site/plugins/kirby-customizable-layout
$ git submodule update --init --recursive
$ git commit -am "Add Kirby Customizable Layout plugin"

```

Run these commands to update the plugin:

```
$ cd your/project/root
$ git submodule foreach git checkout master
$ git submodule foreach git pull
$ git commit -am "Update submodules"
$ git submodule update --init --recursive

```

Options
-------

[](#options)

To add a customizable layout field in your blueprint, you only have to extend `fields/customizable-layout`

For now, you need to add the fieldsets `block-settings` with the following lines in your `/site/config/config.php`:

```
return [
    'blocks' => [
        'fieldsets' => [
            'custom' => [
                'label' => 'Custom blocks',
                'type' => 'group',
                'fieldsets' => [
                    'block-settings',
                    // Other global custom blocks
                ]
            ],
          'kirby' => [
                'label' => 'Kirby blocks',
                'type' => 'group',
                'fieldsets' => [
                    'heading',
                    'text',
                    'list',
                    'quote',
                    'image',
                    'video',
                    'code',
                    'markdown'
                ]
            ]
        ]
    ]
];
```

You can also add your own fieldsets when you extend the fields, to add the `block-settings` block and all the other block you want to use.

Dont forget to call the snippet in the page where you use the plugin.

```

```

The plugin work with color field from Kirby 4, you must create a new fields with your custom colors at `/site/blueprints/fields/color.yml`:

```
type: color
mode: options
options:
  color1: "#color1"
  color2: "#color2"
  color3: "#color3"
  color4: "#color4"
  color5: "#color5"
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.8% 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 ~135 days

Total

3

Last Release

680d ago

PHP version history (2 changes)1.0.0PHP >=8.0.0 <8.3.0

1.0.2PHP >=8.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/d2b87043ea111a9f5d76ffa990f48eea6e80576483c7bf33f0dcdd5a899c15c8?d=identicon)[pixeldev](/maintainers/pixeldev)

---

Top Contributors

[![Kastrox7](https://avatars.githubusercontent.com/u/72515644?v=4)](https://github.com/Kastrox7 "Kastrox7 (11 commits)")[![matthieu2607](https://avatars.githubusercontent.com/u/14790414?v=4)](https://github.com/matthieu2607 "matthieu2607 (5 commits)")

---

Tags

kirbykirby-pluginkirby-cms

###  Code Quality

Code StyleECS

### Embed Badge

![Health badge](/badges/pixelopen-kirby-customizable-layout/health.svg)

```
[![Health](https://phpackages.com/badges/pixelopen-kirby-customizable-layout/health.svg)](https://phpackages.com/packages/pixelopen-kirby-customizable-layout)
```

###  Alternatives

[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8713.4k](/packages/belugadigital-kirby-navigation)[bnomei/kirby3-dotenv

Kirby Plugin for environment variables from .env

4144.1k1](/packages/bnomei-kirby3-dotenv)[oblik/kirby-link-field

Kirby 4 field for all types of links.

7650.6k2](/packages/oblik-kirby-link-field)[bnomei/kirby3-recently-modified

Kirby Section to display recently modified content pages

309.3k](/packages/bnomei-kirby3-recently-modified)[moritzebeling/kirby-favicon

Kirby plugin to meet all favicon needs

144.8k](/packages/moritzebeling-kirby-favicon)[tobimori/kirby-tailwind-merge

Tailwind Merge for Kirby CMS

276.3k](/packages/tobimori-kirby-tailwind-merge)

PHPackages © 2026

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