Ugrás a tartalomhoz

PHP hookok

Az alábbiakban a bővítmény funkcióinak kiterjesztéséhez vagy módosításához használható összes PHP hook listáját találja.

Elérési út

Ezzel a szűrővel módosíthatja a blokk mappájának elérési útját. Alapértelmezés szerint ez az aktív témán belüli blockstudio. Több forráskönyvtár használatához új példányt is létrehozhat.

PHP
add_filter('blockstudio/path', function() {
  $path = get_stylesheet_directory() . '/blocks';
  return $path;
});

Inicializálás

globális

Ez a művelet azután fut le, hogy a bővítmény regisztrálta az összes blokkot.

PHP
add_action('blockstudio/init', function($blocks) {
  // All blocks have been registered
});

példány

Ez a művelet azután fut le, hogy a bővítmény regisztrálta egy adott példány összes blokkját. A $instance szegmens az wp-content-hez viszonyított példányútvonal.

PHP
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/$instance", function() {
  // All blocks of this instance have been registered
});

global/before

Ez a művelet azelőtt fut le, hogy a bővítmény regisztrálná az összes blokkot.

PHP
add_action('blockstudio/init/before', function() {
  // Before blocks are registered
});

global/before/$instance

Ez a művelet azelőtt fut le, hogy a bővítmény regisztrálná egy adott példány összes blokkját.

PHP
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/before/$instance", function() {
  // Before blocks of this instance are registered
});

Blokkok

megjelenítés

Ezzel a szűrővel módosíthatja egy blokk kimenetét a megjelenítés előtt.

PHP
add_filter('blockstudio/blocks/render', function($content, $block, $attributes) {
  // Modify the block content
  return $content;
}, 10, 3);

metaadatok

Ezzel a szűrővel módosíthatja a block.json fájl adatait a regisztráció előtt.

PHP
add_filter('blockstudio/blocks/meta', function($meta, $block) {
  if (str_starts_with($block['name'], 'marketing')) {
    $meta['icon'] = 'megaphone';
  }
  return $meta;
}, 10, 2);

A fenti kód módosítja minden, marketing kezdetű blokk ikonját.

feltételek

Ez a szűrő lehetővé teszi egyéni feltételek hozzáadását, amelyek blokkokban használhatók. Minden feltételtípus egy értéknek felel meg, amelyet a szerkesztő a feltétel value értékével hasonlít össze. Lásd: Egyéni feltételek.

PHP
add_filter('blockstudio/blocks/conditions', function($conditions) {
  $conditions['myCustomCondition'] = 'expected';
  return $conditions;
});

attribútumok

Ez a szűrő egy meződefiníciót módosít a blokk regisztrálása előtt. A szűrt definíció határozza meg a szerkesztő vezérlőelemét és a megjelenítéskori értékellenőrzést. További információért lásd a Szűrés című részt.

PHP
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
  // Modify this field definition before registration.
  return $attribute;
}, 10, 2);

attributes/render

Ez a szűrő módosítja egy mező értékét, mielőtt az átadásra kerül a blokksablonnak. Mezőnként egyszer fut le, és három argumentumot kap: $value (a feloldott érték), $key (a mezőkulcs, a $a szerinti alakban) és $block (a blokkok adattömbje, amelyet a sablonok $block vagy $b néven kapnak meg). Három elfogadott argumentummal regisztrálja. További információért lásd: Szűrés.

PHP
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
  // Modify the value of one field before rendering.
  return $value;
}, 10, 3);

attributes/files/sizes

A files mező minden képet egy sizes tömbbel együtt ad vissza, amely tartalmazza a URL értékét, a full szélességét és magasságát, valamint minden regisztrált képméret szélességét és magasságát, például a $image['sizes']['thumbnail'] és a $image['sizes']['thumbnail-width'] értékét. Minden méret képenként egy wp_get_attachment_image_src() hívást jelent, ezért a szűrői továbbra is érvényesülnek. Azok a sablonok, amelyek soha nem olvassák a sizes értékét, elhagyhatják vagy lerövidíthetik a listát.

PHP
add_filter('blockstudio/blocks/attributes/files/sizes', function($sizes, $id, $size) {
  // Keep only two sizes. Return an empty array to skip them, `sizes` is then null.
  return ['full', 'large'];
}, 10, 3);

A $sizes a méretnevek listája, elsőként a full elemmel (üres, ha nincs regisztrált köztes méret). A $id a csatolmányazonosító, a $size pedig az érték url mezőjéhez kért méret. A szűrő a kérésben szereplő összes fájlérték sizes tömbjét módosítja. Nélküle a tömb változatlan marad.

A méretneveket karakterláncokként adja vissza. Az érvénytelen bejegyzések figyelmen kívül maradnak, az ismétlődő nevek csak egyszer kerülnek feldolgozásra, a nem tömb típusú visszatérési érték pedig kihagyja a méreteket. A kért url és a többi melléklet-tulajdonság változatlan marad. Ez a hook nem fut le olyan files mezőnél, amelynek értéke returnFormat: "url", mivel az nem hoz létre mérettérképet.

attributes/validate

Az explicit bs_validate_block() hívások eredményeinek módosítása, például amikor egy egyéni renderelési szűrő feloldja a tárolt hivatkozásokat. Ez nem engedélyezi a mentéskor vagy rendereléskor végzett automatikus ellenőrzést.

PHP
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
  return $findings;
}, 10, 3);

A megállapítások listájának visszaadása. A szűrő nem fut le, ha a blokkban nincsenek Blockstudio mezők vagy egyező kiterjesztések (null).

attributes/schema

Módosítsa a JSON által visszaadott sémát itt: bs_block_schema(), például amikor egy egyéni renderelési szűrő feloldja a tárolt hivatkozásokat.

PHP
add_filter('blockstudio/blocks/attributes/schema', function($schema, $name) {
  return $schema;
}, 10, 2);

