# Προσαρμοσμένα μπλοκ σε 3 αρχεία

Χωρίς JavaScript, χωρίς βήμα δημιουργίας, χωρίς περιττό κώδικα.

## Ορίστε πεδία στο JSON

Προσθέστε ένα κλειδί `blockstudio` στο block.json. Ορίστε γνωρίσματα με τύπους όπως `text`, `toggle` και `color`. Το Blockstudio δημιουργεί αυτόματα το UI του επεξεργαστή, με τύπους πεδίων 27 από πεδία εισαγωγής κειμένου έως επαναλήπτες και επεξεργαστές κώδικα, καθώς και τύπους πεδίων που καταχωρίζετε εσείς.

Η πλήρης υποστήριξη σχήματος JSON παρέχει αυτόματη συμπλήρωση και επικύρωση στο VS Code, στο PhpStorm και σε κάθε συμβατό επεξεργαστή.

Κάθε πεδίο μπορεί να ορίσει ένα `default` για νέα blocks και ένα `fallback` που λαμβάνει το πρότυπο όσο το πεδίο είναι κενό.

[Αναφορά τύπων πεδίων](https://blockstudio.dev/el/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" }
    ]
  }
}
```

## Ροή εργασίας 3 αρχείων

Το block.json για τα πεδία, ένα πρότυπο για τη σήμανση και ένα προαιρετικό φύλλο στυλ.

## React στο PHP

Τα RichText, InnerBlocks και useBlockProps λειτουργούν απευθείας σε PHP, Twig ή Blade.

## SCSS και Tailwind

Χρησιμοποιήστε τα CSS, SCSS ή Tailwind. Το SCSS υποστηρίζει διαδρομές εισαγωγής και κοινό πρόλογο, ενώ η επεξεργασία ενός ένθετου μερικού αρχείου μεταγλωττίζει ξανά κάθε αρχείο που το εισάγει.

## 27 τύποι πεδίων

Κείμενο, χρώμα, εικόνα, επαναλήπτης, επιλογή, επεξεργαστής κώδικα και άλλα, διαμορφωμένα στο JSON.

## JSON Schema

Αυτόματη συμπλήρωση και επικύρωση στα VS Code, PhpStorm και σε συμβατούς επεξεργαστές.

## Τρεις γλώσσες προτύπων

Τα PHP, Twig και Blade χρησιμοποιούν τις ίδιες μεταβλητές και τα ίδια στοιχεία.

## Εισαγωγές npm

Εισαγάγετε πακέτα στο script.js· τοπικά στην παραγωγή και με βάση το CDN στον επεξεργαστή.

## Interactivity API

Ενεργοποιήστε την Interactivity του WordPress API με μία σημαία.

## Στοιχεία React σε πρότυπα PHP

Χρησιμοποιήστε το `<RichText />` για επεξεργασία εντός γραμμής και στατικά frontend HTML, το `<InnerBlocks />` για ένθετα blocks και το `useBlockProps` για το περίβλημα, όλα σε ένα πρότυπο.

Στον επεξεργαστή γίνονται πραγματικά στοιχεία React. Στο frontend αποδίδονται ως HTML από την πλευρά του διακομιστή, χωρίς να αποστέλλεται κανένα JavaScript στους επισκέπτες.

[Εξερευνήστε τα στοιχεία](https://blockstudio.dev/el/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>
```

## Γράψτε σε PHP, Twig ή Blade

Χρησιμοποιήστε τη γλώσσα προτύπων που γνωρίζετε. Το PHP λειτουργεί άμεσα, το Twig εκτελείται μόλις εγκατασταθεί το Timber και το Blade εκτελείται σε `illuminate/view` 8 έως 12 μέσω του `Blockstudio\Blade_Renderer`. Οι μεταβλητές, τα στοιχεία και η συμπεριφορά παραμένουν ίδια.

Τα `$a` (γνωρίσματα), `$b` (block), `$c` (περιβάλλον) και `$innerBlocks` είναι διαθέσιμα σε κάθε γλώσσα.

Τα πρότυπα λαμβάνουν επίσης ολόκληρο το Twig πλαίσιο Timber. Το Blade αποδίδει επίσης σελίδες, μοτίβα και πρότυπα του Site Editor. Το παλιότερο περιτύλιγμα `jenssegers/blade` αποτυγχάνει με το `illuminate/view` 10 και νεότερες εκδόσεις, οπότε χρησιμοποιήστε το `Blade_Renderer`.

