Ülekirjutused
Blockstudio võimaldab plokke väga üksikasjalikult üle kirjutada. See võib olla kasulik jagatud plokiteekide puhul, kui soovid ploki käitumist muuta, ilma et peaksid uut plokki algusest peale looma.
block.json
Alustamiseks määra üle kirjutatava ploki nimi võtme name väärtuseks ja määra võtme override väärtuseks true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Kui atribuudi override väärtuseks on määratud true, liidetakse uue block.json andmed algse ploki andmetega. See tähendab, et saad üle kirjutada algse ploki mis tahes atribuudi.
Atribuudid
Atribuute saab kas id abil üle kirjutada või täiendavalt lisada. Kujutame näiteks ette, et soovime ploki atribuudi width üle kirjutada ja lisada uue atribuudi 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"
}
]
}
}
Kui leitakse sama id-ga atribuut, liidetakse andmed algse atribuudi andmetega. Plokki lisatakse atribuudid, mida ei leita.
Hoiatus
Atribuutide ülekirjutamisel pead esitama algse atribuudi
type, isegi kui see jääb samaks.
Keerukad struktuurid
Keerukate struktuuridega atribuute (kordusväljad, grupid, sakid jne) üle kirjutades pead esitama atribuudi täieliku struktuuri kuni ülekirjutatava üksuseni.
{
"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"
}
]
}
]
}
]
}
]
}
}
Varad
Varafailid asendatakse, kui failinimed kattuvad. Näiteks kui algses plokis on fail style.css, asendatakse see faili style.css-ga, mis asub ülekirjutavas plokis. Algse ploki nimedega mittekattuvad failid lisatakse plokki.
Renderdusmall
Renderdusmalle saab üle kirjutada uue mallifailiga, mille nimi on kas index.php, index.twig või index.blade.php.
Twig plokid
Twig malle saab üksikasjalikumalt üle kirjutada, kasutades funktsiooni block asukohas Twig.
Kujutame ette järgmist näidispildi ploki renderdusmalli:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
Kogu malli asendamise asemel saame kasutada Twig extends funktsiooni, et kirjutada üle malli valitud osad, jättes ülejäänu alles.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}