Adja vissza a sématömböt. A szűrő nem fut le, ha a blokknak nincs Blockstudio mezője vagy illeszkedő bővítménye (null).

attributes/populate

Ezzel a szűrővel egyéni adatokat adhat hozzá egy checkbox, select vagy radio mező beállításaihoz. További információért lásd a Beállítások feltöltése című részt.

A szűrő egyetlen argumentumot kap: az összes egyéni adatkészlet tömbjét, a "populate": {"type": "custom", "custom": "myCustomOptions"}-ban használt név szerint rendezve.

PHP
add_filter('blockstudio/blocks/attributes/populate', function($options) {
  $options['myCustomOptions'] = [
    ['value' => '1', 'label' => 'Option 1'],
    ['value' => '2', 'label' => 'Option 2'],
  ];
  return $options;
});

components/use_block_props/render

Ezzel a szűrővel módosíthatja a useBlockProps tartalmának kimenetét.

Az összes komponensszűrő (use_block_props, inner_blocks és rich_text) utolsó argumentumként kapja meg a blokkot. A $block a renderelt blokkhoz regisztrált WP_Block_Type, ezért a $block->name a blokk neve, például acme/hero.

A $props egy HTML attribútumokat tartalmazó karakterlánc, nem tömb. A frontend oldalon ez a get_block_wrapper_attributes() eredménye, például class="wp-block-acme-hero my-class". A szerkesztőben az elem class attribútuma. Karakterláncot adjon vissza. A szerkesztőben a visszaadott karakterlánc csak az class attribútumát alkalmazza.

PHP
add_filter('blockstudio/blocks/components/use_block_props/render', function($props, $block) {
  if ($block->name !== 'acme/hero') {
    return $props;
  }

  return str_replace('class="', 'class="my-custom-class ', $props);
}, 10, 2);

components/inner_blocks/render

Ezzel a szűrővel módosíthatja a <InnerBlocks /> tartalmának kimenetét.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/render', function($content, $block) {
  return '<div class="inner-wrapper">' . $content . '</div>';
}, 10, 2);

components/inner_blocks/frontend/wrap

Ezzel a szűrővel eltávolíthatja a <InnerBlocks /> körüli burkolóelemet a frontendről.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

components/rich_text/render

Ez a szűrő lehetővé teszi a <RichText /> tartalmának kimenetét. Megkapja az attribútum értékét és a blokkot.

PHP
add_filter('blockstudio/blocks/components/rich_text/render', function($content, $block) {
  return wp_kses_post($content);
}, 10, 2);

Blokktagek

blockstudio/block_tags/builders

Ez a szűrő regisztrálja a blokktagek és a blockstudio/parser/element_mapping által kiválasztott egyéni blokkok által használt blokktömb-építőket. Minden építő a feldolgozott attribútumokat és a nyers belső tartalmat kapja meg.

PHP
add_filter('blockstudio/block_tags/builders', function($builders, $parser) {
  $builders['theme/paragraph'] = function(array $attributes, string $inner) {
    $attributes['content'] = trim($inner);

    return [
      'blockName' => 'theme/paragraph',
      'attrs' => [
        'blockstudio' => [
          'attributes' => $attributes,
        ],
      ],
      'innerBlocks' => [],
      'innerHTML' => '',
      'innerContent' => [],
    ];
  };

  return $builders;
}, 10, 2);

A kompatibilis blockstudio/block_tags/renderers és blockstudio/parser/renderers szűrők ez után a hook után futnak le, és felülírhatják ugyanazt a blokknevet.

blockstudio/block_tags/tag_aliases

Ezzel a szűrővel egyéni, kötőjeles szerzői tageket regisztrálhat, amelyek a nyers HTML-es tartalékmegoldás előtt valódi blokknevekre oldódnak fel. Hasznos, ha egy téma tömör, projektspecifikus tagkészletet szeretne, miközben szabványos Blockstudio vagy alapblokkokat jelenít meg.

PHP
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
  $aliases['theme-button'] = 'bsui/button';
  $aliases['theme-card'] = 'theme/card';

  return $aliases;
});
HTML
<theme-button href="/download" label="Download" />
<theme-card title="Fast authoring">
  <p>Children are parsed as nested blocks.</p>
</theme-card>

blockstudio/block_tags/prefixes

Ezzel a szűrővel előtag-rövidítéseket rendelhet egy vagy több blokk-névtérhez. Minden kulcs kisbetűs előtag kötőjelek nélkül. Az érték lehet névtér karakterlánca vagy rendezett névtérlista.

PHP
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
HTML
<theme-card title="Homepage" />
<theme-button label="Get started" />
<theme-ui-feature-matrix />

A <theme-card> feloldása: theme-components/card. A <theme-button> először a theme-components/button értékét próbálja, majd visszaesik a bsui/button értékére. Az ugyanahhoz a taghez tartozó explicit blockstudio/block_tags/tag_aliases bejegyzések elsőbbséget élveznek, a fel nem oldott előtagos tagek pedig változatlanok maradnak.

Az előtagok kombinálhatók: ha egy előtagos tag nem oldható fel közvetlenül, és a slugja maga is regisztrált előtagtag, a feloldás rekurzívan folytatódik. A theme => ['theme-components'] és a ui => ['bsui'] használatakor a <theme-ui-input> továbbhalad a ui előtagra, és feloldja a bsui/input értékét. A regisztrált előtag- és aliastagek a blokksablon kimenetében is megjelennek, nem csak az oldal tartalmában.

Beállítások

útvonal

Ezzel a szűrővel módosítható a blockstudio.json fájl útvonala. Alapértelmezés szerint ez az aktuálisan aktív témán belüli blockstudio.json.

PHP
add_filter('blockstudio/settings/path', function() {
  return get_stylesheet_directory() . '/config/blockstudio.json';
});

users/ids

Ezzel a szűrővel engedélyezheti a szerkesztőt meghatározott felhasználói azonosítókhoz.

