# Blocuri personalizate în 3 fișiere

Fără JavaScript, fără etapă de construire, fără șabloane predefinite.

## Definiți câmpurile în JSON

Adăugați o cheie `blockstudio` în block.json. Definiți atribute cu tipuri precum `text`, `toggle` și `color`. Blockstudio generează automat editorul UI, cu 27 tipuri de câmpuri, de la câmpuri text la repetoare și editoare de cod, precum și tipuri de câmpuri pe care le înregistrați personal.

Suportul complet pentru schema JSON oferă completare automată și validare în VS Code, PhpStorm și orice editor compatibil.

Fiecare câmp poate seta un `default` pentru blocurile noi și un `fallback` pe care îl primește șablonul când câmpul este gol.

[Referință pentru tipurile de câmpuri](https://blockstudio.dev/ro/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" }
    ]
  }
}
```

## Flux de lucru cu 3 fișiere

block.json pentru câmpuri, un șablon pentru marcaj și o foaie de stil opțională.

## React în PHP

RichText, InnerBlocks și useBlockProps funcționează direct în PHP, Twig sau Blade.

## SCSS și Tailwind

Folosiți CSS, SCSS sau Tailwind. SCSS acceptă căi de import și un preambul comun, iar editarea unei părți parțiale imbricate recompilă fiecare fișier care o importă.

## 27 tipuri de câmpuri

Text, culoare, imagine, repetor, selector, editor de cod și altele, configurate în JSON.

## JSON Schema

Completare automată și validare în VS Code, PhpStorm și editori compatibili.

## Trei limbaje de șabloane

PHP, Twig și Blade folosesc aceleași variabile și componente.

## Importuri npm

Importați pachete în script.js; local în producție și susținute de CDN în editor.

## Interactivity API

Activați Interactivity WordPress API cu un singur indicator.

## Componente React în șabloanele PHP

Folosiți `<RichText />` pentru editarea în linie și HTML static pentru frontend, `<InnerBlocks />` pentru blocurile copil și `useBlockProps` pentru înveliș, toate într-un singur șablon.

În editor, acestea devin componente React autentice. În frontend, se randează ca HTML pe server, fără ca JavaScript să fie livrat vizitatorilor.

[Explorați componentele](https://blockstudio.dev/ro/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>
```

## Scrieți în PHP, Twig sau Blade

Folosiți limbajul de șabloane pe care îl cunoașteți. PHP funcționează din start, Twig rulează după instalarea Timber, iar Blade rulează pe `illuminate/view` 8 la 12 prin `Blockstudio\Blade_Renderer`. Variabilele, componentele și comportamentul rămân aceleași.

`$a` (atribute), `$b` (bloc), `$c` (context) și `$innerBlocks` sunt disponibile în orice limbaj.

Twig șabloanele primesc și contextul complet Timber. Blade randează și pagini, patternuri și șabloane din Editorul site-ului. Wrapperul mai vechi `jenssegers/blade` nu funcționează cu `illuminate/view` 10 și versiunile ulterioare, așa că folosiți `Blade_Renderer` în schimb.

[Limbaje pentru șabloane](https://blockstudio.dev/ro/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>
```

## Logică condițională și opțiuni dinamice

Afișați și ascundeți câmpuri folosind operatori precum `==`, `!=`, `includes`, `empty` și comparații. Combinați condițiile cu logica SAU.

Opțiunile pot depinde de un alt câmp. Adăugați `{attributes.post_type.value}` la argumentele de populare, iar lista se reîncarcă atunci când se modifică acel câmp. Adăugați `fetch: true` pentru a căuta articole în timp ce editorul tastează.

Partajați o listă de opțiuni între blocuri cu `type: custom` și filtrul `blockstudio/blocks/attributes/populate`, apoi înregistrați propriile condiții globale, cum ar fi o verificare a achiziției, prin `blockstudio/blocks/conditions`.

[Logică condițională](https://blockstudio.dev/ro/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" }
        ]]
      }
    ]
  }
}
```

## Repetatoare ușor de gestionat

Setați `min` și `max`, începeți blocurile noi cu `default` rânduri și restrângeți rândurile existente cu `minimized`. `textMinimized` etichetează un rând restrâns cu unul dintre propriile câmpuri, cum ar fi un nume.

Rândurile acceptă toate tipurile de câmpuri, cu excepția filelor, inclusiv repetatoare imbricate. O condiție dintr-un rând verifică un câmp din afara acestuia cu `"context": "main"`, iar `<RichText />` și `<MediaPlaceholder />` editează un singur rând atunci când valoarea lor `attribute` indică spre `repeaterId[index].fieldId`.

[Modele de repetatoare](https://blockstudio.dev/ro/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" }
        ]
      }
    ]
  }
}
```

## Seturi de câmpuri reutilizabile

Definiți un grup de câmpuri o singură dată într-un `field.json` și faceți referire la el din orice bloc cu `"type": "custom/cta"`. Câmpurile sunt incluse direct, astfel încât șabloanele le citesc ca pe orice alt atribut.

Folosiți același set de două ori cu un `idStructure`, cum ar fi `hero_{id}`, și modificați etichetele, valorile implicite sau condițiile pentru fiecare bloc cu `overrides`. Tipul de câmp `block` face același lucru cu un bloc întreg: extinde câmpurile blocului direct și returnează HTML randat al acestuia.

[Câmpuri personalizate](https://blockstudio.dev/ro/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" }
  ]
}
```

