Ugrás a tartalomhoz

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.

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

Lekérdezés Függvény
posts get_posts
users get_users
terms get_terms

Argumentumok

Egyéni argumentumokat a(z) arguments attribútummal adhat meg:

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

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

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

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

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "postTypes",
        "type": "checkbox",
        "label": "Post types",
        "populate": {
          "type": "function",
          "function": "get_post_types",
          "arguments": [[], "objects"]
        }
      }
    ]
  }
}

Visszatérési formátum

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

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

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

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

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

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