Beállítások feltöltése
A különböző mezőtípusok, például bejegyzések, felhasználók vagy kifejezések megadása helyett a(z) Blockstudio moduláris módot biztosít az adatok közvetlen, a(z) block.json-ból történő feltöltésére. Ez a funkció a(z) select, radio, checkbox, color és gradient mezőtípusokkal működik.
Az adatok négyféleképpen tölthetők fel:
- Lekérdezés – Eredmények visszaadása bejegyzés-, felhasználó- vagy kifejezéslekérdezésből
- Lekérés – Eredmények visszaadása külső forrásból
- Függvény – Eredmények visszaadása egy egyéni függvényből
- Egyéni – Eredmények visszaadása egy egyéni adatkészletből
Lekérdezés
Lekérdezési mód választásakor Bejegyzések, Felhasználók vagy Kifejezések tölthetők fel.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/native",
"title": "Native Block",
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts"
}
}
]
}
}
Az elérhető lekérdezéstípusok belső működésük során ezeket a(z) WordPress függvényeket használják:
Argumentumok
Egyéni argumentumokat a(z) arguments attribútummal adhat meg:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "jobs",
"numberposts": "20"
}
}
}
]
}
}
Visszatérési formátum
Alapértelmezés szerint a(z) Blockstudio a következőket adja vissza:
| Lekérdezés | Érték | Címke |
|---|---|---|
posts |
bejegyzésobjektum | post_title |
users |
felhasználóobjektum | display_name |
terms |
kifejezésobjektum | name |
A válasz testreszabása a(z) returnFormat segítségével:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "posts",
"numberposts": "20"
},
"returnFormat": {
"value": "id",
"label": "post_name"
}
}
}
]
}
}
Lekérési mód
A dinamikus keresés engedélyezéséhez kapcsolja be a(z) fetch beállítást:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"fetch": true,
"arguments": {
"post_type": "posts",
"numberposts": "20"
}
}
}
]
}
}
Ez engedélyezi a(z) stylisedUi funkciót, és kezdetben lekéri az első 20 bejegyzést. A választómezőbe beírva a(z) s argumentummal kereshet bejegyzések között.
Függvény
A beállítások feltöltéséhez használjon egyéni függvényt:
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types"
}
}
]
}
}
Argumentumok
Az argumentumokat tömbként adja meg (belsőleg a(z) call_user_func_array függvényt használja):
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"]
}
}
]
}
}
Visszatérési formátum
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"],
"returnFormat": {
"value": "name",
"label": "label"
}
}
}
]
}
}
Beállítások keverése
Statikus beállítások kombinálása feltöltött adatokkal:
{
"blockstudio": {
"attributes": [
{
"id": "users",
"type": "radio",
"label": "Users",
"options": [
{
"value": "administrators",
"label": "Administrators"
},
{
"value": "editors",
"label": "Editors"
}
],
"populate": {
"type": "query",
"query": "users",
"position": "before"
}
}
]
}
}
A(z) position beállítás (before vagy after) szabályozza, hogy a feltöltött beállítások hol jelenjenek meg a statikus beállításokhoz képest.
Figyelmeztetés
A beállítások és a feltöltött adatok keverése lekérési módban nem támogatott.
Egyéni adatok
Hozzon létre újra felhasználható adatkészleteket a(z) blockstudio/blocks/attributes/populate szűrővel. A szűrő egyetlen argumentumként az összes egyéni adatkészletet név szerint kulcsoló tömböt kapja. Adja hozzá az adatkészletet egy kulcshoz, majd adja vissza a tömböt:
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['customData'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
Ezután hivatkozzon a kulcsra a blokkjában:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "custom",
"custom": "customData"
}
}
]
}
}
Külső adatok
Adatok lekérése külső forrásból:
{
"blockstudio": {
"attributes": [
{
"id": "select",
"type": "select",
"label": "Select",
"multiple": true,
"populate": {
"type": "fetch",
"arguments": {
"urlSearch": "https://example.com/wp-json/wp/v2/posts?search="
},
"returnFormat": {
"value": "id",
"label": "title.rendered"
}
}
}
]
}
}
A keresőkifejezés a(z) urlSearch végére kerül.
Dinamikus argumentumok
A feltöltés argumentumai a {attributes.*} szintaxis használatával más blokkattribútumokra is hivatkozhatnak. Ha a hivatkozott attribútum megváltozik, a mező automatikusan újra lekéri a beállításait.
{
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post Type",
"options": [
{ "label": "Pages", "value": "page" },
{ "label": "Posts", "value": "post" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Select Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type.value}",
"numberposts": 10
}
}
}
]
}
}
Ez minden feltöltési típusnál működik (query, function, custom). A feltöltési konfiguráció minden olyan értékét, amely tartalmazza a(z) {attributes.*} elemet, a rendszer az ügyféloldalon, az aktuális attribútumértékkel oldja fel a lekérdezés futtatása előtt.
A hivatkozások a szerkesztőben tárolt értékeket használják. Egy kiválasztási lehetőségnél használja a {attributes.post_type.value} elemet az értékéhez, vagy a {attributes.post_type.label} elemet a címkéjéhez; a returnFormat a sablonban használt értéket szabályozza, nem ezt a szerkesztőben tárolt formát.
A beágyazott argumentumok úgy oldódnak fel, hogy közben nem szerializálódnak sablonszöveggé. Ha egy argumentum egyetlen helyőrzőből áll, megőrzi a hivatkozott típusát, beleértve a számokat, logikai értékeket, tömböket és objektumokat. A más szövegbe ágyazott helyőrző karakterláncot eredményez. A hiányzó hivatkozások változatlanok maradnak, az idézőjeleket tartalmazó és a többsoros értékek pedig érintetlenül kerülnek továbbításra.
A függvény-visszahívások megőrzik a pozicionális argumentumlistájukat. A szerkesztő csak a query kitöltésekor ad hozzá WordPress keresési argumentumokat; a függvényhívásokhoz nem.
Függő kiválasztások megjelenítése
A függő lehetőségek nem töltődnek be a blokk regisztrálásakor, mivel az egyes blokkpéldányok argumentumai eltérhetnek. Megjelenítéskor a rendszer a mentett kiválasztást használja, ahelyett hogy üres lehetőséglistával összevetve elvetné. A kitöltési visszahívás nem fut le újra a felhasználói felületen.
A mező returnFormat beállítása továbbra is érvényes:
returnFormat |
Egyszeres választás | Többszörös választás |
|---|---|---|
value (alapértelmezett) |
A mentett érték, például "a" |
A mentett értékek tömbje, például ["a", "b"] |
label |
A mentett címke | A mentett címkék tömbje |
both |
A mentett {value, label} lehetőség |
A mentett lehetőségek tömbje |
A lekérdezéssel feltöltött választásoknál az értékek továbbra is a megfelelő
WordPress bejegyzés-, felhasználó- vagy kifejezésobjektumra oldódnak fel, kivéve, ha a populate.returnFormat.value értéke
"id". A címkék a mentett választásból származnak. Ha egy importált választásnak nincs
címkéje, az értéke szolgál címkeként. Az options fájlban deklarált, egyező statikus lehetőség elsőbbséget élvez a mentett lehetőséggel szemben, ezért annak aktuális címkéje érvényesül.
Az üres választások false maradnak (vagy a mező beállított fallback értékét veszik fel). Ez
nem módosítja a hagyományos statikus lehetőségek érvényesítését: a mentett érték, amely már nem szerepel a statikus lehetőségek listáján, továbbra is false értéket ad vissza.
A dinamikus választómezők is megőrzik az default és fallback választásokat, amíg a
lehetőségeik betöltése késik. Használj skalárértéket, {value, label} lehetőségobjektumot vagy ezek bármelyikéből álló tömböt többszörös választáshoz. A skalárérték a saját értékét használja címkeként, kivéve, ha megfelel egy deklarált statikus lehetőségnek. A lehetőségobjektum megőrzi a megadott címkét; az egyező statikus lehetőség elsőbbséget élvez. A szerveren nem fut populate visszahívás ezen alapértelmezett értékek lekérésére.