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.
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.
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.
$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.
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.
$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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
$aliases['theme-button'] = 'bsui/button';
$aliases['theme-card'] = 'theme/card';
return $aliases;
});
<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.
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
<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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
add_filter('blockstudio/settings/content/media', function() {
return 'manifest';
});
tailwind/enabled
Ezzel a szűrővel engedélyezheti vagy letilthatja a Tailwind funkciót.
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á.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
add_filter('blockstudio/settings/dev/perf', function() {
return false;
});
dev/canvas/enabled
Ezzel a szűrővel engedélyezheti vagy letilthatja a vásznat.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
add_filter('blockstudio/render', function($content) {
return $content;
});
fejléc
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().
add_filter('blockstudio/render/head', function($content) {
return $content . '<meta name="custom" content="value">';
});
lábléc
Ezzel a szűrővel módosíthatja a </body> kimenetét a megjelenítés előtt.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
add_action('blockstudio/rpc/after_call', function($params) {
// $params: block, function, params, result
});