[Γλώσσες προτύπων](https://blockstudio.dev/el/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>
```

## Λογική υπό όρους και δυναμικές επιλογές

Εμφανίστε και αποκρύψτε πεδία με τελεστές όπως `==`, `!=`, `includes`, `empty` και συγκρίσεις. Συνδυάστε συνθήκες με λογική OR.

Οι επιλογές μπορεί να εξαρτώνται από ένα άλλο πεδίο. Προσθέστε το `{attributes.post_type.value}` στα ορίσματα populate και η λίστα θα φορτώνεται ξανά όταν αλλάζει εκείνο το πεδίο. Προσθέστε το `fetch: true` για αναζήτηση άρθρων καθώς πληκτρολογεί ο συντάκτης.

Μοιραστείτε μία λίστα επιλογών μεταξύ μπλοκ με το `type: custom` και το φίλτρο `blockstudio/blocks/attributes/populate`, και καταχωρίστε δικές σας καθολικές συνθήκες, όπως έναν έλεγχο αγοράς, μέσω του `blockstudio/blocks/conditions`.

[Λογική υπό όρους](https://blockstudio.dev/el/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" }
        ]]
      }
    ]
  }
}
```

## Επαναλήπτες που παραμένουν διαχειρίσιμοι

Ορίστε τα `min` και `max`, ξεκινήστε νέα μπλοκ με `default` σειρές και συμπτύξτε τις υπάρχουσες με το `minimized`. Το `textMinimized` ονομάζει μια συμπτυγμένη σειρά με ένα από τα δικά της πεδία, όπως ένα όνομα.

Οι σειρές δέχονται κάθε τύπο πεδίου εκτός από τις καρτέλες, συμπεριλαμβανομένων των ένθετων επαναληπτών. Μια συνθήκη μέσα σε μια σειρά ελέγχει ένα πεδίο εκτός αυτής με το `"context": "main"`, ενώ τα `<RichText />` και `<MediaPlaceholder />` επεξεργάζονται μία σειρά όταν το `attribute` τους δείχνει στο `repeaterId[index].fieldId`.

[Μοτίβα επαναληπτών](https://blockstudio.dev/el/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" }
        ]
      }
    ]
  }
}
```

## Επαναχρησιμοποιήσιμα σύνολα πεδίων

Ορίστε μια ομάδα πεδίων μία φορά σε ένα `field.json` και αναφερθείτε σε αυτή από οποιοδήποτε μπλοκ με το `"type": "custom/cta"`. Τα πεδία ενσωματώνονται, ώστε τα πρότυπα να τα διαβάζουν όπως κάθε άλλο χαρακτηριστικό.

Χρησιμοποιήστε το ίδιο σύνολο δύο φορές με ένα `idStructure` όπως το `hero_{id}` και αλλάξτε ετικέτες, προεπιλογές ή συνθήκες ανά μπλοκ με το `overrides`. Ο τύπος πεδίου `block` κάνει το ίδιο με ολόκληρο μπλοκ: αναπτύσσει τα πεδία του μπλοκ ενσωματωμένα και επιστρέφει το αποδοσμένο HTML του.

[Προσαρμοσμένα πεδία](https://blockstudio.dev/el/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 modules χωρίς βήμα δημιουργίας

Προσθέστε το `script.js` και φορτώνεται ως ES module. Εισαγάγετε πακέτα npm με το πρόθεμα `npm:` και το Blockstudio τα κατεβάζει τοπικά για την παραγωγή.

Ο επεξεργαστής παρέχει άμεση προεπισκόπηση, ενώ το frontend χρησιμοποιεί τοπικά modules χωρίς εξωτερικές εξαρτήσεις, τα οποία προστίθενται στην ουρά μόνο μία φορά.

Τα φύλλα στυλ εισάγονται με τον ίδιο τρόπο. Το `import "npm:swiper@11.0.0/swiper.min.css"` κατεβάζει το αρχείο και το προσθέτει στην ουρά μία φορά ανά έκδοση, ακόμη κι όταν το χρησιμοποιούν πολλά μπλοκ.

[Επεξεργασία πόρων](https://blockstudio.dev/el/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,
  });
}
```

## Ετικέτες μπλοκ πέρα από τα πρότυπα

Αντιστοιχίστε ένα σύντομο πρόθεμα σε έναν χώρο ονομάτων στο `blockstudio.json` ή μία ετικέτα σε ένα μπλοκ με ένα φίλτρο alias, και το `<acme-card>` αποδίδει το `acme/card`. Ενεργοποιήστε το `blockTags.enabled` για απόδοση ετικετών στο περιεχόμενο άρθρων και στα widget, με περιορισμό από τα μοτίβα `allow` και `deny`.

Τα χαρακτηριστικά `data-*` φτάνουν στο ριζικό στοιχείο του μπλοκ, ενώ τα χαρακτηριστικά `html-*` φτάνουν εκεί χωρίς το πρόθεμα. Προσθέστε δικούς σας δημιουργούς ετικετών με το `blockstudio/block_tags/builders` και μετατρέψτε τις συντομογραφίες στη φορητή γραφή `<bs:acme-card>` με την εντολή `migrate-block-tags`.

