Saltar al contenido

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.

JSON
{
  "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.

JSON
{
  "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 type del 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.

JSON
{
  "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:

Twig
<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.

Twig
{% extends 'index.twig' %}

{% block image %}
  <figure>
    <img src="{{ image.url }}" class="image" />
    <figcaption>{{ image.caption }}</figcaption>
  </figure>
{% endblock %}