Stocare
În mod implicit, toate valorile câmpurilor sunt stocate ca atribute ale blocului în comentariul blocului din conținutul articolului. Funcția de stocare vă permite să stocați suplimentar valorile în meta datele articolului (wp_postmeta) sau în opțiuni (wp_options), făcându-le accesibile și în afara contextului blocului.
De ce să folosiți stocarea?
Atributele blocului sunt stocate în comentariile HTML din conținutul articolului, ceea ce înseamnă că sunt accesibile numai la analizarea conținutului blocului. Folosind locații de stocare suplimentare, puteți:
- Interoga articolele după valorile câmpurilor folosind
meta_query - Accesa valorile prin REST API în configurații headless
- Partaja date cu alte pluginuri, precum SEO sau pluginuri de cache
- Crea setări globale care persistă între articole
Tipuri de stocare
| Tip | Locație | Domeniu | Recomandat pentru |
|---|---|---|---|
postMeta |
tabelul wp_postmeta |
Per articol | Date interogabile, specifice articolului |
option |
tabelul wp_options |
Global (la nivelul site-ului) | Setări ale site-ului, valori partajate |
Notă
Stocarea atributelor blocului (în comentariul HTML din conținutul articolului) are loc întotdeauna automat. Proprietatea
storageadaugă locații de stocare suplimentare — nu înlocuiește stocarea în bloc.
Configurare
Adăugați proprietatea storage la orice definiție de câmp:
{
"name": "blockstudio/example",
"title": "Example Block",
"blockstudio": {
"attributes": [
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta",
"postMetaKey": "my_subtitle"
}
}
]
}
}
Proprietăți de stocare
| Proprietate | Tip | Descriere |
|---|---|---|
type |
string | string[] |
location(s) suplimentară: "postMeta", "option" |
postMetaKey |
string |
Cheie meta personalizată (implicit: {block_name}_{field_id}) |
optionKey |
string |
Cheie de opțiune personalizată (implicit: {block_name}_{field_id}) |
Stocare unică sau multiplă
// Add post meta storage
"storage": {
"type": "postMeta"
}
// Add both post meta and option storage
"storage": {
"type": ["postMeta", "option"]
}
Cum funcționează
- Înregistrare: La încărcarea WordPress, Blockstudio înregistrează cheile meta și setările pe baza configurațiilor câmpurilor
- Editare: Valorile sunt gestionate ca atribute ale blocului în editor (stocate întotdeauna în bloc)
- Salvare: Meta datele articolului sunt sincronizate la salvarea articolului. Opțiunile site-ului sunt sincronizate la publicarea articolului sau când se schimbă valoarea unui câmp dintr-un articol publicat.
Salvările automate și reviziile nu sincronizează niciuna dintre locațiile de stocare. Articolele în ciornă, în așteptare, private și programate își pot actualiza propriile meta date, dar nu modifică opțiunile active ale site-ului. Un articol programat sincronizează opțiunile când WordPress îl publică.
Valorile sunt copiate literal, inclusiv barele oblice inverse, ghilimelele și valorile repeater imbricate. Nu adăugați caractere de escapare la valorile câmpurilor pentru a compensa stocarea metadatelor WordPress; Blockstudio gestionează această delimitare. Opțiunile site-ului păstrează aceleași valori literale, fără caractere slash suplimentare.
Dacă o versiune anterioară a eliminat barele oblice inverse din copia meta a unei postări, salvați din nou postarea după actualizare. Valoarea originală a câmpului din atributele blocului este folosită pentru a reîmprospăta copia meta.
Salvarea opțiunilor site-ului
Opțiunile sunt partajate pe întregul site. Publicarea unui bloc nou scrie câmpurile de opțiuni furnizate în atributele salvate ale acestuia. Salvările ulterioare compară fiecare câmp cu versiunea salvată anterior a blocului respectiv și scriu numai valorile modificate. Salvarea titlului unui articol sau a unei copii mai vechi și nemodificate a blocului dintr-un alt articol nu suprascrie o valoare de opțiune mai nouă.
Un câmp omis din atributele salvate lasă opțiunea neschimbată. Astfel sunt protejate și opțiunile existente atunci când se adaugă un câmp nou la block.json. Un null explicit șterge o opțiune; șirurile goale, false, 0 și tablourile goale sunt salvate ca valori. Eliminarea unui bloc nu șterge opțiunile.
Folosiți câte un bloc publicat desemnat pentru a gestiona fiecare opțiune partajată. Dacă mai multe blocuri modifică intenționat aceeași opțiune, câștigă ultima valoare modificată și salvată. Stocarea nu încarcă opțiunea curentă în fiecare bloc: fiecare bloc își păstrează propriile valori ale câmpurilor în conținutul articolului.
Pentru paginile bazate pe fișiere, o cheie persistentă a blocului key îi permite lui Blockstudio să recunoască același bloc după mutarea acestuia în document. Blocurile fără cheie sunt asociate după numele și poziția blocului.
Accesarea valorilor stocate
În șabloanele blocurilor
În șablonul blocului, valorile câmpurilor sunt întotdeauna disponibile prin $attributes:
PHP
<div>
<h1><?php echo $a['subtitle']; ?></h1>
</div>
Twig
<div>
<h1>{{ a.subtitle }}</h1>
</div>
Metadatele articolului (în afara contextului blocului)
Valorile stocate în postMeta pot fi accesate oriunde în WordPress:
PHP
// Get meta value
$subtitle = get_post_meta( $post_id, 'my_subtitle', true );
// Query posts by meta value
$posts = get_posts([
'meta_key' => 'my_subtitle',
'meta_value' => 'Hello World',
]);
Twig
{# Using Timber #}
{{ post.meta('my_subtitle') }}
{# Or via function #}
{{ function('get_post_meta', post.id, 'my_subtitle', true) }}
Metadatele articolului sunt disponibile și prin REST API:
GET /wp-json/wp/v2/posts/123
# Response includes: { "meta": { "my_subtitle": "Hello World" } }
Opțiuni (valori globale)
Valorile stocate în option sunt accesibile pe întregul site:
PHP
$company_name = get_option( 'site_company_name' );
Twig
{{ function('get_option', 'site_company_name') }}
Exemple
Câmpuri de metadate SEO
Stocați date SEO în metadatele articolului pentru compatibilitate cu pluginurile SEO:
{
"blockstudio": {
"attributes": [
{
"id": "seo_title",
"type": "text",
"label": "SEO Title",
"storage": {
"type": "postMeta",
"postMetaKey": "_yoast_wpseo_title"
}
},
{
"id": "seo_description",
"type": "textarea",
"label": "Meta Description",
"storage": {
"type": "postMeta",
"postMetaKey": "_yoast_wpseo_metadesc"
}
}
]
}
}
Conținut recomandat cu interogare
Adăugați stocarea metadatelor articolului pentru a putea interoga articolele după valoarea câmpului:
{
"blockstudio": {
"attributes": [
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
}
]
}
}
Interogați articolele recomandate:
$featured_posts = get_posts([
'meta_key' => 'is_featured',
'meta_value' => '1',
]);
Setări globale ale site-ului
Stocați configurația întregului site în opțiuni:
{
"blockstudio": {
"attributes": [
{
"id": "company_name",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
},
{
"id": "support_email",
"type": "text",
"label": "Support Email",
"storage": {
"type": "option",
"optionKey": "site_support_email"
}
}
]
}
}
Accesați oriunde pe site:
<footer>
<p>© <?php echo get_option( 'site_company_name' ); ?></p>
<p>Contact: <?php echo get_option( 'site_support_email' ); ?></p>
</footer>
Metadatele articolului și opțiunea
Pentru date care trebuie să fie accesibile atât la nivelul articolului, cât și la nivel global:
{
"blockstudio": {
"attributes": [
{
"id": "important_value",
"type": "text",
"label": "Important Value",
"storage": {
"type": ["postMeta", "option"],
"postMetaKey": "important_meta",
"optionKey": "important_option"
}
}
]
}
}
Numele cheilor implicite
Dacă nu specificați o cheie personalizată, Blockstudio generează automat una:
| Tip de stocare | Formatul cheii implicite | Exemplu |
|---|---|---|
postMeta |
{block_name}_{field_id} |
blockstudio_example_subtitle |
option |
{block_name}_{field_id} |
blockstudio_example_subtitle |
Numele blocului este normalizat (barele oblice sunt înlocuite cu caractere de subliniere).
Avertisment
Se recomandă folosirea cheilor personalizate în producție. Cheile implicite se pot schimba dacă redenumiți blocul.