[Διαβάστε τον οδηγό](https://blockstudio.dev/el/guides/block-tags/)

blockstudio.json

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

## Προσαρμοσμένοι τύποι πεδίων

Καταχωρίστε τον δικό σας έλεγχο πεδίου και χρησιμοποιήστε τον όπως ένα ενσωματωμένο πεδίο.

## Νησίδες block

Αποθηκεύστε ολόκληρη τη σελίδα στην cache και αποδώστε ένα block κατά το αίτημα του επισκέπτη.

## Υπό συνθήκη καταχώριση

Καταχωρίστε ένα μπλοκ μόνο για έναν τύπο άρθρου, έναν ρόλο χρήστη ή άλλη καθολική συνθήκη, ή παραλείψτε το όταν λείπει ένα πρόσθετο ή μια έκδοση πρόσθετου που χρειάζεται.

## Μεταδεδομένα αναρτήσεων και επιλογές

Αποθηκεύστε τιμές στα μεταδεδομένα αναρτήσεων ή στις επιλογές, μαζί με τα γνωρίσματα των block.

## Λογική υπό όρους

Εμφανίστε πεδία βάσει τιμών με ισότητα, συμπερίληψη, κενότητα και συγκρίσεις.

## Δυναμική άντληση δεδομένων

Αντλήστε επιλογές από αναρτήσεις, χρήστες, όρους, συναρτήσεις ή API.

## Παρακάμψεις

Ορίστε override: true με το όνομα ενός κοινόχρηστου μπλοκ για συγχώνευση χαρακτηριστικών βάσει id, αντικατάσταση στοιχείων με αρχεία που έχουν τα ίδια ονόματα και αντικατάσταση του προτύπου. Τα πρότυπα Twig μπορούν να παρακάμπτουν μεμονωμένα μπλοκ με το extends.

## Παραλλαγές

Δηλώστε παραλλαγές στο block.json που προκαθορίζουν τιμές πεδίων και αποκρύψτε με το hidden το πεδίο που τις καθορίζει.

## Στοιχεία

Ορίστε component: true για ένα μπλοκ που αποδίδεται μόνο από το PHP ή από ετικέτες μπλοκ. Διατηρεί τα πεδία, τα πρότυπα, τα στοιχεία και το Tailwind, αλλά δεν εμφανίζεται ποτέ στο inserter.

## Κανόνες InnerBlocks

Επιτρέψτε μπλοκ με τα διακριτικά namespace/*, category: και @theme, αλλάξτε το εσωτερικό πρότυπο από μια επιλογή select και αφαιρέστε το περίβλημα στο frontend με ένα φίλτρο.

## Στοιχεία πεδίων κώδικα

Ένα πεδίο κώδικα με asset: true μετατρέπει την είσοδο του επεξεργαστή σε CSS, SCSS ή JavaScript για αυτό το μπλοκ, με εμβέλεια στην παρουσία μέσω του %selector%.

## Στοιχεία ενεργητικού βάσει ονόματος αρχείου

*Το .view.js φορτώνεται μόνο στο frontend, ενώ τα προθέματα global-, admin- και block-editor- φορτώνουν ένα αρχείο σε κάθε σελίδα, στο wp-admin ή στον επεξεργαστή μπλοκ.

## Εικονίδια και φάκελοι μπλοκ

Δώστε σε ένα μπλοκ ένα προσαρμοσμένο εικονίδιο SVG ή HTML, αλλάξτε τη θέση αναζήτησης με το φίλτρο blockstudio/path και προσθέστε φακέλους με το Blockstudio\Build::init().

## Τιμές ACF και Meta Box

Τα πρότυπα λαμβάνουν το $post_id, ώστε τα get_field() και rwmb_get_value() να διαβάζουν το επεξεργασμένο άρθρο, ενώ το refreshOn φορτώνει ξανά την προεπισκόπηση μετά την αποθήκευση.

## Πλαίσιο Query Loop

Μέσα σε ένα Query Loop, το $block[‘context’][‘postId’] ακολουθεί το τρέχον στοιχείο, ενώ το $block[‘postId’] παραμένει το άρθρο που προβάλλεται.

## WPML

Η εντολή wp bs wpml config γράφει το wpml-config.xml που επισημαίνει τα πεδία κειμένου ως μεταφράσιμα, ενώ οι εικόνες που είναι αποθηκευμένες σε πεδία προστίθενται στις εργασίες μετάφρασης WPML μαζί με τα εναλλακτικά κείμενα και τις λεζάντες τους.

Plus

## Το επίσημο κιτ επεκτάσεων

Premium πρότυπα ιστοτόπων, οδηγίες συστήματος AI και ιδιωτική κοινότητα Discord. Εφάπαξ αγορά, ενημερώσεις εφ’ όρου ζωής.

- 500+ πρότυπα ιστοτόπων
- Οδηγίες συστήματος AI
- Ενημερώσεις εφ’ όρου ζωής
- Ιδιωτική κοινότητα Discord

[Αποκτήστε το Plus](https://blockstudio.dev/el/plus/)
