This plugin allows you to reference other blocks. Thus, you can easily repeat a block in multiple places on your page while being able to update it in one central place.
Use one of the following methods to install & use tearoom1/kirby-block-reference:
If you know your way around Git, you can download this plugin as a submodule:
git submodule add https://github.com/tearoom1/kirby-block-reference.git site/plugins/kirby-block-reference
composer require tearoom1/kirby-block-reference
- Clone or download this repository from github: https://github.com/tearoom1/kirby-block-reference.git
- Unzip / Move the folder to
site/plugins.
Use the block by adding it to you blueprints fieldsets if they are defined:
fieldsets:
- referenceThe plugin exposes two API routes that the panel block UI uses to look up reference targets: getAllPages (list page IDs) and blocks (return the blocks of a given page, including drafts). Both routes require a logged-in panel user; they return 401 Unauthorized for anonymous callers.
By default, only admins can use the reference picker. Non-admin roles can be allowed explicitly:
// site/config/config.php
'tearoom1.kirby-block-reference.allowedRoles' => [
'editor',
],The page picker and API routes also check Kirby's page read permission for every target page. Users only see pages they are allowed to read.
This plugin is licensed under the MIT License
- Developed by Mathis Koblin
Screenshots use sample content at 1408 × 902 pixels. Panel views are cropped to the content area. The main image uses the light theme.
| View | Light | Dark |
|---|---|---|
| Overview | Light | Dark |