# Bloki po meri v 3 datotekah

Brez JavaScript, brez koraka gradnje, brez šablonske kode.

## Določite polja v JSON

Dodajte ključ `blockstudio` v block.json. Določite atribute s tipi, kot so `text`, `toggle` in `color`. Blockstudio samodejno ustvari urejevalnik UI z vrstami polj 27, od besedilnih vnosnih polj do ponavljalnikov in urejevalnikov kode, ter z vrstami polj, ki jih registrirate sami.

Popolna podpora za shemo JSON omogoča samodokončanje in preverjanje v VS Code, PhpStorm in vseh združljivih urejevalnikih.

Vsako polje lahko določi `default` za nove bloke in `fallback`, ki ga predloga prejme, ko je polje prazno.

[Referenca vrst polj](https://blockstudio.dev/sl/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" }
    ]
  }
}
```

## Potek dela s 3 datotekami

block.json za polja, predloga za označevalni jezik in izbirna slogovna datoteka.

## React v PHP

RichText, InnerBlocks in useBlockProps delujejo neposredno v PHP, Twig ali Blade.

## SCSS in Tailwind

Uporabite CSS, SCSS ali Tailwind. SCSS podpira uvozne poti in skupno uvodno kodo, urejanje ugnezdenega delnega predloga pa znova prevede vse datoteke, ki ga uvažajo.

## 27 vrst polj

Besedilo, barva, slika, ponavljalnik, izbirno polje, urejevalnik kode in še več, nastavljeno v JSON.

## JSON Schema

Samodokončanje in preverjanje v VS Code, PhpStorm in združljivih urejevalnikih.

## Trije jeziki predlog

PHP, Twig in Blade uporabljajo iste spremenljivke in komponente.

## Uvozi npm

Uvažajte pakete v script.js; v produkciji lokalno, v urejevalniku pa temelji na CDN.

## Interactivity API

Z eno zastavico omogočite WordPress za interaktivnost API.

## Komponente React v predlogah PHP

Uporabite `<RichText />` za sprotno urejanje in statični uporabniški vmesnik HTML, `<InnerBlocks />` za podrejene bloke in `useBlockProps` za ovoj, vse v eni predlogi.

V urejevalniku postanejo prave komponente React. Na uporabniškem vmesniku se izrišejo kot strežniški HTML, obiskovalcem pa se ne pošlje noben JavaScript.

[Raziščite komponente](https://blockstudio.dev/sl/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>
```

## Pišite v PHP, Twig ali Blade

Uporabite jezik predlog, ki ga poznate. PHP deluje takoj, Twig pa se zažene, ko namestite Timber; Blade se izvaja na `illuminate/view` 8 do 12 prek `Blockstudio\Blade_Renderer`. Spremenljivke, komponente in vedenje ostanejo enaki.

`$a` (atributi), `$b` (blok), `$c` (kontekst) in `$innerBlocks` so na voljo v vseh jezikih.

Twig predloge prejmejo tudi celoten kontekst Timber. Blade izrisuje tudi strani, vzorce in predloge urejevalnika spletnega mesta. Starejši ovoj `jenssegers/blade` ne deluje z različico `illuminate/view` 10 in novejšimi, zato namesto njega uporabite `Blade_Renderer`.

