# Egyéni blokkok 3 fájlban

Nincs JavaScript, nincs buildlépés, nincs sablonkód.

## Mezők meghatározása itt: JSON

Adjon hozzá egy `blockstudio` kulcsot a block.json elemhez. Határozza meg az attribútumokat olyan típusokkal, mint `text`, `toggle` és `color`. A Blockstudio automatikusan létrehozza a szerkesztő UI elemét, 27 mezőtípussal a szövegbeviteli mezőktől az ismétlőkön és kódszerkesztőkön át, valamint az Ön által regisztrált mezőtípusokkal.

A teljes JSON séma támogatása automatikus kiegészítést és ellenőrzést biztosít a VS Code, a PhpStorm és minden kompatibilis szerkesztőben.

Minden mező megadhat egy `default` értéket az új blokkokhoz, valamint egy `fallback` értéket, amelyet a sablon akkor kap meg, amikor a mező üres.

[Mezőtípusok referenciája](https://blockstudio.dev/hu/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" }
    ]
  }
}
```

## Háromfájlos munkafolyamat

block.json a mezőkhöz, egy sablon a jelölőkódhoz és egy opcionális stíluslap.

## React a PHP nyelvben

A RichText, az InnerBlocks és a useBlockProps közvetlenül működik a PHP, a Twig vagy a Blade nyelvben.

## SCSS és Tailwind

Használja a CSS, a SCSS vagy a Tailwind elemet. A SCSS támogatja az importálási útvonalakat és a megosztott előbetöltést; egy beágyazott részfájl szerkesztése újrafordítja az összes fájlt, amely importálja azt.

## 27 mezőtípus

Szöveg, szín, kép, ismétlő, választó, kódszerkesztő és más mezők beállítása itt: JSON.

## JSON Schema

Automatikus kiegészítés és ellenőrzés a VS Code, a PhpStorm és a kompatibilis szerkesztők számára.

## Három sablonnyelv

A PHP, a Twig és a Blade ugyanazokat a változókat és komponenseket használja.

## npm importálása

Csomagok importálása a script.js nyelvben; helyi használat produkcióban, a szerkesztőben pedig CDN-alapú betöltés.

## Interactivity API

Egyetlen kapcsolóval engedélyezd a WordPress Interactivity API funkciót.

## React-komponensek PHP-sablonokban

Használd a `<RichText />` elemet a helyben történő szerkesztéshez és a statikus frontend HTML-hez, a `<InnerBlocks />` elemet a gyermekblokkokhoz, a `useBlockProps` elemet pedig a burkolóhoz; mindez egyetlen sablonban elfér.

A szerkesztőben ezek valódi React-komponensekké válnak. A frontenden szerveroldali HTML formájában jelennek meg, és nem kerül JavaScript a látogatókhoz.

[Komponensek felfedezése](https://blockstudio.dev/hu/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>
```

## Írj PHP, Twig vagy Blade nyelven

Használja az Ön által ismert sablonnyelvet. A PHP azonnal működik, a Twig a Timber telepítése után fut, a Blade pedig a `illuminate/view` 8–12-es verzióján fut a `Blockstudio\Blade_Renderer` segítségével. A változók, komponensek és működés változatlan marad.

A `$a` (attribútumok), a `$b` (blokk), a `$c` (kontextus) és a `$innerBlocks` minden nyelven elérhető.

A Twig sablonok is megkapják a teljes Timber kontextust. A Blade oldalakat, mintázatokat és a Webhelyszerkesztő sablonjait is megjeleníti. A régebbi `jenssegers/blade` burkoló nem működik a `illuminate/view` 10-es és újabb verzióival, ezért inkább a `Blade_Renderer` elemet használja.

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

## Feltételes logika és dinamikus lehetőségek

Mezők megjelenítése és elrejtése többek között a `==`, a `!=`, a `includes` és a `empty` operátorokkal, valamint összehasonlításokkal. A feltételek OR-logikával kombinálhatók.

