Cacao Kit

Demo & halbe Dokumentation

Einen Block hinzufügen


Ein neuer Block entsteht in drei Schritten: ein Blueprint im Backend, bei Bedarf ein Resolver und eine Komponente im Frontend. Nach diesem Muster ist der Karten-Block auf der Seite „Über das Projekt“ gebaut.

Im Backend

  1. Lege site/blueprints/blocks/cards.yml mit den Feldern an, die der Block braucht – hier eine Struktur aus Karten mit Titel, Bild, Text und Link. Nimm den Block dann in site/blueprints/fields/layouts.yml und site/blueprints/fields/blocks.yml auf, damit er sich im Panel einfügen lässt.

  2. Reichen die rohen Feldwerte nicht aus, ergänze einen Resolver in site/config/blocks-resolver.php. cards:cards macht aus jeder Bild-UUID Bilddaten und aus jedem Seitenlink einen Pfad.


Im Frontend

Lege die Komponente app/components/Kirby/Block/Cards.vue an. Nuxt registriert sie als KirbyBlockCards; trag ihre Lazy-Variante unter dem Blocktyp cards in die Zuordnung in app/components/Kirby/Blocks.vue ein.

Die Komponente bekommt den Block als Prop block. Typisiere ihn mit KirbyBlock aus kirby-types und beschreibe den aufgelösten Inhalt, damit das Template weiß, was das Backend schickt.