PHPackages timoetting/kirby-builder - 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. timoetting/kirby-builder AbandonedArchivedKirby-plugin[Utility & Helpers](/categories/utility) timoetting/kirby-builder ======================== This versatile plugin for Kirby CMS (v3) lets you predefine content blocks with different field sets that can then be added, edited and arranged inside Kirby's panel. 2.0.16(5y ago)40535.9k51[17 PRs](https://github.com/TimOetting/kirby-builder/pulls)1MITVuePHP >=7.1.0 Since Apr 29Pushed 3y ago24 watchersCompare [ Source](https://github.com/TimOetting/kirby-builder)[ Packagist](https://packagist.org/packages/timoetting/kirby-builder)[ Fund](https://paypal.me/TimOetting/10)[ RSS](/packages/timoetting-kirby-builder/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (1)Versions (31)Used By (1) Kirby Builder (deprecated) ========================== [](#kirby-builder-deprecated) ⚠️⚠️⚠️ **This Plugin is deprecated and is no longer maintained, as its functionality can be replaced by the native [Blocks Field](https://getkirby.com/docs/reference/panel/fields/blocks) and [Layout Field](https://getkirby.com/docs/reference/panel/fields/layout)** ⚠️⚠️⚠️ --- This versatile plugin for [Kirby CMS](https://a.paddle.com/v2/click/1129/38717?link=1170) (>= v3.0.1) lets you predefine content blocks with different field sets that can then be added, edited and arranged inside Kirby's panel. The legacy version for Kirby 2 can be found under [this branch](https://github.com/TimOetting/kirby-builder/tree/kirby_v2). Commercial Use -------------- [](#commercial-use) Kirby Builder can be used in so many different extents. You know best how big the value is that you get out of this plugin. Please pay what (and if) you want. [PayPal.me Link](https://www.paypal.me/TimOetting/10) Another way to support this plugin is to buy a Kirby Licence via this affiliate link with no extra costs for you. You need that licence anyway, right? 😉 [Buy a Kirby licence](https://a.paddle.com/v2/click/1129/38717?link=1170) Preview ------- [](#preview) [![Kirby Builder Screenshot](https://raw.githubusercontent.com/TimOetting/kirby-builder/master/PREVIEW.png)](https://raw.githubusercontent.com/TimOetting/kirby-builder/master/PREVIEW.png) Installation ------------ [](#installation) ### Git [](#git) From the root of your kirby project: ``` git clone https://github.com/TimOetting/kirby-builder.git site/plugins/kirby-builder ``` ### Composer [](#composer) ``` composer require timoetting/kirby-builder ``` ### Direct Download [](#direct-download) Alternatively you can download the zip file, unzip it's contents into site/plugins/kirby-builder. Example Blueprint Structure --------------------------- [](#example-blueprint-structure) ``` # inside the fields section of your blueprint: mybuilder: label: Page Builder type: builder columns: 1 # Optional. If set to 2 or more, the builder blocks will be placed in a grid. max: 10 # Optional. Limits the number of builder blocks that can be added. fieldsets: quote: # This is a field set. It contains a group of kirby fields. The user can select from these sets to build the content. name: Quote # The name option is used as a label for the buttons to add new fieldsets. It is also used as a label in the header of the fieldset, if the label option is not set explicitly (see next line). label: Quote by {{citation}} # Optional. The label option can be used to override the header text of the fieldset. The 'mustache' syntax can be used to include the value of any field of the fieldset. preview: # Optional. If defined, a preview of the fieldset can be rendered by the specified snippet from within the snippets folder. snippet: blocks/quote css: /assets/css/blocks/quote.css defaultView: preview # Optional. If the value "preview" is set, the block will show the preview when the page is loaded in the panel. If the value is a tab name, the respective tab is preselected when the page is loaded. Newly created blocks ignore this value and have the edit mode or the first tab preselected. fields: text: label: Quote Text type: textarea citation: label: Citation type: text bodytext: name: Text tabs: # Optional. Tabs can be used to group the fields of a field set. In this example, we use one tab to contain the content related fields and one for styling settings. It makes no difference for the content handling in the template if there are tabs or not. content: label: Content icon: edit # Optional. This icon appears next to the tab. The icon name can be chosen from the Kirby's icon set getkirby.com/docs/reference/ui/icon fields: text: label: text type: textarea style: label: Style icon: cog fields: fontfamily: label: Font type: select options: helvetica: Helvetica comicsans: Comic Sans fontsize: label: Font Size type: number events: name: Events preview: snippet: blocks/events css: /assets/css/blocks/events.css fields: eventlist: # The Builder Field can even be nested! type: builder label: Event List columns: 2 fieldsets: event: label: Event fields: title: label: Title type: text text: label: Description type: textarea date: label: Date type: date calltoaction: blocks/calltoaction # the Builder Field blueprint can be rather complex. It is therefore recommended to organize your fieldsets in single files. This example would take the content of the file /site/blueprints/blocks/calltoaction.yml and use it for the fieldset "calltoaction". ``` Template Usage -------------- [](#template-usage) There are different ways to use the builder field inside a template. A clean approach for this is to use different snippets inside `site/snippets/blocks/` that have the same file name like the field set names in the blueprint. In this case, we use the same snippet that we used for the preview inside the panel. ``` ``` The `toBuilderBlocks` method converts the builder field to a Kirby Collection which makes it possible to use Kirby's chaining syntax. Under the hood it is an alias for the `toStructure` method. The quote snippet, for example, could then be rendered by this snippet: ``` ``` ### Licence [](#licence) [MIT](https://opensource.org/licenses/MIT) ### Health Score 44 — FairBetter than 92% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity47 Moderate usage in the ecosystem Community29 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~47 days Recently: every ~128 days Total 15 Last Release 2007d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1b078d7b5e2a6d7b6b5845cdb6db319504d0089d84d88e364d3e7699e5eecd42?d=identicon)[TimOetting](/maintainers/TimOetting) --- Top Contributors [![TimOetting](https://avatars.githubusercontent.com/u/5142881?v=4)](https://github.com/TimOetting "TimOetting (27 commits)")[![dionysiusmarquis](https://avatars.githubusercontent.com/u/4398428?v=4)](https://github.com/dionysiusmarquis "dionysiusmarquis (19 commits)")[![OlegIvaniv](https://avatars.githubusercontent.com/u/12657221?v=4)](https://github.com/OlegIvaniv "OlegIvaniv (3 commits)")[![olach](https://avatars.githubusercontent.com/u/1300644?v=4)](https://github.com/olach "olach (3 commits)")[![johannschopplich](https://avatars.githubusercontent.com/u/27850750?v=4)](https://github.com/johannschopplich "johannschopplich (2 commits)")[![Thiousi](https://avatars.githubusercontent.com/u/4822666?v=4)](https://github.com/Thiousi "Thiousi (1 commits)")[![crealistiques](https://avatars.githubusercontent.com/u/6192571?v=4)](https://github.com/crealistiques "crealistiques (1 commits)")[![tobiasfabian](https://avatars.githubusercontent.com/u/1524319?v=4)](https://github.com/tobiasfabian "tobiasfabian (1 commits)")[![jorgemartins](https://avatars.githubusercontent.com/u/1323193?v=4)](https://github.com/jorgemartins "jorgemartins (1 commits)")[![LeBenLeBen](https://avatars.githubusercontent.com/u/793344?v=4)](https://github.com/LeBenLeBen "LeBenLeBen (1 commits)")[![mcbrwr](https://avatars.githubusercontent.com/u/1662038?v=4)](https://github.com/mcbrwr "mcbrwr (1 commits)")[![steirico](https://avatars.githubusercontent.com/u/10421363?v=4)](https://github.com/steirico "steirico (1 commits)") --- Tags builderkirby3page builderkirby3-pluginkirby3-cmskirby-builder ### Embed Badge ![Health badge](/badges/timoetting-kirby-builder/health.svg) ``` [![Health](https://phpackages.com/badges/timoetting-kirby-builder/health.svg)](https://phpackages.com/packages/timoetting-kirby-builder) ``` ### Alternatives [fabianmichael/kirby-meta Your all-in-one powerhouse for any SEO and metadata needs imaginable. 6910.7k1](/packages/fabianmichael-kirby-meta)[arnoson/kirby-vite Vite helper for Kirby CMS 9759.2k3](/packages/arnoson-kirby-vite)[bvdputte/kirby-fingerprint Cache-busting utility to fingerprint assets (JS/CSS) in Kirby 3 1610.0k](/packages/bvdputte-kirby-fingerprint)[schnti/cachebuster A plugin for Kirby 3 CMS to add modification timestamps to css and js files 108.3k1](/packages/schnti-cachebuster)[bnomei/kirby3-php-cachedriver PHP based Cache-Driver 112.6k](/packages/bnomei-kirby3-php-cachedriver) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)