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
storagevoegt extra opslaglocaties toe; deze vervangt de blokopslag niet.
Configuratie
Voeg de eigenschap storage toe aan een velddefinitie:
{
"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
// Add post meta storage
"storage": {
"type": "postMeta"
}
// Add both post meta and option storage
"storage": {
"type": ["postMeta", "option"]
}
Hoe het werkt
- Registratie: Wanneer WordPress wordt geladen, registreert Blockstudio meta-sleutels en instellingen op basis van je veldconfiguraties
- Bewerken: Waarden worden in de editor beheerd als blokattributen (altijd opgeslagen in het blok)
- 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
<div>
<h1><?php echo $a['subtitle']; ?></h1>
</div>
Twig
<div>
<h1>{{ a.subtitle }}</h1>
</div>
Berichtmeta (buiten de blokcontext)
Waarden die zijn opgeslagen in postMeta zijn overal in WordPress toegankelijk:
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) }}
Berichtmeta is ook beschikbaar via REST API:
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
$company_name = get_option( 'site_company_name' );
Twig
{{ function('get_option', 'site_company_name') }}
Voorbeelden
SEO-metavelden
Sla SEO-gegevens op in berichtmeta voor compatibiliteit met plugins voor 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"
}
}
]
}
}
Aanbevolen inhoud opvragen
Voeg opslag van berichtmeta toe om berichten op te vragen op basis van veldwaarde:
{
"blockstudio": {
"attributes": [
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
}
]
}
}
Aanbevolen berichten opvragen:
$featured_posts = get_posts([
'meta_key' => 'is_featured',
'meta_value' => '1',
]);
Globale site-instellingen
Sla sitebrede configuratie op in opties:
{
"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:
<footer>
<p>© <?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:
{
"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.