Sobrescrituras
Blockstudio permite sobrescribir bloques con un control muy granular. Esto puede resultar útil en bibliotecas de bloques compartidas si quieres cambiar el comportamiento de un bloque sin tener que crear uno nuevo desde cero.
block.json
Para empezar, establece como clave name el nombre del bloque que quieras sobrescribir y establece la clave override en true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
Si la propiedad override está establecida en true, los datos del nuevo block.json se combinarán con los del bloque original. Esto te permite sobrescribir cualquier propiedad del bloque original.
Atributos
Los atributos se pueden sobrescribir mediante id o añadir. Por ejemplo, imagina que queremos sobrescribir el atributo width de un bloque y añadir un nuevo atributo 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"
}
]
}
}
Si se encuentra un atributo con el mismo id, sus datos se combinarán con los del atributo original. Los atributos que no se encuentren se añadirán al bloque.
Advertencia
Al sobrescribir atributos, debes proporcionar el
typedel atributo original, aunque no cambie.
Estructuras complejas
Al sobrescribir atributos con estructuras complejas (repetidores, grupos, pestañas, etc.), debes proporcionar la estructura completa del atributo hasta el elemento que quieras sobrescribir.
{
"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"
}
]
}
]
}
]
}
]
}
}
Recursos
Los archivos de recursos se reemplazarán cuando coincida el nombre del archivo. Por ejemplo, si existe un archivo style.css en el bloque original, se reemplazará por el archivo style.css del bloque que lo sobrescribe. Los archivos cuyos nombres no coincidan con los del bloque original se añadirán al bloque.
Plantilla de renderizado
Las plantillas de renderizado se pueden sobrescribir proporcionando un nuevo archivo de plantilla: index.php, index.twig o index.blade.php.
Bloques Twig
Las plantillas Twig se pueden sobrescribir con más detalle mediante la función de bloques de Twig.
Imaginemos la siguiente plantilla de renderizado para un bloque de imagen ficticio:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
En lugar de reemplazar toda la plantilla, podemos usar la función extends de Twig para sobrescribir ciertas partes y conservar el resto intacto.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}