PHP
add_filter('blockstudio/settings/users/ids', function() {
  return [1];
});

users/roles

Ezzel a szűrővel engedélyezheti a szerkesztőt meghatározott felhasználói szerepkörökhöz.

PHP
add_filter('blockstudio/settings/users/roles', function() {
  return ['administrator', 'editor'];
});

assets/enqueue

Ezzel a szűrővel engedélyezheti vagy letilthatja az erőforrások betöltését a frontendben és a szerkesztőben.

PHP
add_filter('blockstudio/settings/assets/enqueue', function() {
  return false;
});

assets/reset/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja a WordPress alapblokkok stílusainak és a szerkesztő segédelrendezés-visszaállításának eltávolítását.

PHP
add_filter('blockstudio/settings/assets/reset/enabled', function() {
  return true;
});

assets/reset/full_width

Ezzel a szűrővel szabályozhatja, mely bejegyzéstípusok használják a teljes szélességű szerkesztést.

PHP
add_filter('blockstudio/settings/assets/reset/full_width', function() {
  return ['page'];
});

assets/minify/css

Ezzel a szűrővel engedélyezheti vagy letilthatja a CSS tömörítését.

PHP
add_filter('blockstudio/settings/assets/minify/css', function() {
  return true;
});

assets/minify/js

Ezzel a szűrővel engedélyezheti vagy letilthatja a JS tömörítését.

PHP
add_filter('blockstudio/settings/assets/minify/js', function() {
  return true;
});

assets/process/scss

Ezzel a szűrővel engedélyezheti vagy letilthatja a SCSS feldolgozását .css fájlokban.

PHP
add_filter('blockstudio/settings/assets/process/scss', function() {
  return true;
});

assets/process/scss_files

Ezzel a szűrővel engedélyezheti vagy letilthatja a .scss fájlok CSS-szá alakítását.

PHP
add_filter('blockstudio/settings/assets/process/scss_files', function() {
  return true;
});

assets/output

Ezzel a szűrővel szabályozhatja, hová kerüljenek a lefordított blokk-erőforrások.

PHP
add_filter('blockstudio/settings/assets/output', function() {
  return 'cache';
});

assets/inline_limit

Megszűri, hogy oldalanként hány bájtnyi külső blokk-CSS kerüljön beágyazásra.

PHP
add_filter('blockstudio/settings/assets/inline_limit', function() {
  return 40000;
});

cache/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja az összes Blockstudio fájlalapú futásidejű és szerkesztői erőforrás-gyorsítótárat.

PHP
add_filter('blockstudio/settings/cache/enabled', function() {
  return false;
});

cache/path

Ezzel a szűrővel módosíthatja a Blockstudio fájlalapú gyorsítótár könyvtárát.

PHP
add_filter('blockstudio/settings/cache/path', function() {
  return 'cache/blockstudio';
});

cache/namespace_grace

Ezzel a szűrővel módosíthatja, mennyi ideig marad meg egy már nem használt gyorsítótár-névtér a törlés előtt.

PHP
add_filter('blockstudio/settings/cache/namespace_grace', function() {
  return 777600;
});

githooks/commit

Ez a szűrő jelzi, hogy engedélyezve van-e a Blockstudio által kezelt PHPStan commit hook.

PHP
add_filter('blockstudio/settings/githooks/commit', function() {
  return true;
});

content/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja a Content Sync funkciót.

PHP
add_filter('blockstudio/settings/content/enabled', function() {
  return true;
});

content/id

Ezzel a szűrővel állíthatja be a Content Sync tulajdonosi névterét.

PHP
add_filter('blockstudio/settings/content/id', function() {
  return 'docs';
});

content/path

Ezzel a szűrővel állíthatja be a Content Sync fájlok könyvtárát.

PHP
add_filter('blockstudio/settings/content/path', function() {
  return 'content';
});

content/include_page_sync_managed

Ezzel a szűrővel felveheti vagy kizárhatja a Page Sync által kezelt bejegyzéseket.

PHP
add_filter('blockstudio/settings/content/include_page_sync_managed', function() {
  return false;
});

content/authors

Ezzel a szűrővel állíthatja be a Content Sync szerzőkezelését.

PHP
add_filter('blockstudio/settings/content/authors', function() {
  return 'ignore';
});

content/post_types

Ezzel a szűrővel állíthatja be a Content Sync engedélyezett bejegyzéstípusainak listáját.

PHP
add_filter('blockstudio/settings/content/post_types', function() {
  return ['team_member'];
});

content/taxonomies

Ezzel a szűrővel állíthatja be a Content Sync engedélyezett taxonómiáinak listáját.

PHP
add_filter('blockstudio/settings/content/taxonomies', function() {
  return ['category', 'post_tag'];
});

content/media

Ezzel a szűrővel állíthatja be a Content Sync médiakezelését.

PHP
add_filter('blockstudio/settings/content/media', function() {
  return 'manifest';
});

tailwind/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja a Tailwind funkciót.

PHP
add_filter('blockstudio/settings/tailwind/enabled', function() {
  return true;
});

tailwind/config

Ezzel a szűrővel egyéni Tailwind CSS konfigurációt adhat hozzá.

PHP
add_filter('blockstudio/settings/tailwind/config', function() {
  return '@theme { --color-primary: pink; }';
});

tailwind/output

Ezzel a szűrővel beállíthatja, hogy a Tailwind CSS kimenete beágyazva vagy hivatkozással jelenjen meg.

PHP
add_filter('blockstudio/settings/tailwind/output', function() {
  return 'link';
});

ui/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja a mellékelt UI-összetevőket.

PHP
add_filter('blockstudio/settings/ui/enabled', function() {
  return true;
});

editor/format_on_save

Ezzel a szűrővel engedélyezheti vagy letilthatja a kód formázását mentéskor.

PHP
add_filter('blockstudio/settings/editor/format_on_save', function() {
  return true;
});

