Treci la conținut

Primii pași

Acest ghid te va ajuta să configurezi Blockstudio și să creezi primul bloc personalizat.

Instalare

Shell
composer require blockstudio/blockstudio

Blockstudio poate fi instalat ca plugin prin composer/installers sau inclus direct într-o temă. Consultă documentația Composer pentru toate metodele de instalare.

Instalările Composer primesc actualizări prin Composer. Actualizatorul GitHub încorporat este dezactivat automat.

Instalare manuală

Descarcă cea mai recentă versiune de la GitHub

Încarcă arhiva zip în directorul de pluginuri WordPress și activează pluginul. Instalările manuale primesc notificări automate despre actualizări în panoul WordPress, prin actualizatorul GitHub încorporat.

Ambele metode de instalare includ copii private ale bibliotecilor Markdown, YAML și de actualizare, precum și dependențele acestora. Nu folosesc și nu înlocuiesc versiunile furnizate de alt plugin sau temă. Instalați propria dependență Composer dacă aplicația folosește direct una dintre aceste biblioteci; copiile incluse în Blockstudio sunt interne, nu o PHP API publică.

Verificări de actualizare autentificate

Instalările manuale verifică în mod implicit GitHub anonim. Mai multe site-uri care folosesc aceeași adresă IP de ieșire pot epuiza limita API anonimă GitHub și pot primi răspunsuri HTTP 403 când verifică actualizările. Din 7.7.4, configurați un token de acces personal GitHub în wp-config.php, înainte de încărcarea WordPress:

PHP
define('BLOCKSTUDIO_GITHUB_TOKEN', 'your-github-token');

Tokenul are nevoie doar de acces la informațiile publice ale depozitului. Nu acordați permisiuni de scriere. Păstrați-l în configurația de pe server, în afara controlului versiunilor, a blockstudio.json, a atributelor blocurilor și a codului frontend. Actualizatorul îl transmite clientului GitHub inclus pentru verificări autentificate și descărcări de versiuni. Cererile către depozite fără legătură și alte gazde de descărcare nu primesc tokenul.

Pentru secrete gestionate prin mediu, un plugin MU poate furniza sau suprascrie tokenul:

PHP
<?php
add_filter('blockstudio/updater/token', function ($token) {
  return getenv('BLOCKSTUDIO_GITHUB_TOKEN') ?: $token;
});

Filtrul rulează când Blockstudio inițializează actualizatorul, înainte de încărcarea temei. Înregistrați-l într-un plugin MU, nu în functions.php. Returnarea unui șir gol dezactivează autentificarea chiar dacă constanta este definită. Valorile goale sau care nu sunt șiruri păstrează verificările anonime. Tokenurile sunt opționale; fără unul, comportamentul existent al actualizărilor rămâne neschimbat. Instalările Composer folosesc în continuare Composer pentru actualizări și nu inițializează acest actualizator.

Crearea primului bloc

1. Creează un director pentru bloc

Creează un director nou în tema ta:

Cod
my-theme/
  blockstudio/
    my-first-block/
      block.json
      index.php

2. Definește schema blocului

Creează block.json cu configurația blocului:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/my-first-block",
  "title": "My First Block",
  "category": "common",
  "icon": "star-filled",
  "blockstudio": {
    "attributes": [
      {
        "id": "heading",
        "type": "text",
        "label": "Heading",
        "default": "Hello World"
      },
      {
        "id": "content",
        "type": "textarea",
        "label": "Content"
      }
    ]
  }
}

3. Creează șablonul

Creează index.php pentru randare:

PHP
<div class="my-first-block">
  <h2><?php echo $a['heading']; ?></h2>
  <p><?php echo $a['content']; ?></p>
</div>

Folosirea șabloanelor Twig

Blockstudio acceptă șabloane Twig fără configurări suplimentare. Folosește pur și simplu index.twig în schimb:

Twig
<div class="my-first-block">
  <h2>{{ a.heading }}</h2>
  <p>{{ a.content }}</p>
</div>

Adăugarea stilurilor

Creează un fișier style.css în același dosar:

CSS
.my-first-block {
  padding: 2rem;
  background: #f5f5f5;
}

Blockstudio va adăuga automat această foaie de stiluri în coadă atunci când blocul este folosit.

Traduceri

Comenzile din editor și prezentarea generală din panoul de administrare ale Blockstudio încarcă traducerile JavaScript pentru domeniul de text blockstudio prin WordPress. Instalează un pachet lingvistic corespunzător sau generează fișiere JSON cu traducerile scripturilor folosind instrumentul tău de traducere din wp-content/languages/plugins/. Șirurile fără traducere disponibilă rămân în engleză. Aceasta traduce interfața proprie a Blockstudio, nu conținutul sau etichetele câmpurilor pe care le definești în blocuri.

Pașii următori

Blocul tău este acum gata de folosit în editorul WordPress. Continuă să explorezi documentația pentru a afla mai multe despre:

Construirea unei biblioteci de blocuri

Treci de la un singur bloc la o bibliotecă completă: tokenuri de design, modelul de secțiune, repetoare, imagini și compunerea paginilor.