# Kohandatud plokid 3 failis

Pole vaja JavaScript-i, ehitusetappi ega algkoodi.

## Määrake väljad failis JSON

Lisage `blockstudio`-võti faili block.json. Määratlege atribuudid tüüpidega, näiteks `text`, `toggle` ja `color`. Blockstudio loob redaktori UI automaatselt, pakkudes 27 väljatüüpe alates tekstisisestusväljadest kuni kordajate ja koodiredaktoritni, ning ka teie enda registreeritud väljatüüpe.

Täielik JSON skeemide tugi pakub automaatset lõpetamist ja valideerimist keskkondades VS Code, PhpStorm ja kõigis ühilduvates redaktorites.

Iga väli saab määrata uute plokkide jaoks `default`-i ning `fallback`-i, mille mall saab siis, kui väli on tühi.

[Väljatüüpide teatmik](https://blockstudio.dev/et/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" }
    ]
  }
}
```

## Kolme faili töövoog

block.json väljade jaoks, mall märgistuse jaoks ja valikuline laaditabel.

## React keskkonnas PHP

RichText, InnerBlocks ja useBlockProps töötavad otse keeltes PHP, Twig või Blade.

## SCSS ja Tailwind

Kasuta CSS, SCSS või Tailwind. SCSS toetab imporditeid ja jagatud eelsisu ning pesastatud osafaili muutmisel kompileeritakse uuesti kõik seda importivad failid.

## 27 väljatüüpi

Tekst, värv, pilt, kordaja, valik, koodiredaktor ja palju muud – seadistage need failis JSON.

## JSON Schema

Automaatne lõpetamine ja valideerimine keskkondades VS Code, PhpStorm ja ühilduvates redaktorites.

## Kolm mallikeelt

PHP, Twig ja Blade kasutavad samu muutujaid ja komponente.

## npm impordid

Importige paketid keskkonda script.js; tootmises laaditakse need kohalikult ja redaktoris kasutavad need CDN-i.

## Interactivity API

Lülitage WordPress Interactivity API ühe lipuga sisse.

## React komponendid PHP mallides

Kasutage tekstisisesteks muudatusteks ja staatilise esiotsa HTML jaoks `<RichText />`-i, alamplokkide jaoks `<InnerBlocks />`-i ning ümbrisploki jaoks `useBlockProps`-i – kõik ühes mallis.

Redaktoris muutuvad need päris React komponentideks. Esiotsas renderdatakse need serveris HTML-ina, nii et külastajatele ei saadeta JavaScript-i.

[Tutvu komponentidega](https://blockstudio.dev/et/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>
```

## Kirjutage keeles PHP, Twig või Blade

Kasutage endale tuttavat mallikeelt. PHP töötab kohe, Twig käivitub pärast Timber paigaldamist ning Blade töötab `illuminate/view` versioonides 8 kuni 12 `Blockstudio\Blade_Renderer` kaudu. Muutujad, komponendid ja käitumine jäävad samaks.

Kõigis keeltes on saadaval `$a` (atribuudid), `$b` (plokk), `$c` (kontekst) ja `$innerBlocks`.

Twig mallid saavad samuti kogu Timber konteksti. Blade renderdab ka lehti, mustreid ja saidiredaktori malle. Vanem `jenssegers/blade` ümbris ei tööta versiooniga `illuminate/view` 10 ega uuematega, seega kasuta selle asemel `Blade_Renderer`.

[Mallikeeled](https://blockstudio.dev/et/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>
```

## Tingimusloogika ja dünaamilised valikud

Kuvage ja peitke välju operaatoritega, sealhulgas `==`, `!=`, `includes`, `empty` ja võrdlustega. Ühendage tingimused VÕI-loogikaga.

Valikud võivad sõltuda teisest väljast. Lisa `{attributes.post_type.value}` täitmise argumentidesse ja loend laaditakse uuesti, kui see väli muutub. Lisa `fetch: true`, et otsida postitusi samal ajal, kui redaktor teksti sisestab.

Jaga plokkide vahel üht valikuloendit `type: custom` ja filtriga `blockstudio/blocks/attributes/populate` ning registreeri oma globaalsed tingimused, näiteks ostu kontroll, `blockstudio/blocks/conditions` kaudu.

[Tingimusloogika](https://blockstudio.dev/et/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" }
        ]]
      }
    ]
  }
}
```

## Hallatavad kordajad

Määra `min` ja `max`, alusta uusi plokke `default` reaga ning ahenda olemasolevad read `minimized` abil. `textMinimized` lisab ahendatud reale selle ühe välja väärtuse, näiteks nime.

Read toetavad kõiki väljatüüpe peale vahekaartide, sealhulgas pesastatud kordajaid. Rea sees olev tingimus kontrollib sellest väljaspool asuvat välja `"context": "main"` abil ning `<RichText />` ja `<MediaPlaceholder />` muudavad üht rida, kui nende `attribute` osutab väärtusele `repeaterId[index].fieldId`.

[Kordajate mustrid](https://blockstudio.dev/et/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" }
        ]
      }
    ]
  }
}
```

## Taaskasutatavad väljakomplektid

Määra väljade rühm üks kord `field.json`-is ja viita sellele mis tahes plokist `"type": "custom/cta"` abil. Väljad lisatakse ploki sisse, nii et mallid käsitlevad neid nagu mis tahes muud atribuuti.

Kasuta sama komplekti kaks korda koos `idStructure`-iga, näiteks `hero_{id}`, ning muuda plokipõhiselt silte, vaikeväärtusi või tingimusi `overrides` abil. Väljatüüp `block` teeb sama terve plokiga: see lisab selle ploki väljad otse sisse ja tagastab renderdatud HTML.

[Kohandatud väljad](https://blockstudio.dev/et/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-moodulid ilma ehitusetapita

Lisage `script.js` ja see laaditakse ES-moodulina. Importige npm paketid eesliitega `npm:` ning Blockstudio laadib need tootmiskeskkonna jaoks kohalikult alla.

Redaktoris kuvatakse kohe eelvaade, samal ajal kui esiots kasutab kohalikke mooduleid ilma väliste sõltuvusteta; need lisatakse järjekorda ainult üks kord.

Laaditabelid imporditakse samamoodi. `import "npm:swiper@11.0.0/swiper.min.css"` laadib faili alla ja lisab selle järjekorda versiooni kohta üks kord, isegi kui seda kasutavad mitu plokki.

[Varade töötlemine](https://blockstudio.dev/et/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,
  });
}
```