## Module ES fără etapă de construire

Adăugați `script.js`, iar acesta se încarcă drept modul ES. Importați pachete npm cu prefixul `npm:`, iar Blockstudio le descarcă local pentru producție.

Editorul oferă previzualizare instantanee, iar frontendul folosește module locale, fără dependențe externe și adăugate în coadă o singură dată.

Foaiele de stil se importă în același mod. `import "npm:swiper@11.0.0/swiper.min.css"` descarcă fișierul și îl adaugă în coadă o singură dată pentru fiecare versiune, chiar și când este folosit de mai multe blocuri.

[Procesarea resurselor](https://blockstudio.dev/ro/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,
  });
}
```

## Etichete de bloc dincolo de șabloane

Asociați un prefix scurt unui spațiu de nume în `blockstudio.json` sau o etichetă unui singur bloc printr-un filtru de alias, iar `<acme-card>` randează `acme/card`. Activați `blockTags.enabled` pentru a randa etichete în conținutul articolelor și în widgeturi, cu limite stabilite de patternurile `allow` și `deny`.

Atributele `data-*` ajung la elementul rădăcină al blocului, iar atributele `html-*` ajung acolo fără prefix. Adăugați propriile generatoare de etichete cu `blockstudio/block_tags/builders` și rescrieți formele prescurtate în forma portabilă `<bs:acme-card>` cu comanda `migrate-block-tags`.

[Citiți ghidul](https://blockstudio.dev/ro/guides/block-tags/)

blockstudio.json

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

## Tipuri de câmpuri personalizate

Înregistrați propriul control de câmp și folosiți-l ca pe un câmp încorporat.

## Blocuri izolate

Puneți pagina întreagă în cache și randați un singur bloc în cadrul solicitării vizitatorului.

## Înregistrare condiționată

Înregistrați un bloc numai pentru un anumit tip de articol, rol de utilizator sau altă condiție globală ori omiteți-l dacă lipsește un plugin necesar sau versiunea de care are nevoie.

## Metadate de postare și opțiuni

Stocați valori în metadatele postării sau în opțiuni, alături de atributele blocului.

## Logică condițională

Afișați câmpuri în funcție de valori, folosind egalitatea, includerea, lipsa conținutului și comparațiile.

## Completări dinamice

Completați opțiunile din postări, utilizatori, termeni, funcții sau API-uri.

## Suprascrieri

Setați override: true cu numele unui bloc partajat pentru a îmbina atributele după id, a înlocui resursele cu fișiere care au aceleași nume și a schimba șablonul. Șabloanele Twig pot suprascrie blocuri individuale cu extends.

## Variante

Declarați variații în block.json care stabilesc valori prestabilite pentru câmpuri și ascundeți cu hidden câmpul care le controlează.

## Componente

Setați component: true pentru un bloc randat numai din PHP sau etichete de bloc. Acesta păstrează câmpurile, șabloanele, resursele și Tailwind, dar nu apare niciodată în inserator.

## Reguli pentru InnerBlocks

Permiteți blocuri cu namespace/*, category: și tokenuri @theme, schimbați șablonul interior dintr-o opțiune select și eliminați wrapperul pe partea frontend cu un filtru.

## Resurse pentru câmpuri de cod

Un câmp de cod cu asset: true transformă intrarea din editor în CSS, SCSS sau JavaScript pentru blocul respectiv, cu domeniul limitat la instanță prin %selector%.

## Resurse după numele fișierului

*.view.js se încarcă numai pe partea frontend, iar prefixele global-, admin- și block-editor- încarcă un fișier pe fiecare pagină, în wp-admin sau în editorul de blocuri.

## Pictograme și dosare de blocuri

Atribuiți unui bloc o pictogramă SVG personalizată sau HTML, schimbați locul de descoperire cu filtrul blockstudio/path și adăugați dosare cu Blockstudio\Build::init().

## Valori ACF și Meta Box

Șabloanele primesc $post_id, astfel încât get_field() și rwmb_get_value() citesc articolul editat, iar refreshOn reîncarcă previzualizarea după salvare.

## Contextul Query Loop

Într-un Query Loop, $block[‘context’][‘postId’] urmărește elementul curent, în timp ce $block[‘postId’] rămâne articolul vizualizat.

## WPML

wp bs wpml config scrie wpml-config.xml care marchează câmpurile text ca fiind traductibile, iar imaginile stocate în câmpuri sunt incluse în sarcinile de traducere WPML, împreună cu textele alternative și legendele lor.

Plus

## Kitul oficial de extensii

Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.

- 500+ șabloane de site
- Instrucțiuni de sistem pentru IA
- Actualizări pe viață
- Comunitate privată Discord

[Obțineți Plus](https://blockstudio.dev/ro/plus/)