A beállítások függhetnek egy másik mezőtől. Helyezze a `{attributes.post_type.value}` elemet a feltöltési argumentumok közé, és a lista újratöltődik, amikor az adott mező értéke megváltozik. Adja hozzá a `fetch: true` elemet, hogy a bejegyzések keresése a szerkesztő gépelése közben történjen.

Osszon meg egyetlen opciólistát a blokkok között a `type: custom` és a `blockstudio/blocks/attributes/populate` szűrő használatával, és regisztrálja saját globális feltételeit, például egy vásárlás ellenőrzését, a `blockstudio/blocks/conditions` segítségével.

[Feltételes logika](https://blockstudio.dev/hu/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" }
        ]]
      }
    ]
  }
}
```

## Könnyen kezelhető ismétlők

Állítsa be a `min` és a `max` értékét, indítsa az új blokkokat `default` sorral, a meglévő sorokat pedig csukja össze a `minimized` segítségével. A `textMinimized` a sor egyik saját mezőjével, például egy névvel jelöli az összecsukott sort.

A sorok bármilyen mezőtípust elfogadnak a füleken kívül, a beágyazott ismétlőket is beleértve. A soron belüli feltétel a soron kívüli mezőt a `"context": "main"` segítségével ellenőrzi, a `<RichText />` és a `<MediaPlaceholder />` pedig egyetlen sort szerkeszt, ha a `attribute` a `repeaterId[index].fieldId` elemre mutat.

[Ismétlőminták](https://blockstudio.dev/hu/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" }
        ]
      }
    ]
  }
}
```

## Újrafelhasználható mezőkészletek

Definiáljon egyszer egy mezőcsoportot egy `field.json` elemben, majd hivatkozzon rá bármelyik blokkból a `"type": "custom/cta"` segítségével. A mezők beágyazódnak, így a sablonok ugyanúgy olvashatják őket, mint bármely más attribútumot.

Használja kétszer ugyanazt a készletet egy olyan `idStructure` segítségével, mint a `hero_{id}`, és módosítsa a címkéket, az alapértelmezett értékeket vagy a feltételeket blokkonként a `overrides` segítségével. A `block` mezőtípus ugyanezt teszi egy teljes blokkal: beágyazza a blokk mezőit, és visszaadja a megjelenített HTML értékét.

