Ga naar de inhoud

Opslag

Standaard worden alle veldwaarden opgeslagen als blokattributen in de blokopmerking in de berichtinhoud. Met de opslagfunctie kun je waarden daarnaast opslaan in berichtmeta (wp_postmeta) of opties (wp_options), zodat ze ook buiten de blokcontext toegankelijk zijn.

Waarom opslag gebruiken?

Blokattributen worden opgeslagen in HTML-opmerkingen in de berichtinhoud. Daardoor zijn ze alleen toegankelijk wanneer blokinhoud wordt geparseerd. Met extra opslaglocaties kun je:

  • Berichten op veldwaarden opvragen met meta_query
  • Waarden openen via REST API voor headless configuraties
  • Gegevens delen met andere plugins, zoals SEO of cachingplugins
  • Globale instellingen maken die voor alle berichten behouden blijven

Opslagtypen

Type Locatie Bereik Geschikt voor
postMeta tabel wp_postmeta Per bericht Opvraagbare berichtspecifieke gegevens
option tabel wp_options Globaal (hele site) Site-instellingen, gedeelde waarden

Opmerking

Blokattribuutopslag (in de opmerking HTML van de berichtinhoud) gebeurt altijd automatisch. De eigenschap storage voegt extra opslaglocaties toe; deze vervangt de blokopslag niet.

Configuratie

Voeg de eigenschap storage toe aan een velddefinitie:

JSON
{
  "name": "blockstudio/example",
  "title": "Example Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "subtitle",
        "type": "text",
        "label": "Subtitle",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "my_subtitle"
        }
      }
    ]
  }
}

Opslageigenschappen

Eigenschap Type Beschrijving
type string | string[] Extra opslaglocation(s): "postMeta", "option"
postMetaKey string Aangepaste metakey (standaard: {block_name}_{field_id})
optionKey string Aangepaste optiesleutel (standaard: {block_name}_{field_id})

Enkele of meerdere opslaglocaties

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

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

Hoe het werkt

  1. Registratie: Wanneer WordPress wordt geladen, registreert Blockstudio meta-sleutels en instellingen op basis van je veldconfiguraties
  2. Bewerken: Waarden worden in de editor beheerd als blokattributen (altijd opgeslagen in het blok)
  3. Opslaan: Berichtmeta wordt gesynchroniseerd wanneer het bericht wordt opgeslagen. Siteopties worden gesynchroniseerd wanneer het bericht wordt gepubliceerd of wanneer de veldwaarde van een gepubliceerd bericht verandert.

Autosaves en revisies synchroniseren geen van beide opslaglocaties. Concepten, berichten in afwachting, privéberichten en ingeplande berichten kunnen hun eigen berichtmeta bijwerken, maar wijzigen de live siteopties niet. Siteopties worden gesynchroniseerd wanneer WordPress een ingepland bericht publiceert.

Waarden worden letterlijk gekopieerd, inclusief backslashes, aanhalingstekens en geneste repeaterwaarden. Voeg geen escaping toe aan veldwaarden om te compenseren voor WordPress-metagegevensopslag; Blockstudio handelt die grens af. Siteopties behouden dezelfde letterlijke waarden zonder extra slashes.

Als een eerdere versie backslashes uit de meta-kopie van een bericht verwijderde, sla het bericht dan opnieuw op na de upgrade. De oorspronkelijke veldwaarde in de blokkenmerken wordt gebruikt om de meta-kopie bij te werken.

Siteopties opslaan

Opties worden op de hele site gedeeld. Wanneer een nieuw blok wordt gepubliceerd, worden de optievelden uit de opgeslagen attributen ervan weggeschreven. Bij latere opslagacties wordt elk veld vergeleken met de eerder opgeslagen versie van dat blok en worden alleen gewijzigde waarden weggeschreven. Het opslaan van de titel van een bericht of van een ongewijzigde, oudere kopie van het blok in een ander bericht overschrijft geen nieuwere optiewaarde.

Een veld dat niet is opgenomen in de opgeslagen attributen laat de optie ongemoeid. Dit beschermt ook bestaande opties wanneer een nieuw veld wordt toegevoegd aan block.json. Een expliciete null verwijdert een optie; lege tekenreeksen, false, 0 en lege arrays worden als waarden opgeslagen. Als u een blok verwijdert, worden de bijbehorende opties niet verwijderd.

Gebruik één aangewezen gepubliceerd blok om elke gedeelde optie te beheren. Als meerdere blokken bewust dezelfde optie wijzigen, wordt de laatst opgeslagen gewijzigde waarde gebruikt. De opslag laadt de huidige optie niet in elk blok: elk blok behoudt zijn eigen veldwaarden in de berichtinhoud.

Voor pagina’s op basis van bestanden zorgt een persistent blok key ervoor dat Blockstudio hetzelfde blok herkent nadat het in het document is verplaatst. Blokken zonder sleutel worden gekoppeld op basis van bloknaam en positie.

Opgeslagen waarden openen

In bloktemplates

In de template van uw blok zijn veldwaarden altijd beschikbaar via $attributes:

PHP

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

Twig

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

Berichtmeta (buiten de blokcontext)

Waarden die zijn opgeslagen in postMeta zijn overal in WordPress toegankelijk:

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) }}

Berichtmeta is ook beschikbaar via REST API:

Shell
GET /wp-json/wp/v2/posts/123
# Response includes: { "meta": { "my_subtitle": "Hello World" } }

Opties (globale waarden)

Waarden die zijn opgeslagen in option zijn overal op de site toegankelijk:

PHP

PHP
$company_name = get_option( 'site_company_name' );

Twig

Twig
{{ function('get_option', 'site_company_name') }}

Voorbeelden

SEO-metavelden

Sla SEO-gegevens op in berichtmeta voor compatibiliteit met plugins voor 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"
        }
      }
    ]
  }
}

Voeg opslag van berichtmeta toe om berichten op te vragen op basis van veldwaarde:

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

Aanbevolen berichten opvragen:

PHP
$featured_posts = get_posts([
  'meta_key'   => 'is_featured',
  'meta_value' => '1',
]);

Globale site-instellingen

Sla sitebrede configuratie op in opties:

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

Overal op uw site toegankelijk:

PHP
<footer>
  <p>&copy; <?php echo get_option( 'site_company_name' ); ?></p>
  <p>Contact: <?php echo get_option( 'site_support_email' ); ?></p>
</footer>

Berichtmeta en optie

Voor gegevens die zowel op berichtniveau als globaal toegankelijk moeten zijn:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "important_value",
        "type": "text",
        "label": "Important Value",
        "storage": {
          "type": ["postMeta", "option"],
          "postMetaKey": "important_meta",
          "optionKey": "important_option"
        }
      }
    ]
  }
}

Standaardsleutelnamen

Als u geen aangepaste sleutel opgeeft, genereert Blockstudio er automatisch een:

Opslagtype Standaardsleutelformaat Voorbeeld
postMeta {block_name}_{field_id} blockstudio_example_subtitle
option {block_name}_{field_id} blockstudio_example_subtitle

De bloknaam wordt opgeschoond (slashes worden vervangen door underscores).

Waarschuwing

Voor productiegebruik worden aangepaste sleutels aanbevolen. Standaardsleutels kunnen veranderen als u de naam van uw blok wijzigt.