editor/assets

Ezzel a szűrővel további erőforrásokat tölthet be a szerkesztőben.

PHP
add_filter('blockstudio/settings/editor/assets', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

editor/markup

Ezzel a szűrővel további jelölést adhat a szerkesztő végéhez.

PHP
add_filter('blockstudio/settings/editor/markup', function() {
  return '<style>body { background: black; }</style>';
});

block_editor/disable_loading

Ezzel a szűrővel letilthatja a blokkok betöltését a Blokkszerkesztőben.

PHP
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
  return true;
});

block_editor/enhance

Ezzel a szűrővel engedélyezheti a Blockstudio szerkesztői kezelőelemeit, például a letisztultabb fókuszstílusokat és a rámutatáskor vagy kijelöléskor megjelenő körvonalakat.

PHP
add_filter('blockstudio/settings/block_editor/enhance', function() {
  return true;
});

block_editor/css_classes

Ezzel a szűrővel olyan stíluslapokat adhat hozzá, amelyek osztályai kiválaszthatók lesznek az osztály mezőben.

PHP
add_filter('blockstudio/settings/block_editor/css_classes', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

block_editor/css_variables

Ezzel a szűrővel olyan stíluslapokat adhat hozzá, amelyek CSS változói automatikusan kiegészíthetők lesznek a kódmezőben.

PHP
add_filter('blockstudio/settings/block_editor/css_variables', function() {
  return ['my-stylesheet', 'another-stylesheet'];
});

block_editor/blocks/allow

Ezzel a szűrővel szabályozhatja, mely blokknevek engedélyezettek a beszúróban.

PHP
add_filter('blockstudio/settings/block_editor/blocks/allow', function() {
  return ['core/*', 'acf/*', 'my-theme/*'];
});

block_editor/blocks/deny

Ezzel a szűrővel eltávolíthat blokkneveket a beszúróból.

PHP
add_filter('blockstudio/settings/block_editor/blocks/deny', function() {
  return ['core/embed', 'core/freeform'];
});

block_editor/blocks/directory

Ezzel a szűrővel engedélyezheti vagy letilthatja a WordPress blokk-katalógusának erőforrásait a szerkesztőben.

PHP
add_filter('blockstudio/settings/block_editor/blocks/directory', function() {
  return false;
});

block_editor/blocks/categories/allow

Ezzel a szűrővel szabályozhatja, mely blokkkategória-slugok maradjanak elérhetők.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/allow', function() {
  return ['text', 'media', 'design'];
});

block_editor/blocks/categories/deny

Ezzel a szűrővel eltávolíthat blokkkategória-slugokat a beszúróból.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/deny', function() {
  return ['embed'];
});

block_editor/blocks/categories/rename

Ezzel a szűrővel slug alapján átnevezheti a blokkkategóriák címkéit.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/rename', function() {
  return [
    'text' => 'Writing',
    'design' => 'Layout'
  ];
});

block_editor/blocks/categories/order

Ezzel a szűrővel rendezheti a blokkkategória-slugokat a beszúróban.

PHP
add_filter('blockstudio/settings/block_editor/blocks/categories/order', function() {
  return ['my-theme', 'text', 'media'];
});

block_editor/blocks/styles/deny

Ezzel a szűrővel blokknevenként eltávolíthatja a PHP által regisztrált blokkstílusokat.

PHP
add_filter('blockstudio/settings/block_editor/blocks/styles/deny', function() {
  return [
    'my-theme/card' => ['outline'],
    'my-theme/media' => ['framed']
  ];
});

block_editor/blocks/legacy_widgets/hide

Ezzel a szűrővel további régi widgeteket rejthet el a régi widget blokkban.

PHP
add_filter('blockstudio/settings/block_editor/blocks/legacy_widgets/hide', function() {
  return ['archives', 'calendar'];
});

block_editor/patterns/core

Ezzel a szűrővel engedélyezheti vagy letilthatja a WordPress alapértelmezett blokkmintáit.

PHP
add_filter('blockstudio/settings/block_editor/patterns/core', function() {
  return false;
});

block_editor/patterns/remote

Ezzel a szűrővel engedélyezheti vagy letilthatja a távoli mintákat a WordPress mintakatalógusából.

PHP
add_filter('blockstudio/settings/block_editor/patterns/remote', function() {
  return false;
});

block_editor/patterns/theme

Ezzel a szűrővel engedélyezheti vagy letilthatja a témák által biztosított blokkmintákat.

PHP
add_filter('blockstudio/settings/block_editor/patterns/theme', function() {
  return false;
});

block_editor/patterns/blockstudio

Ezzel a szűrővel engedélyezheti vagy letilthatja a Blockstudio fájlalapú mintákat.

PHP
add_filter('blockstudio/settings/block_editor/patterns/blockstudio', function() {
  return false;
});

block_editor/patterns/categories/allow

Ezzel a szűrővel szabályozhatja, mely mintakategória-slugok maradjanak elérhetők.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/allow', function() {
  return ['featured', 'buttons', 'columns'];
});

block_editor/patterns/categories/deny

Ezzel a szűrővel eltávolíthat mintakategória-slugokat a mintabeszúróból.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/deny', function() {
  return ['gallery'];
});

block_editor/patterns/categories/rename

Ezzel a szűrővel slug alapján átnevezheti a mintakategóriák címkéit.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/rename', function() {
  return [
    'featured' => 'Featured Layouts'
  ];
});

block_editor/patterns/categories/order

Ezzel a szűrővel rendezheti a mintakategória-slugokat a beszúróban.

PHP
add_filter('blockstudio/settings/block_editor/patterns/categories/order', function() {
  return ['featured', 'buttons'];
});

block_editor/media/openverse

Ezzel a szűrővel engedélyezheti vagy letilthatja a Openverse médiakategóriát a blokkszerkesztő médiabeszúrójában.

