Suprascrieri
Blockstudio include posibilitatea de a suprascrie blocuri la un nivel foarte granular. Acest lucru poate fi util pentru bibliotecile de blocuri partajate, când doriți să schimbați comportamentul unui bloc fără a crea unul nou de la zero.
block.json
Pentru a începe, setați numele blocului pe care doriți să-l suprascrieți drept cheia name și setați cheia override la true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Când proprietatea override este setată la true, datele din noul block.json sunt îmbinate cu datele blocului original. Astfel, puteți suprascrie orice proprietate a blocului original.
Atribute
Atributele pot fi suprascrise prin id sau pot fi adăugate în plus. De exemplu, să presupunem că dorim să suprascriem atributul width al unui bloc și să adăugăm un atribut height nou.
{
"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"
}
]
}
}
Când este găsit un atribut cu același id, datele vor fi îmbinate cu atributul original. Atributele care nu sunt găsite vor fi adăugate blocului.
Avertisment
Când suprascrieți atribute, trebuie să furnizați
typeatributului original, chiar dacă rămâne neschimbat.
Structuri complexe
Când suprascrieți atribute cu structuri complexe (repetitoare, grupuri, file etc.), trebuie să furnizați structura completă a atributului până la elementul care trebuie suprascris.
{
"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"
}
]
}
]
}
]
}
]
}
}
Resurse
Fișierele cu resurse sunt înlocuite când numele fișierului corespunde. De exemplu, dacă există un fișier style.css în blocul original, acesta va fi înlocuit cu fișierul style.css din blocul care îl suprascrie. Fișierele cu nume care nu corespund celor din blocul original vor fi adăugate blocului.
Șablonul de randare
Șabloanele de randare pot fi suprascrise furnizând un nou fișier de șablon: index.php, index.twig sau index.blade.php.
Blocuri Twig
Șabloanele Twig pot fi suprascrise la un nivel mai granular folosind funcționalitatea bloc din Twig.
Să presupunem că avem următorul șablon de randare pentru un bloc fictiv de imagine:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
În loc să înlocuim întregul șablon, putem folosi funcționalitatea extends din Twig pentru a suprascrie anumite părți ale șablonului, păstrând restul neschimbat.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}