Überschreibungen
Blockstudio bietet die Möglichkeit, Blöcke sehr gezielt zu überschreiben. Das kann bei gemeinsam genutzten Blockbibliotheken nützlich sein, wenn du das Verhalten eines Blocks ändern möchtest, ohne ihn von Grund auf neu erstellen zu müssen.
block.json
Lege zunächst den Namen des Blocks, den du überschreiben möchtest, als Schlüssel name fest und setze den Schlüssel override auf true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Wenn die Eigenschaft override auf true gesetzt ist, werden die Daten des neuen block.json mit den Daten des ursprünglichen Blocks zusammengeführt. So kannst du jede Eigenschaft des ursprünglichen Blocks überschreiben.
Attribute
Attribute lassen sich entweder durch id überschreiben oder zusätzlich hinzufügen. Angenommen, wir möchten das Attribut width eines Blocks überschreiben und ein neues Attribut height hinzufügen.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "width",
"type": "number",
"default": 280,
"label": "Override width"
},
{
"id": "height",
"type": "number",
"default": 280,
"label": "New height"
}
]
}
}
Wird ein Attribut mit demselben id gefunden, werden seine Daten mit dem ursprünglichen Attribut zusammengeführt. Nicht gefundene Attribute werden dem Block hinzugefügt.
Warnung
Beim Überschreiben von Attributen musst du das
typedes ursprünglichen Attributs angeben, auch wenn es unverändert bleibt.
Komplexe Strukturen
Wenn du Attribute mit komplexen Strukturen überschreibst (Repeater, Gruppen, Tabs usw.), musst du die vollständige Struktur des Attributs bis zu dem Eintrag angeben, der überschrieben werden soll.
{
"name": "blockstudio/my-block",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "tabs",
"type": "tabs",
"tabs": [
{
"id": "tab1",
"attributes": [
{
"key": "group1",
"type": "group",
"title": "Group",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
},
{
"id": "tab2",
"title": "Override tab",
"attributes": [
{
"id": "group",
"type": "group",
"title": "Group ID",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
}
]
}
]
}
}
Assets
Asset-Dateien werden ersetzt, wenn der Dateiname übereinstimmt. Wenn beispielsweise im ursprünglichen Block eine Datei style.css vorhanden ist, wird sie durch die Datei style.css im überschreibenden Block ersetzt. Dateien mit Namen, die nicht mit denen im ursprünglichen Block übereinstimmen, werden dem Block hinzugefügt.
Rendering-Vorlage
Rendering-Vorlagen lassen sich überschreiben, indem du eine neue Vorlagendatei bereitstellst: index.php, index.twig oder index.blade.php.
Twig-Blöcke
Twig-Vorlagen lassen sich mit dem Block-Feature von Twig noch gezielter überschreiben.
Stell dir folgende Rendering-Vorlage für einen fiktiven Bildblock vor:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Anstatt die gesamte Vorlage zu ersetzen, können wir mit Twigs extends-Feature bestimmte Teile der Vorlage überschreiben und den Rest beibehalten.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}