PHP
add_filter('blockstudio/settings/block_editor/media/openverse', function() {
  return false;
});

block_editor/media/image_sizes/allow

Ezzel a szűrővel szabályozhatja, mely kép-méretnevek maradjanak elérhetők a szerkesztő médiavezérlőiben.

PHP
add_filter('blockstudio/settings/block_editor/media/image_sizes/allow', function() {
  return ['thumbnail', 'large'];
});

block_editor/media/image_sizes/deny

Ezzel a szűrővel eltávolíthat kép-méretneveket a szerkesztő médiavezérlőiből.

PHP
add_filter('blockstudio/settings/block_editor/media/image_sizes/deny', function() {
  return ['medium_large'];
});

ai/enable_context_generation

Ezzel a szűrővel engedélyezheti vagy letilthatja az LLM-eszközök integrációjához szükséges kontextusfájl létrehozását. Engedélyezés esetén a fájl egyetlen forrásba gyűjti az aktuális telepítés naprakész blokkadatait, Blockstudio beállításait, az összes releváns sémát és a Blockstudio dokumentációt, hogy AI-fejlesztőeszközökkel használható legyen.

PHP
add_filter('blockstudio/settings/ai/enable_context_generation', function() {
  return true;
});

block_tags/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja az oldalszintű blokktag-megjelenítést.

PHP
add_filter('blockstudio/settings/block_tags/enabled', function() {
  return true;
});

block_tags/prefixes

Ezzel a szűrővel előtag- és névtér-rövidítéseket regisztrálhat a blokktagekhez.

PHP
add_filter('blockstudio/settings/block_tags/prefixes', function() {
  return [
    'theme' => ['theme-components', 'bsui']
  ];
});

dev/grab/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja az elemek megfogóját.

PHP
add_filter('blockstudio/settings/dev/grab/enabled', function() {
  return false;
});

dev/perf

Ezzel a szűrővel engedélyezheti vagy letilthatja a teljesítményprofilozót.

PHP
add_filter('blockstudio/settings/dev/perf', function() {
  return false;
});

dev/canvas/enabled

Ezzel a szűrővel engedélyezheti vagy letilthatja a vásznat.

PHP
add_filter('blockstudio/settings/dev/canvas/enabled', function() {
  return false;
});

dev/canvas/admin_bar

Ezzel a szűrővel megjelenítheti vagy elrejtheti a vásznon a WordPress adminisztrációs sávot.

PHP
add_filter('blockstudio/settings/dev/canvas/admin_bar', function() {
  return true;
});

WPML

blockstudio/wpml/config/label

Megszűri az egyes kulcsok címkéjét, amelyeket a wp bs wpml config ír ki. A környezeti tömbhöz lásd: Címkék módosítása.

PHP
add_filter('blockstudio/wpml/config/label', function($label, $context) {
  return str_replace(' (optional)', '', $label);
}, 10, 2);

Vászon

blockstudio/canvas/inventory

Ez a szűrő módosítja a Canvas által a kijelöléshez jelentett leltárt. A visszahívás a leltár DTO-t, az eredeti kijelölést és a meghívásakor kapott beállításokat kapja meg.

PHP
add_filter('blockstudio/canvas/inventory', function(array $result, array $selection, array $options) {
  return $result;
}, 10, 3);

blockstudio/canvas/documents

Ez a szűrő módosítja a Canvas által visszaadott megjelenített dokumentumokat; ugyanazt a három argumentumot kapja, mint a leltárszűrő.

blockstudio/canvas/item_loaded

Ez a művelet minden leltárrekord betöltésekor egyszer lefut; megkapja a leltár típusát, a kanonikus rekordazonosítót és a normalizált rekordot.

blockstudio/canvas/source_compiled

Ez a művelet azután fut le, hogy egy forrásfájl lefordult a Canvas számára; megkapja a kiválasztott forrás elérési útját és a kanonikus forrásrekordot.

Csomagban lévő UI

blockstudio/ui/directories

Ez a szűrő módosítja azokat a könyvtárakat, amelyekben a rendszer a csomagban lévő UI-összetevőket keresi.

blockstudio/ui/inventory

Ez a szűrő módosítja a nyilvános UI-család leltárát.

blockstudio/ui/examples

Ez a szűrő módosítja a UI példarekordjait; megkapja a példákat és a nyilvános UI leltárt, amelyből származnak.

Topológia

blockstudio/blocks/topology_refreshed

Ez a művelet a blokk-topológia újraépítése után fut le.

blockstudio/pages/topology_refreshed

Ez a művelet az oldal-topológia újraépítése után fut le.

blockstudio/pages/layout_error

Ez a művelet akkor fut le, ha egy oldalelrendezés nem jeleníthető meg, így a hiba nem marad csendben.

Futásidő

blockstudio/runtime/initialized

Ez a művelet akkor fut le, amikor a futtatókörnyezet feloldotta a konfigurációját.

blockstudio/runtime/changed

Ez a művelet akkor fut le, ha megváltozik a feloldott futtatókörnyezeti azonosító, ami áthelyezi a gyorsítótár-névtereket és a statikus előrenderelési állapotot.

blockstudio/performance/default_config

Ez a szűrő módosítja a teljesítmény alapértékeit, mielőtt a projekt saját blockstudio.json értékei rájuk épülnének.

Tartalom

blockstudio/content/orphan_action

Ez a szűrő határozza meg, mit tegyen a tartalomszinkronizálás egy olyan rekorddal, amelynek már nincs forrása.

Bootstrap

blockstudio/url

Ez a szűrő módosítja a URL nyilvános értékét, amelyet a Blockstudio szerkesztői és adminisztrációs erőforrásai használnak. A Composer integrációknak a Blockstudio automatikus betöltési fájljának betöltése előtt kell regisztrálniuk ezt. A második argumentum a csomag fizikai könyvtára.

