Prepísania
Blockstudio umožňuje prepisovať bloky na veľmi podrobnej úrovni. Hodí sa to pri zdieľaných knižniciach blokov, keď chcete zmeniť správanie bloku bez vytvárania nového bloku od začiatku.
block.json
Začnite tým, že názov bloku, ktorý chcete prepísať, nastavíte ako kľúč name a kľúč override nastavíte na hodnotu true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Keď je vlastnosť override nastavená na hodnotu true, údaje z nového block.json sa zlúčia s údajmi pôvodného bloku. To znamená, že môžete prepísať ktorúkoľvek vlastnosť pôvodného bloku.
Atribúty
Atribúty možno prepísať pomocou id alebo ich pridať navyše. Predstavme si napríklad, že chceme prepísať atribút width bloku a pridať nový atribút height.
{
"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"
}
]
}
}
Keď sa nájde atribút s rovnakým id, jeho údaje sa zlúčia s pôvodným atribútom. Atribúty, ktoré sa nenájdu, sa pridajú do bloku.
Upozornenie
Pri prepisovaní atribútov musíte uviesť
typepôvodného atribútu, aj keď zostáva rovnaké.
Zložité štruktúry
Pri prepisovaní atribútov so zložitými štruktúrami (opakovače, skupiny, karty atď.) musíte uviesť úplnú štruktúru atribútu až po položku, ktorú chcete prepísať.
{
"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"
}
]
}
]
}
]
}
]
}
}
Zdroje
Súbory prostriedkov sa nahradia, ak sa zhoduje názov súboru. Ak napríklad v pôvodnom bloku existuje súbor style.css, v prepísanom bloku ho nahradí súbor style.css. Súbory s názvami, ktoré sa nezhodujú s názvami súborov pôvodného bloku, sa pridajú do bloku.
Šablóna vykresľovania
Šablóny vykresľovania možno prepísať zadaním nového súboru šablóny, teda index.php, index.twig alebo index.blade.php.
Bloky Twig
Šablóny Twig možno prepisovať podrobnejšie pomocou funkcie blokov v Twig.
Predstavme si nasledujúcu šablónu vykresľovania fiktívneho bloku obrázka:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Namiesto nahradenia celej šablóny môžeme použiť funkciu extends nástroja Twig na prepísanie určitých častí šablóny a zachovanie zvyšku.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}