pixelopen/kirby-customizable-layout

A plugin for Kirby CMS to add customization to layouts

1.0.2 2024-07-01 08:58 UTC

This package is auto-updated.

Last update: 2024-10-31 00:26:46 UTC


README

GitHub release (with filter)

Dependency

A plugin for Kirby CMS to add a customizable layout fields

Commercial Usage

This plugin is free

Installation

Download

Download the files and place them inside site/plugins/kirby-customizable-layout.

Composer

composer require pixelopen/kirby-customizable-layout

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

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.

<?php snippet('customizable-layout', array('field' => $page->layout()))?>

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"