PHP
add_filter(
  'blockstudio/url',
  function(string $url, string $directory) {
    return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
  },
  10,
  2
);

Futásidejű gyorsítótár

blockstudio/cache/dir

Ez a szűrő a feloldott gyorsítótár alapkönyvtárát kapja meg, mielőtt hozzáfűződik egy futásidejű, szerkesztői erőforrás- vagy más gyorsítótár hatóköre.

PHP
add_filter('blockstudio/cache/dir', function(string $directory) {
  return WP_CONTENT_DIR . '/cache/blockstudio';
});

blockstudio/cache/context

Ez a szűrő szerializálható futásidejű változatot ad a gyorsítótár-azonosítókhoz. Akkor használja, ha ugyanaz a felderítési forrás különböző logikai leltárakat választhat ki.

PHP
add_filter('blockstudio/cache/context', function($context, string $scope) {
  return [
    'preview' => get_query_var('preview_id'),
    'site' => get_current_blog_id(),
  ];
}, 10, 2);

blockstudio/cache/site_key

Ez a szűrő módosítja a hálózat/blog könyvtárazonosítóját azoknál a hosztoknál, amelyek saját bérlői határral rendelkeznek. A visszaadott érték használat előtt tisztításra kerül.

PHP
add_filter(
  'blockstudio/cache/site_key',
  function(string $key, int $networkId, int $blogId) {
    return sprintf('tenant-%d-%d', $networkId, $blogId);
  },
  10,
  3
);

blockstudio/runtime/identity

Ez a szűrő olyan hosztadatokat ad hozzá, amelyek egy futásidejű hatókör minden objektumára hatással vannak. Az elemekre jellemző forrás-ujjlenyomatokat inkább az azokat kezelő API adja át explicit függőségként.

PHP
add_filter(
  'blockstudio/runtime/identity',
  function(array $identity, string $scope) {
    $identity['deployment'] = getenv('RELEASE_SHA') ?: 'local';
    return $identity;
  },
  10,
  2
);

blockstudio/cache/watch_debounce

Azt az időtartamot szűri másodpercben, ameddig egy érvényesített fájlfigyelő-pillanatkép újabb fájlrendszer-állapotfelmérés nélkül újra felhasználható. Az alapérték 0 helyi és fejlesztői környezetben, máshol pedig 20.

PHP
add_filter('blockstudio/cache/watch_debounce', function() {
  return 30;
});

blockstudio/cache/build_wait_budget

Azt az időtartamot szűri ezredmásodpercben, ameddig egy kérés vár egy párhuzamos építőre, hogy közzétegye a futásidejű gyorsítótárat vagy a feltöltött választék frissítését, mielőtt visszafogottabb működésre vált. Az alapérték strukturális újraépítésnél 5000, a választék frissítésénél pedig 4000.

PHP
add_filter('blockstudio/cache/build_wait_budget', function() {
  return 2000;
});

blockstudio/cache/populate_debounce

Azt szűri, hány másodpercnyi tartalom-, kifejezés-, felhasználó- vagy metaadat-írás olvad össze egyetlen feltöltöttválaszték-frissítéssé. Csendes időszak után az első írás azonnal frissít; a sorozat utolsó írása pedig az időablak lejárta után jelenik meg. Az alapérték 30. A 0 visszaadásával minden íráskor frissíthet.

PHP
add_filter('blockstudio/cache/populate_debounce', function() {
  return 120;
});

blockstudio/cache/populate_ignored_meta_keys

Megszűri azokat a metaadatkulcsokat, amelyek írása soha nem frissíti a feltöltött választási lehetőségeket. Alapértelmezés szerint ezek azok a kulcsok, amelyeket a WordPress szerkesztési és bejelentkezési nyilvántartásként ír: _edit_lock, amelyet a szerkesztő és a Heartbeat frissít, amíg egy bejegyzés nyitva van; _edit_last, amelyet egy olyan bejegyzés mentésekor ír ki, amely egyébként is frissítést végez; valamint session_tokens, amelyet be- és kijelentkezéskor ír ki. Adja hozzá azokat a gyakran változó kulcsokat, amelyek soha nem befolyásolják a feltöltési lekérdezést.

PHP
add_filter('blockstudio/cache/populate_ignored_meta_keys', function(array $keys) {
  $keys[] = '_my_view_counter';
  return $keys;
});

blockstudio/cache/max_files_per_scope

Azt szűri, hogy az egyes futásidejű gyorsítótár-hatókörök hány közzétett tartalmat őrizzenek meg.

PHP
add_filter('blockstudio/cache/max_files_per_scope', function($maximum, $scope) {
  return $scope === 'runtime' ? 50 : $maximum;
}, 10, 2);

blockstudio/cache/compress

Megszűri, hogy a gyorsítótár-adatcsomag tömörített szerializált adatot használjon-e egyszerű PHP tömb helyett. Alapértelmezés szerint csak az 1 MiB-ig terjedő adatcsomagok használják az egyszerű formátumot, és csak akkor, ha az aktív OPcache megosztott memóriája képes gyorsítótárazni a célhelyet. Más folyamatok, kizárt fájlok és nagyobb adatcsomagok tömörítést használnak.

PHP
add_filter('blockstudio/cache/compress', function($compress, $scope) {
  return $scope === 'runtime' ? false : $compress;
}, 10, 2);

A false visszaadása a méretkorlátot is felülírja. Ez akkor lehet hasznos, ha a opcache.enable_cli nélküli WP-CLI OPcache-kompatibilis webes munkafolyamatokhoz előmelegíti a fájlokat, de minden OPcache nélküli olvasó feldolgozza a létrehozott tömböt. A nagy, megosztott adatcsomagoknál maradjon a tömörítés, kivéve, ha elfogadható ez a többlet-memóriahasználat. Az alapértelmezett védelmekért lásd a gyorsítótár-adatcsomagok formátumait.

blockstudio/cache/protected_paths