[Egyéni mezők](https://blockstudio.dev/hu/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-modulok buildlépés nélkül

Add hozzá a `script.js` elemet, és ES-modulként töltődik be. A `npm:` előtagú npm csomagokat a Blockstudio tölti le helyben a produkciós környezethez.

A szerkesztő azonnali előnézetet ad, a frontend pedig helyi modulokat használ külső függőségek nélkül; a rendszer csak egyszer veszi fel őket a betöltési sorba.

A stíluslapok importálása ugyanígy működik. A `import "npm:swiper@11.0.0/swiper.min.css"` letölti a fájlt, és verziónként egyszer sorba állítja, még akkor is, ha több blokk használja.

[Eszközfeldolgozás](https://blockstudio.dev/hu/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,
  });
}
```

## Blokktagek a sablonokon túl

Rendeljen rövid előtagot egy névtérhez a `blockstudio.json` segítségével, vagy egy taget egy blokkhoz egy álnévs szűrővel, majd jelenítse meg a `acme/card` elemet a `<acme-card>` segítségével. Kapcsolja be a `blockTags.enabled` beállítást a bejegyzések tartalmában és a widgetekben lévő tagek megjelenítéséhez; a lehetőséget a `allow` és a `deny` minták korlátozzák.

A `data-*` attribútumok a blokk gyökéreleméhez kerülnek, a `html-*` attribútumok pedig előtag nélkül jutnak oda. Adjon hozzá saját tagépítőket a `blockstudio/block_tags/builders` segítségével, és írja át a rövid alakokat hordozható `<bs:acme-card>` formára a `migrate-block-tags` paranccsal.

[Útmutató megnyitása](https://blockstudio.dev/hu/guides/block-tags/)

blockstudio.json

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

## Egyéni mezőtípusok

Regisztráld a saját mezővezérlődet, és használd úgy, mint a beépített mezőket.

## Blokkszigetek

Gyorsítótárazd a teljes oldalt, és egy blokkot a látogató kérésére renderelj.

## Feltételes regisztráció

Regisztráljon egy blokkot csak egy bejegyzéstípushoz, felhasználói szerepkörhöz vagy más globális feltételhez, vagy hagyja ki, ha egy szükséges bővítmény vagy annak verziója hiányzik.

## Bejegyzésmeta és beállítások

Az értékeket a blokk attribútumai mellett a bejegyzésmeta vagy a beállítások között tárold.

## Feltételes logika

Mezők megjelenítése az értékek alapján: egyenlőség, tagság, üresség és összehasonlítás.

## Dinamikus feltöltés

A választási lehetőségek bejegyzésekből, felhasználókból, kifejezésekből, függvényekből vagy API-kból tölthetők fel.

## Felülbírálások

Állítsa be az override: true értéket egy megosztott blokk nevével, hogy az attribútumok azonosító szerint egyesüljenek, az azonos fájlnevű erőforrások lecserélődjenek, a sablon pedig kicserélődjön. A Twig sablonok az extends segítségével egyesével is felülírhatják a blokkokat.

## Változatok

Deklaráljon a block.json segítségével olyan variációkat, amelyek előre beállítják a mezőértékeket, a vezérlőmezőt pedig rejtse el a hidden segítségével.

## Komponensek

Állítsa be a component: true értéket egy olyan blokknál, amely csak a PHP vagy a blokktagek alapján jelenik meg. Megőrzi a mezőket, sablonokat, erőforrásokat és a Tailwind elemet, de nem jelenik meg a beszúróban.

## InnerBlocks-szabályok

Engedélyezze a namespace/*, category: és @theme tokeneket tartalmazó blokkokat, válasszon belső sablont egy select opcióval, és távolítsa el a burkolót a frontenden egy szűrő segítségével.

## Kódmezők erőforrásai

Az asset: true értékű kódmező a szerkesztői bevitelt CSS, SCSS vagy JavaScript fájllá alakítja az adott blokkhoz, a példányra korlátozva a %selector% segítségével.

## Fájlnév alapján kezelt eszközök

*A .view.js csak a frontenden töltődik be, a global-, admin- és block-editor- előtagok pedig minden oldalon, a wp-admin felületen vagy a blokkszerkesztőben töltenek be egy fájlt.

## Ikonok és blokkmappák

Adjon egy blokknak egyéni SVG- vagy HTML ikont, módosítsa a felfedezés helyét a blockstudio/path szűrővel, és adjon hozzá mappákat a Blockstudio\Build::init() segítségével.

## ACF és Meta Box értékek

A sablonok megkapják a $post_id elemet, így a get_field() és a rwmb_get_value() a szerkesztett bejegyzést olvassa, a refreshOn pedig mentés után frissíti az előnézetet.

## A Query Loop kontextusa

Egy Query Loopon belül a $block[‘context’][‘postId’] az aktuális elemet követi, míg a $block[‘postId’] a megtekintett bejegyzés azonosítója marad.

## WPML

A wp bs wpml config létrehozza a wpml-config.xml fájlt, amely megjelöli a szövegmezőket fordíthatóként; a mezőkben tárolt képek pedig az alternatív szövegükkel és képaláírásukkal együtt bekerülnek a WPML fordítási feladatai közé.

Plus

## A hivatalos bővítőkészlet

Prémium webhelysablonok, MI-rendszerutasítások és privát Discord közösség. Egyszeri vásárlás, élethosszig tartó frissítések.

- 500+ webhelysablon
- AI-rendszerutasítások
- Élettartamra szóló frissítések
- Privát Discord közösség

[Plus beszerzése](https://blockstudio.dev/hu/plus/)
