Treci la conținut

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 storage adaugă locații de stocare suplimentare — nu înlocuiește stocarea în bloc.

Configurare

Adăugați proprietatea storage la orice definiție de câmp:

JSON
{
  "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ă

JSON
// Add post meta storage
"storage": {
  "type": "postMeta"
}

// Add both post meta and option storage
"storage": {
  "type": ["postMeta", "option"]
}

Cum funcționează

  1. Înregistrare: La încărcarea WordPress, Blockstudio înregistrează cheile meta și setările pe baza configurațiilor câmpurilor
  2. Editare: Valorile sunt gestionate ca atribute ale blocului în editor (stocate întotdeauna în bloc)
  3. 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

PHP
<div>
  <h1><?php echo $a['subtitle']; ?></h1>
</div>

Twig

Twig
<div>
  <h1>{{ a.subtitle }}</h1>
</div>

Metadatele articolului (în afara contextului blocului)

Valorile stocate în postMeta pot fi accesate oriunde în WordPress:

PHP

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

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:

Shell
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

PHP
$company_name = get_option( 'site_company_name' );

Twig

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:

JSON
{
  "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"
        }
      }
    ]
  }
}

Adăugați stocarea metadatelor articolului pentru a putea interoga articolele după valoarea câmpului:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "featured",
        "type": "toggle",
        "label": "Featured",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "is_featured"
        }
      }
    ]
  }
}

Interogați articolele recomandate:

PHP
$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:

JSON
{
  "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:

PHP
<footer>
  <p>&copy; <?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:

JSON
{
  "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.