Primii pași
Acest ghid te va ajuta să configurezi Blockstudio și să creezi primul bloc personalizat.
Instalare
Prin Composer (recomandat)
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:
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
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:
my-theme/
blockstudio/
my-first-block/
block.json
index.php
2. Definește schema blocului
Creează block.json cu configurația blocului:
{
"$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:
<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:
<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:
.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:
- Tipuri de câmpuri – Toate tipurile de câmp disponibile
- Componente – InnerBlocks, RichText și altele
- Tailwindintegrare – Folosirea Tailwind CSS
- Cârlige – Extinderea funcționalității cu filtre și acțiuni
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.