## Plokisildid ka väljaspool malle

Vasta lühikese eesliitega nimeruumile failis `blockstudio.json` või seo üks silt ühe plokiga aliasfiltri abil; `<acme-card>` renderdab `acme/card`. Luba `blockTags.enabled`, et renderdada silte postituste sisus ja vidinates; seda piiravad mustrid `allow` ja `deny`.

`data-*` atribuudid jõuavad ploki juurelemendini ning `html-*` atribuudid jõuavad sinna ilma eesliiteta. Lisa oma sildikoostajad `blockstudio/block_tags/builders` abil ja kirjuta lühivormid teisaldatavasse kirjapilti `<bs:acme-card>` käsuga `migrate-block-tags`.

[Loe juhendit](https://blockstudio.dev/et/guides/block-tags/)

blockstudio.json

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

## Kohandatud väljatüübid

Registreerige oma välja juhtelement ja kasutage seda nagu sisseehitatud välja.

## Plokisaared

Salvestage vahemällu terve leht ja renderdage külastaja päringu ajal üks plokk.

## Tingimuslik registreerimine

Registreeri plokk ainult kindla postitusetüübi, kasutajarolli või muu globaalse tingimuse korral või jäta see vahele, kui vajalik plugin või selle versioon puudub.

## Postituse metaandmed ja valikud

Salvestage väärtused postituse metaandmetesse või valikutesse koos ploki atribuutidega.

## Tingimusloogika

Kuvage väärtustel põhinevaid välju võrdsuse, kuuluvuse, tühjuse ja võrdluste järgi.

## Dünaamilised valikud

Täitke valikud postituste, kasutajate, terminite, funktsioonide või API-de andmetega.

## Ülekirjutused

Määra jagatud ploki nime juures override: true, et ühendada atribuudid ID järgi, asendada sama failinimega varad ja vahetada mall. Twig mallid saavad üksikuid plokke laiendada märksõnaga extends.

## Variandid

Määra variatsioonid failis block.json, et väljade väärtused eelseadistada, ja peida neid juhtiv väli märksõnaga hidden.

## Komponendid

Määra ploki juures component: true, kui see renderdatakse ainult väärtusest PHP või plokisiltidest. Nii säilivad väljad, mallid, varad ja Tailwind, kuid plokki ei kuvata lisajas.

## InnerBlocksi reeglid

Luba plokid märgenditega namespace/*, category: ja @theme, vaheta sisemalli valikloendi valikuga ja eemalda eesliidese ümbris veebilehel filtri abil.

## Koodivälja varad

Varaga koodiväli (asset: true) muudab redaktori sisendi selle ploki CSS-iks, SCSS-iks või JavaScript-iks ning piiritleb selle eksemplariga %selector% abil.

## Varad failinime järgi

*.view.js laaditakse ainult veebilehel; eesliited global-, admin- ja block-editor- laadivad faili igal lehel, wp-admin-is või plokiredaktoris.

## Ikoonid ja plokikaustad

Lisa plokile kohandatud SVG- või HTML-ikoon, muuda avastamise asukohta filtri blockstudio/path abil ning lisa kaustu Blockstudio\Build::init() abil.

## ACF ja Meta Box väärtused

Mallid saavad $post_id, nii et get_field() ja rwmb_get_value() loevad muudetud postitust ning refreshOn värskendab eelvaadet pärast salvestamist.

## Query Loopi kontekst

Query Loopi sees järgib $block[‘context’][‘postId’] parajasti aktiivset üksust, samas kui $block[‘postId’] jääb vaadatavaks postituseks.

## WPML

wp bs wpml config kirjutab faili wpml-config.xml, mis märgib tekstiväljad tõlgitavaks; väljadesse salvestatud pildid lisatakse koos alternatiivtekstide ja pealdistega WPML tõlketöödesse.

Plus

## Ametlik laienduskomplekt

Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.

- 500+ saidimalli
- Tehisintellekti süsteemijuhised
- Eluaegsed uuendused
- Privaatne Discord-i kogukond

[Hangi Plus](https://blockstudio.dev/et/plus/)