A gyorsítótár-útvonalakat a megőrzési ritkítás soha nem törölheti. A Blockstudio feltölti ezt a listát az összes fájllal, amelyre a telepített korai kiszolgálási leképezés hivatkozik.

PHP
add_filter('blockstudio/cache/protected_paths', function(array $paths, string $scope, string $directory) {
  if ('static-prerender' === $scope) {
    $paths[] = $directory . '/pinned.html';
  }
  return $paths;
}, 10, 3);

blockstudio/cache/outcome

Ez a művelet egy megosztott gyorsítótár-hatókört és egy eredményt jelent, például: hit, build, miss-stale, stale-last-good vagy write-failure.

PHP
add_action('blockstudio/cache/outcome', function(string $scope, string $reason) {
  my_metrics()->increment("blockstudio.cache.{$scope}.{$reason}");
}, 10, 2);

blockstudio/static_prerender/request_bypass

Ez a szűrő megkapja a végső, névtelenséget védő döntést, valamint a szerver- és cookie-adatokat. A true visszaadása mindig megkerüli a statikus kiszolgálást és létrehozást.

PHP
add_filter(
  'blockstudio/static_prerender/request_bypass',
  function(bool $bypass, array $server, array $cookies) {
    return $bypass || isset($cookies['commerce_session']);
  },
  10,
  3
);

blockstudio/static_prerender/public_urls

Ez a szűrő biztosítja vagy módosítja a teljes nyilvános URL leltárt, amelyet az ütemezett előmelegítő és az explicit gráfeszközök használnak.

PHP
add_filter('blockstudio/static_prerender/public_urls', function(array $urls) {
  $urls[] = home_url('/custom-route/');
  return array_values(array_unique($urls));
});

A szűrő által visszaadott érték nem a végleges leltár. Az eredmény átmegy egy gyorsítótárazhatósági ellenőrzésen, amely eltávolít minden konfigurált dinamikus útvonalra illeszkedő elemet, valamint minden alapértelmezés szerint megkerült elemet: /wp-admin, /wp-json, /wp-login.php, /xmlrpc.php, a /feed/ értéket tartalmazó útvonalakat, továbbá az oldal kezdőlapjának keresési alapútvonala alatti keresési találatokat (alapértelmezés szerint /search/). Ezért előfordulhat, hogy egy hozzáadott URL figyelmeztetés nélkül kimarad. Ha egy várt útvonal hiányzik a felépített leltárból, ellenőrizze ezek alapján a szabályok alapján, mielőtt azt feltételezné, hogy a szűrő nem futott le.

blockstudio/static_prerender/render_internal

Ez a szűrő valósítja meg az opcionális, folyamaton belüli kötegelt átvitelt. Adjon vissza normalizált eredménytömböt, vagy hagyja változatlanul az értéket, hogy a renderelő a beállított HTTP tartalékmegoldást használja. Az eredmény tartalmazza a html értéket, valamint opcionálisan a status, dependencies, virtualHashes és headers értéket; a performance.staticPrerender.replayHeaders alatt megnevezett fejlécek a dokumentummal együtt tárolódnak.

PHP
add_filter(
  'blockstudio/static_prerender/render_internal',
  function($result, string $url, array $options) {
    return my_static_renderer()->render($url, $options);
  },
  10,
  3
);

blockstudio/static_prerender/cacheable_html

Ez a szűrő hozza meg a végső döntést, miután a Blockstudio ellenőrizte, hogy a kimenet teljes HTML dokumentum-e a no-cache jelölő nélkül, és hogy a megfigyelt válaszállapot sikeres-e. A harmadik argumentum a megfigyelt állapot, vagy null, ha nincs megadva állapot.

PHP
add_filter('blockstudio/static_prerender/cacheable_html', function(bool $cacheable, string $html, ?int $status) {
  return $cacheable && !str_contains($html, 'data-personalized');
}, 10, 3);

blockstudio/static_prerender/outcome

Ez a művelet a statikus előrenderelés eredményeit jelenti, többek között a találatokat, a hiányokat, az írásokat, a gráfírásokat, az elavult bejegyzéseket és a hibákat.

PHP
add_action('blockstudio/static_prerender/outcome', function(string $reason) {
  my_metrics()->increment("blockstudio.prerender.{$reason}");
});

blockstudio/tailwind/cache_max_files

A lefordított Tailwind CSS bejegyzések maximális számát szűri. Az alapérték 1000.

PHP
add_filter('blockstudio/tailwind/cache_max_files', function() {
  return 1500;
});

blockstudio/tailwind/cache_max_age

A lefordított Tailwind CSS bejegyzések maximális korát szűri másodpercben. Az alapérték 30 nap, a minimum pedig egy óra.

PHP
add_filter('blockstudio/tailwind/cache_max_age', function() {
  return 14 * DAY_IN_SECONDS;
});

Adminisztráció

engedélyezve

Ezzel a szűrővel engedélyezheti vagy letilthatja a Blockstudio adminisztrációs oldalt az Eszközök > Blockstudio alatt.

PHP
add_filter('blockstudio/admin/enabled', function() {
  return false;
});

Erőforrások

editor/canvas/body_class

Ha az erőforrások visszaállítása engedélyezett, ez a szűrő módosítja azokat a megtisztított frontend-törzsosztályokat, amelyek átkerülnek a blokkszerkesztő vásznára.

PHP
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
  return array_values(array_diff($classes, ['logged-in']));
});

engedélyezés

Ezzel a szűrővel letilthatja egy adott erőforrástípus feldolgozását és betöltését.

PHP
add_filter('blockstudio/assets/enable', function($enable, $type, $block) {
  if ($type === 'css' && $block['name'] === 'my/block') {
    return false;
  }
  return $enable;
}, 10, 3);

letiltás

Ezzel a szűrővel azonosítójuk alapján letilthat bizonyos erőforrásokat. A visszaadott tömbben szereplő azonosítójú erőforrások nem jelennek meg a frontendben.

