Filtrering af attributter
Blockstudio indeholder to metoder til at filtrere blokattributter.
Attributdefinitioner
blockstudio/blocks/attributes filtrerer hver feltdefinition, mens Blockstudio
opbygger og registrerer en blok. Brug den til at justere editorens kontroller, standardværdier,
betingelser, indstillinger og definitionen, der bruges til at validere værdier under
rendering.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'my-theme/code-block' &&
($attribute['id'] ?? '') === 'lineNumbers'
) {
$attribute['default'] = true;
$attribute['conditions'] = [
[
[
'id' => 'language',
'operator' => '==',
'value' => 'css'
]
]
];
}
return $attribute;
}, 10, 2);
Koden ovenfor angiver standardværdien for lineNumbers til true og skjuler feltet,
medmindre language er angivet til css.
Callbacken modtager én feltdefinition pr. kald, herunder indlejrede gruppe- og gentagerfelter. Den kører under blokregistrering, ikke én gang pr. frontend-rendering.
Filtrerede indstillingsdefinitioner bruges også af renderingsattributkortet. En indstilling, der føjes til et select-, radio– eller checkbox-felt, er f.eks.
tilgængelig i editoren og forbliver gyldig, når Blockstudio finder den gemte
værdi til en skabelon:
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (
($block['name'] ?? '') === 'bsui/button' &&
($attribute['id'] ?? '') === 'variant'
) {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
Renderede værdier
blockstudio/blocks/attributes/render filtrerer den løste værdi for ét felt umiddelbart før den sendes til blokskabelonen. Det køres én gang for hvert felt, så et callback modtager værdien, feltnøglen og blokdataene.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
if (($block['name'] ?? '') === 'my-theme/code-block' && 'lineNumbers' === $key) {
return true;
}
return $value;
}, 10, 3);
Eksemplet ovenfor tilsidesætter enhver værdi, der er gemt i editoren for lineNumbers.
Registrér callbacken med tre accepterede argumenter (det sidste argument til add_filter); ellers sender WordPress kun værdien videre.
$value: feltets løste værdi i den form, skabelonen modtager som$a[$key]. Returnér den værdi, skabelonen skal modtage.$key: feltets nøgle, som den bruges i$a. I en gentagelsesrække er dette feltets ID i rækken.$block: blokdataarrayet, som skabeloner modtager som$blockeller$b, medid,name,postId,postType,index,indexTotal,contextog ø-flagene. For udvidelser, der anvendes på en blok, som ikke er en Blockstudio-blok, indeholder$blockkun postenblockstudio(attributesogdisabled) og har ingenname.
Filteret køres også for attributter, der ikke er Blockstudio-felter, såsom className og anchor, samt for <id>__size-ledsageren til et filfelt, så sammenlign $key, før du ændrer en værdi. Returværdien erstatter kun værdien af $key; filteret kan ikke tilføje nye nøgler til $a.
Brug definitionsfilteret til at ændre feltkonfigurationen og gengivelsesfilteret til at beregne eller tilsidesætte skabelonværdier for en anmodning.
Når værdier læses via bs_block_values() i stedet for at blive gengivet, modtager dette filter kun bloknavnet i $block. Gengivelsestællere og andre metadata, der kun bruges ved gengivelse, oprettes ikke af denne hjælper.