# Mukautetut lohkot 3 tiedostossa

Ei JavaScript:tä, koontivaihetta tai mallikoodia.

## Määritä kentät JSON-tiedostossa

Lisää `blockstudio`-avain kohteeseen block.json. Määritä attribuutit tyypeillä, kuten `text`, `toggle` ja `color`. Blockstudio luo editorin UI automaattisesti. Se sisältää 27 kenttätyyppiä tekstikentistä toistimiin ja koodieditoreihin sekä itse rekisteröimiäsi kenttätyyppejä.

Täysi JSON-skeematuki tarjoaa automaattisen täydennyksen ja tarkistuksen palveluissa VS Code ja PhpStorm sekä kaikissa yhteensopivissa editoreissa.

Jokainen kenttä voi määrittää `default`-arvon uusille lohkoille ja `fallback`-arvon, jonka malli saa kentän ollessa tyhjä.

[Kenttätyyppien hakuteos](https://blockstudio.dev/fi/docs/blocks/attributes/field-types/)

block.json

```
{
  "name": "starter/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "showCta", "type": "toggle", "label": "Show CTA" },
      { "id": "background", "type": "color", "label": "Background" }
    ]
  }
}
```

## Kolmen tiedoston työnkulku

block.json kenttiä varten, mallipohja merkintäkieltä varten ja valinnainen tyylitiedosto.

## React kohteessa PHP

RichText, InnerBlocks ja useBlockProps toimivat suoraan kohteissa PHP, Twig tai Blade.

## SCSS ja Tailwind

Käytä CSS- tai SCSS-määritystä tai Tailwind-määritystä. SCSS tukee tuontipolkuja ja yhteistä alkumääritystä, ja sisäkkäisen osan muokkaaminen kääntää uudelleen kaikki sitä tuovat tiedostot.

## 27 kenttätyyppiä

Teksti, väri, kuva, toistin, valinta, koodieditori ja paljon muuta määritetään kohteessa JSON.

## JSON Schema

Automaattinen täydennys ja tarkistus palveluissa VS Code ja PhpStorm sekä yhteensopivissa editoreissa.

## Kolme mallipohjakieltä

PHP, Twig ja Blade käyttävät samoja muuttujia ja komponentteja.

## npm-tuonnit

Tuo paketteja kohteessa script.js. Tuotannossa ne ovat paikallisia, ja editorissa ne toimitetaan CDN-palvelun kautta.

## Interactivity API

Ota WordPress Interactivity API käyttöön yhdellä lipulla.

## React-komponentit PHP-mallipohjissa

Käytä `<RichText />`-toimintoa tekstin muokkaamiseen ja staattiseen käyttöliittymän HTML-toimintoon, `<InnerBlocks />`-toimintoa sisäkkäisiin lohkoihin ja `useBlockProps`-toimintoa ympäröivään rakenteeseen. Kaikki yhdessä mallipohjassa.

Editorissa näistä tulee oikeita React-komponentteja. Käyttöliittymässä ne renderöidään palvelimella HTML-elementeiksi, eikä kävijöille toimiteta JavaScript-tiedostoja.

[Tutustu komponentteihin](https://blockstudio.dev/fi/docs/blocks/react-components/)

index.php

```
<div useBlockProps class="container">
  <RichText
    class="text-xl font-semibold"
    tag="h1"
    attribute="headline"
    placeholder="Enter headline"
  />

  <?php if ($a['showCta']): ?>
    <a href="<?= esc_url($a['ctaUrl']) ?>">
      <?= esc_html($a['ctaLabel']) ?>
    </a>
  <?php endif; ?>

  <InnerBlocks class="mt-4 p-4 border" />
</div>
```

## Kirjoita kielellä PHP, Twig tai Blade

Käytä tuntemaasi mallikieltä. PHP toimii heti käyttövalmiina, Twig toimii, kun Timber on asennettu, ja Blade toimii `illuminate/view`-versioilla 8–12 `Blockstudio\Blade_Renderer`-määrityksen kautta. Muuttujat, komponentit ja toiminta pysyvät samoina.

`$a` (ominaisuudet), `$b` (lohko), `$c` (konteksti) ja `$innerBlocks` ovat käytettävissä kaikilla kielillä.

Twig-mallit saavat myös koko Timber-kontekstin. Blade renderöi myös sivut, kuviot ja Sivustoeditorin mallit. Vanhempi `jenssegers/blade`-kääre ei toimi version `illuminate/view` 10 ja uudempien kanssa, joten käytä sen sijaan `Blade_Renderer`.

[Mallipohjakielet](https://blockstudio.dev/fi/docs/blocks/templating/blade/)

index.twig

```
<div useBlockProps class="card">
  <RichText tag="h2" attribute="title" placeholder="Card title" />
  {% if a.image %}
    <img src="{{ a.image.url|esc_url }}"
      alt="{{ a.image.alt|esc_attr }}" />
  {% endif %}
  <div class="card__body">{{ a.description|esc_html }}</div>
  <InnerBlocks allowedBlocks='["core/button"]' />
</div>
```

## Ehdollinen logiikka ja dynaamiset vaihtoehdot

Näytä ja piilota kenttiä operaattoreilla `==`, `!=`, `includes` ja `empty` sekä vertailuoperaattoreilla. Yhdistä ehtoja TAI-logiikalla.

Asetukset voivat riippua toisesta kentästä. Lisää `{attributes.post_type.value}` täyttöargumentteihin, niin luettelo latautuu uudelleen kentän muuttuessa. Lisää `fetch: true`, jotta julkaisuja haetaan editorin kirjoittaessa.

Jaa sama valintaluettelo lohkojen kesken `type: custom`-toiminnolla ja `blockstudio/blocks/attributes/populate`-suodattimella, ja rekisteröi omia yleisiä ehtoja, kuten ostotarkistus, käyttämällä `blockstudio/blocks/conditions`.

[Ehdollinen logiikka](https://blockstudio.dev/fi/docs/blocks/attributes/conditional-logic/)

block.json

```
{
  "name": "starter/posts",
  "title": "Posts",
  "blockstudio": {
    "attributes": [
      {
        "id": "post_type",
        "type": "select",
        "label": "Post type",
        "options": [
          { "value": "page", "label": "Pages" },
          { "value": "post", "label": "Posts" }
        ]
      },
      {
        "id": "selected_post",
        "type": "select",
        "label": "Post",
        "populate": {
          "type": "query",
          "query": "posts",
          "arguments": { "post_type": "{attributes.post_type.value}" }
        }
      },
      {
        "id": "style",
        "type": "select",
        "label": "Style",
        "populate": { "type": "custom", "custom": "cardStyles" },
        "conditions": [[
          { "type": "purchasedProduct", "operator": "==", "value": "yes" }
        ]]
      }
    ]
  }
}
```

## Toistimet pysyvät hallittavina

Määritä `min` ja `max`, aloita uudet lohkot `default`-riveillä ja tiivistä olemassa olevat rivit komennolla `minimized`. `textMinimized` nimeää tiivistetyn rivin jollakin sen omista kentistä, kuten nimellä.

Riveillä voi käyttää kaikkia kenttätyyppejä välilehtiä lukuun ottamatta, myös sisäkkäisiä toistimia. Rivin sisäinen ehto tarkistaa rivin ulkopuolisen kentän arvon `"context": "main"`-toiminnolla, ja `<RichText />` sekä `<MediaPlaceholder />` muokkaavat yksittäistä riviä, kun niiden `attribute` osoittaa kohteeseen `repeaterId[index].fieldId`.

[Toistinkuvioita](https://blockstudio.dev/fi/guides/field-patterns/#repeater-patterns)

block.json

```
{
  "name": "starter/team",
  "title": "Team",
  "blockstudio": {
    "attributes": [
      {
        "id": "members",
        "type": "repeater",
        "label": "Team members",
        "min": 1,
        "max": 12,
        "minimized": true,
        "textMinimized": { "id": "name", "fallback": "Team member" },
        "attributes": [
          { "id": "name", "type": "text", "label": "Name" },
          { "id": "bio", "type": "richtext", "label": "Bio" }
        ]
      }
    ]
  }
}
```

## Uudelleenkäytettävät kenttäjoukot

Määritä kenttäryhmä kerran `field.json`-määrityksessä ja viittaa siihen mistä tahansa lohkosta komennolla `"type": "custom/cta"`. Kentät upotetaan suoraan, joten mallit lukevat niitä kuten mitä tahansa muuta attribuuttia.

Käytä samaa joukkoa kahdesti esimerkiksi `idStructure`-määrityksellä, kuten `hero_{id}`, ja muuta tunnisteita, oletusarvoja tai ehtoja lohkokohtaisesti komennolla `overrides`. Kenttätyyppi `block` tekee saman kokonaiselle lohkolle: se laajentaa lohkon kentät suoraan sisältöön ja palauttaa sen renderöidyn HTML-arvon.

[Mukautetut kentät](https://blockstudio.dev/fi/docs/blocks/attributes/custom-fields/)

fields/cta/field.json

```
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}
```

## ES-moduulit ilman koontivaihetta

Lisää `script.js`, niin se latautuu ES-moduulina. Tuo npm-paketteja etuliitteellä `npm:`, ja Blockstudio lataa ne paikallisesti tuotantokäyttöä varten.

Editorissa näet esikatselun heti, ja käyttöliittymä käyttää paikallisia moduuleja ilman ulkoisia riippuvuuksia. Moduulit otetaan käyttöön vain kerran.

Tyylitiedostot tuodaan samalla tavalla. `import "npm:swiper@11.0.0/swiper.min.css"` lataa tiedoston ja lisää sen jonoon kerran versiota kohden, vaikka useat lohkot käyttäisivät sitä.

[Resurssien käsittely](https://blockstudio.dev/fi/docs/blocks/assets/)

script.js

```
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";

for (const el of document.querySelectorAll(".swiper")) {
  new Swiper(el, {
    slidesPerView: 3,
    spaceBetween: 20,
    loop: true,
  });
}
```

## Lohkotunnisteet mallien lisäksi

Yhdistä lyhyt etuliite nimiavaruuteen tiedostossa `blockstudio.json` tai yksi tunniste yhteen lohkoon aliassuodattimella, niin `<acme-card>` renderöi tunnisteen `acme/card`. Ota `blockTags.enabled` käyttöön, jotta tunnisteet renderöidään myös julkaisujen sisällössä ja vimpaimissa. Käyttöä rajaavat `allow`– ja `deny`-kuviot.

`data-*`-attribuutit siirtyvät lohkon juurielementtiin, ja `html-*`-attribuutit saapuvat sinne ilman etuliitettä. Lisää omia tunnisteiden muodostajia komennolla `blockstudio/block_tags/builders` ja muunna lyhenteet siirrettävään `<bs:acme-card>`-muotoon komennolla `migrate-block-tags`.

[Lue opas](https://blockstudio.dev/fi/guides/block-tags/)

blockstudio.json

```
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}
```

## Mukautetut kenttätyypit

Rekisteröi oma kentän ohjauskomponentti ja käytä sitä sisäänrakennetun kentän tavoin.

## Lohkosaarekkeet

Tallenna koko sivu välimuistiin ja renderöi yksi lohko kävijän pyynnön yhteydessä.

## Ehdollinen rekisteröinti

Rekisteröi lohko vain tietylle julkaisutyypille, käyttäjäroolille tai muulle yleiselle ehdolle. Voit myös jättää sen rekisteröimättä, jos sen tarvitsema lisäosa tai lisäosan versio puuttuu.

## Artikkelien metatiedot ja asetukset

Tallenna arvot artikkelien metatietoihin tai asetuksiin lohko-ominaisuuksien rinnalle.

## Ehdollinen logiikka

Näytä kenttiä arvojen perusteella käyttämällä yhtäsuuruus-, sisältyvyys-, tyhjyys- ja vertailuehtoja.

## Dynaamiset vaihtoehdot

Hae valintavaihtoehdot artikkeleista, käyttäjistä, termeistä, funktioista tai rajapinnoista.

## Ohitukset

Aseta yhteisen lohkon nimen kohdalla override: true, niin attribuutit yhdistetään tunnisteen mukaan, resurssit korvataan samannimisillä tiedostoilla ja malli vaihdetaan. Twig-malleissa yksittäiset lohkot voi korvata extends-määrityksellä.

## Muunnelmat

Määritä tiedostossa block.json muunnelmia, jotka asettavat kenttien arvot valmiiksi, ja piilota niitä ohjaava kenttä hidden-määrityksellä.

## Komponentit

Aseta component: true lohkolle, joka renderöidään vain PHP-määrityksestä tai lohkotunnisteista. Se säilyttää kentät, mallit, resurssit ja Tailwind-määrityksen, mutta ei koskaan näy lisääjässä.

## InnerBlocks-säännöt

Salli lohkot, joiden tunnisteina ovat namespace/*, category: ja @theme, vaihda sisämalli valintavaihtoehdolla ja poista kääre suodattimella käyttöliittymän puolelta.

## Koodikentän resurssit

Koodikenttä, jonka asset: true -asetus on käytössä, muuntaa editorin syötteen lohkon CSS-, SCSS- tai JavaScript-muotoon. Rajaus tehdään esiintymän mukaan arvolla %selector%.

## Resurssit tiedostonimen mukaan

*.view.js latautuu vain käyttöliittymän puolella. global-, admin- ja block-editor-etuliitteillä varustetut tiedostot latautuvat jokaisella sivulla, wp-adminissa tai lokoeditorissa.

## Kuvakkeet ja lohkokansiot

Anna lohkolle mukautettu SVG- tai HTML-kuvake, muuta etsintäpolkua blockstudio/path-suodattimella ja lisää kansioita määrityksellä Blockstudio\Build::init().

## ACF- ja Meta Box-arvot

Mallit saavat $post_id-arvon, joten get_field() ja rwmb_get_value() lukevat muokattua julkaisua, ja refreshOn päivittää esikatselun tallennuksen jälkeen.

## Kyselysilmukan konteksti

Kyselysilmukan sisällä $block[‘context’][‘postId’] seuraa nykyistä kohdetta, kun taas $block[‘postId’] pysyy tarkasteltavan julkaisun tunnisteena.

## WPML

wp bs wpml config kirjoittaa wpml-config.xml-määrityksen, joka merkitsee tekstikentät käännettäviksi. Kenttiin tallennetut kuvat lisätään myös WPML-käännöstöihin alt-teksteineen ja kuvateksteineen.

Plus

## Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

- 500+ sivustomallia
- Tekoälyn järjestelmäohjeet
- Elinikäiset päivitykset
- Yksityinen Discord-yhteisö

[Hanki Plus](https://blockstudio.dev/fi/plus/)