PHP
add_filter('blockstudio/assets/disable', function($disabled) {
  $disabled[] = 'my-block-style';
  return $disabled;
});

process/scss/import_paths

Ezzel a szűrővel további útvonalakat adhat meg a SCSS fordító @import utasításához.

PHP
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
  $paths[] = get_stylesheet_directory() . '/scss';
  return $paths;
});

process/scss/prelude

Ezzel a szűrővel minden SCSS fájl fordítása előtt közös Sass kódot illeszthet be.

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

process/css/content

Ezzel a szűrővel módosíthatja a CSS fájl tartalmát a fordítás előtt.

PHP
add_filter('blockstudio/assets/process/css/content', function($content, $block) {
  return str_replace('old-class', 'new-class', $content);
}, 10, 2);

process/js/content

Ezzel a szűrővel módosíthatja a JS fájl tartalmát a fordítás előtt.

PHP
add_filter('blockstudio/assets/process/js/content', function($content, $block) {
  return $content;
}, 10, 2);

Pufferelés

engedélyezve

A Blockstudio puffereli a frontend válaszát, így a törzsben megjelenített blokkstílus- és szkript tagek áthelyezhetők a fejlécbe és a láblécbe, a Tailwind pedig a teljes dokumentumot vizsgálhatja. A pufferelés azt jelenti, hogy minden frontendkérésnél a teljes dokumentumot tárolni és vizsgálni kell; az a webhely, amely nem jelenít meg Blockstudio blokkerőforrásokat, és nem használja a Tailwind értéket, visszaadhatja a false értéket mindkettő kihagyásához.

PHP
add_filter('blockstudio/buffer/enabled', '__return_false');

A pufferelés az adminfelületen és a Testreszabó előnézetében is ki van kapcsolva. Hívja meg a bs_is_buffering() függvényt a wp_enqueue_scripts vagy későbbi ponton annak megállapításához, hogy az aktuális válasz pufferelve van-e. A template_redirect pontban meghozott döntés előtt false értéket ad vissza.

kimenet

Ez a szűrő a teljes pufferelt HTML dokumentumot kapja meg küldés előtt. A Blockstudio saját erőforrás-áthelyezése 1000000 prioritással, a Tailwind fordítása pedig 999999 prioritással fut; fusson korábban, ha az ezek előtti dokumentumot szeretné látni, vagy később, ha a végleges kimenetet.

PHP
add_filter('blockstudio/buffer/output', function(string $html) {
  return $html;
}, 2000000);

Megjelenítés

függőségek

Ez a szűrő jelentést ad a kiválasztott sablonról és erőforrás-függőségekről, amikor a Blockstudio blokkot jelenít meg. Hasznos statikus exportálók és más, folyamaton belüli függőség-gyűjtők számára.

PHP
add_filter(
  'blockstudio/render/dependencies',
  function($paths, $name, $block, $isEditor, $isPreview) {
    my_dependency_graph()->add($name, $paths);
    return $paths;
  },
  10,
  5
);

globális

Ezzel a szűrővel módosíthatja az oldal kimenetét a megjelenítés előtt.

PHP
add_filter('blockstudio/render', function($content) {
  return $content;
});

Ez a szűrő lehetővé teszi a <head> címke kimenetének módosítását a renderelés előtt. Csak akkor fut le, ha a Blockstudio puffereli a választ; lásd: bs_is_buffering().

PHP
add_filter('blockstudio/render/head', function($content) {
  return $content . '<meta name="custom" content="value">';
});

Ezzel a szűrővel módosíthatja a </body> kimenetét a megjelenítés előtt.

PHP
add_filter('blockstudio/render/footer', function($content) {
  return $content . '<script>console.log("loaded")</script>';
});

Hibakezelés

error/logged

A művelet a hiba naplózása után fut le. Ezzel továbbíthatja a hibákat külső naplózási szolgáltatásoknak.

PHP
add_action('blockstudio/error/logged', function($message, $level, $context) {
  if ($level === 'error') {
    my_external_logger($message, $context);
  }
}, 10, 3);

error/exception

A művelet a kivétel kezelése után fut le.

PHP
add_action('blockstudio/error/exception', function($exception, $context) {
  my_error_tracker($exception);
}, 10, 2);

Adatbázis

Minden adatbázis-hook egyetlen $params tömböt kap.

db/before_create

A művelet egy rekord létrehozása előtt fut le.

PHP
add_action('blockstudio/db/before_create', function($params) {
  // $params: block, schema, data, storage
});

db/after_create

A művelet egy rekord létrehozása után fut le.

PHP
add_action('blockstudio/db/after_create', function($params) {
  // $params: block, schema, record, storage
  wp_mail($params['record']['email'], 'Welcome!', 'Thanks for subscribing.');
});

db/before_update

A művelet egy rekord frissítése előtt fut le.

PHP
add_action('blockstudio/db/before_update', function($params) {
  // $params: block, schema, id, data, storage
});

db/after_update

A művelet egy rekord frissítése után fut le.

PHP
add_action('blockstudio/db/after_update', function($params) {
  // $params: block, schema, id, record, storage
});

db/before_delete

A művelet egy rekord törlése előtt fut le.

PHP
add_action('blockstudio/db/before_delete', function($params) {
  // $params: block, schema, id, storage
});

db/after_delete

A művelet egy rekord törlése után fut le.

PHP
add_action('blockstudio/db/after_delete', function($params) {
  // $params: block, schema, id, storage
});

RPC

Minden RPC hook egyetlen $params tömböt kap.

rpc/before_call

A művelet egy RPC függvény meghívása előtt fut le.

PHP
add_action('blockstudio/rpc/before_call', function($params) {
  // $params: block, function, params
});

rpc/after_call

A művelet egy RPC függvény meghívása után fut le.

PHP
add_action('blockstudio/rpc/after_call', function($params) {
  // $params: block, function, params, result
});