[Jeziki predlog](https://blockstudio.dev/sl/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>
```

## Pogojna logika in dinamične možnosti

Polja prikažite ali skrijte z operatorji, kot so `==`, `!=`, `includes`, `empty` in primerjave. Pogoje združite z logičnim ALI.

Možnosti so lahko odvisne od drugega polja. Dodajte `{attributes.post_type.value}` med argumente za polnjenje in seznam se znova naloži, ko se to polje spremeni. Dodajte `fetch: true` za iskanje objav med tipkanjem urednika.

En seznam možnosti lahko delite med bloki z uporabo `type: custom` in filtra `blockstudio/blocks/attributes/populate`, lastne globalne pogoje, na primer preverjanje nakupa, pa registrirate prek `blockstudio/blocks/conditions`.

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

## Pregledno upravljanje ponavljalnikov

Nastavite `min` in `max`, nove bloke začnite z `default` vrsticami, obstoječe pa strnite z `minimized`. `textMinimized` označi strnjeno vrstico z enim od njenih polj, na primer z imenom.

Vrstice podpirajo vse vrste polj, razen zavihkov, vključno z ugnezdenimi ponavljalniki. Pogoj znotraj vrstice lahko preverja polje zunaj nje z `"context": "main"`, `<RichText />` in `<MediaPlaceholder />` pa urejata posamezno vrstico, kadar njun `attribute` kaže na `repeaterId[index].fieldId`.

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

## Nabori polj za ponovno uporabo

Skupino polj enkrat določite v `field.json` in se nanjo sklicujte iz poljubnega bloka z `"type": "custom/cta"`. Polja so vstavljena neposredno, zato jih predloge berejo kot kateri koli drug atribut.

Isti nabor uporabite dvakrat z `idStructure`, na primer `hero_{id}`, oznake, privzete vrednosti ali pogoje pa prilagodite za vsak blok z `overrides`. Vrsta polja `block` naredi enako za celoten blok: vstavi polja tega bloka in vrne njegov izrisani HTML.

[Polja po meri](https://blockstudio.dev/sl/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" }
  ]
}
```

## Moduli ES brez koraka gradnje

Dodajte `script.js` in naloži se kot modul ES. Uvozite pakete npm s predpono `npm:`, Blockstudio pa jih za produkcijo prenese lokalno.

Urejevalnik takoj prikaže predogled, uporabniški vmesnik pa uporablja lokalne module brez zunanjih odvisnosti, ki se vključijo samo enkrat.

Tudi slogovne liste lahko uvozite na enak način. `import "npm:swiper@11.0.0/swiper.min.css"` prenese datoteko in jo doda v čakalno vrsto enkrat za vsako različico, tudi kadar jo uporablja več blokov.

[Obdelava sredstev](https://blockstudio.dev/sl/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,
  });
}
```

## Oznake blokov tudi zunaj predlog

V `blockstudio.json` preslikajte kratko predpono v imenski prostor ali z aliasnim filtrom povežite eno oznako z enim blokom; `<acme-card>` nato izrisuje `acme/card`. Vklopite `blockTags.enabled` za izris oznak v vsebini objav in gradnikih, omejen z vzorci `allow` in `deny`.

Atributi `data-*` dosežejo korenski element bloka, atributi `html-*` pa prispejo tja brez predpone. Dodajte lastne gradnike oznak z `blockstudio/block_tags/builders` in prepišite okrajšave v prenosljivo obliko `<bs:acme-card>` z ukazom `migrate-block-tags`.

[Preberite priročnik](https://blockstudio.dev/sl/guides/block-tags/)

blockstudio.json

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

## Vrste polj po meri

Registrirajte svoj kontrolnik polja in ga uporabljajte kot vgrajeno polje.

## Otočki blokov

Predpomnite celotno stran in en blok izrišite ob zahtevi obiskovalca.

## Pogojna registracija

Blok registrirajte samo za določeno vrsto objave, uporabniško vlogo ali drug globalni pogoj oziroma preskočite registracijo, če manjka potreben vtičnik ali njegova zahtevana različica.

## Metapodatki objave in možnosti

Vrednosti shranite v metapodatke objave ali možnosti ob atributih bloka.

## Pogojna logika

Polja prikažite glede na vrednosti s preverjanjem enakosti, vključenosti, praznosti in primerjav.

## Dinamično polnjenje

Možnosti napolnite z objavami, uporabniki, izrazi, funkcijami ali API-ji.

## Preglasitve

Za skupni blok nastavite override: true, da združite atribute po ID-ju, zamenjate sredstva z enakimi imeni datotek in zamenjate predlogo. Predloge Twig lahko preglasijo posamezne bloke z extends.

## Različice

V block.json določite različice, ki vnaprej nastavijo vrednosti polj, in z hidden skrijte polje, ki jih upravlja.

## Komponente

Za blok, ki se izrisuje samo iz PHP ali oznak blokov, nastavite component: true. Ohranijo se polja, predloge, sredstva in Tailwind, vendar se blok nikoli ne prikaže v vstavljalniku.

## Pravila za InnerBlocks

Dovolite bloke z žetoni namespace/*, category: in @theme, z možnostjo v izbirnem polju zamenjajte notranjo predlogo, na sprednjem delu pa z odjemalcem odstranite ovoj.

## Sredstva polj kode

Polje kode z asset: true spremeni uporabnikov vnos v urejevalniku v CSS, SCSS ali JavaScript za ta blok; obseg na posamezno instanco določa %selector%.

## Sredstva po imenu datoteke

*.view.js se naloži samo na sprednjem delu, predpone global-, admin- in block-editor- pa naložijo datoteko na vsaki strani, v wp-admin oziroma v urejevalniku blokov.

## Ikone in mape blokov

Bloku dodelite ikono SVG po meri ali ikono HTML, z filtrom blockstudio/path spremenite mesto iskanja, mape pa dodajte z Blockstudio\Build::init().

## Vrednosti ACF in Meta Box

Predloge prejmejo $post_id, zato get_field() in rwmb_get_value() bereta urejano objavo, refreshOn pa po shranjevanju osveži predogled.

## Kontekst zanke poizvedbe

V zanki poizvedbe $block[‘context’][‘postId’] sledi trenutnemu elementu, medtem ko $block[‘postId’] ostane ID objave, ki si jo ogledujete.

## WPML

Ukaz wp bs wpml config zapiše wpml-config.xml, ki označuje besedilna polja kot prevedljiva, slike, shranjene v poljih, pa se z alternativnimi besedili in napisi vključijo v prevajalska opravila za WPML.

Plus

## Uradni komplet razširitev

Vrhunske predloge spletnih mest, sistemska navodila za UI in zasebna skupnost Discord. Enkratni nakup, posodobitve za vedno.

- Več kot 500+ predlog spletnih mest
- Sistemska navodila za UI
- Doživljenjske posodobitve
- Zasebna skupnost Discord

[Pridobite Plus](https://blockstudio.dev/sl/plus/)
