# Hooks - PHP
Below you'll find a list of all available PHP hooks that can be used to extend or adjust the functionality of the plugin.
## Path
This filter allows you to adjust the path of the block folder. By default, this is `blockstudio` inside the currently active theme. Alternatively it is possible to [create a new instance](https://fabrikat.local/blockstudio/documentation/registration/#instances) for multiple source directories.
```php
add_action('blockstudio/path', function() {
$path = get_stylesheet_directory() . '/blocks';
return $path;
});
```
## Init
### global
This action fires after the plugin has registered all blocks.
```php
add_action('blockstudio/init', function() {
// do something
});
```
### instance
This action fires after the plugin has registered all blocks of a specific instance.
```php
add_action('blockstudio/init/$instance', function() {
// do something
});
```
### global/before
This action fires before the plugin has registered all blocks.
```php
add_action('blockstudio/init/before', function() {
// do something
});
```
### global/before/instance
This action fires before the plugin has registered all blocks of a specific instance.
```php
add_action('blockstudio/init/$instance', function() {
// do something
});
```
## Blocks
### render
This filter allows you to adjust the output of a block before it is rendered.
```php
add_filter('blockstudio/blocks/render', function ($value, $block, $isEditor, $isPreview) {
if ($block->name === 'blockstudio/my-block') {
$value = str_replace('%CONTENT%', 'Replace in frontend', $value);
if ($isEditor) {
$value = str_replace('%CONTENT%', 'Only replace in editor', $value);
}
if ($isPreview) {
$value = str_replace('%CONTENT%', 'Only replace in preview', $value);
}
}
return $value;
}, 10, 4);
```
### meta
This filter allows you to adjust the data of the block.json file before it is registered.
```php
add_filter('blockstudio/blocks/meta', function ($block) {
if (strpos($block->name, 'marketing') === 0) {
$block->blockstudio['icon'] = '';
}
return $block;
});
```
The above code would change the icon of all blocks starting with **marketing**.
### conditions
This filter allows you to add custom conditions which can be used within blocks.
```php
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = userHasPurchasedProduct();
return $conditions;
});
```
### attributes
This filter allows you to adjust the attributes of a block before the block is registered. See [Filtering](https://fabrikat.local/blockstudio/documentation/attributes/filtering/) for more information.
```php
add_filter('blockstudio/blocks/attributes', function ($attribute, $block) {
if (isset($attribute['id']) && $attribute['id'] === 'lineNumbers') {
$attribute['default'] = true;
$attribute['conditions'] = [
[
[
'id' => 'language',
'operator' => '==',
'value' => 'css',
]
]
];
}
return $attribute;
}, 10, 2);
```
### attributes/render
This filter allows you to adjust the attributes of a block before it is rendered. See [Filtering](https://fabrikat.local/blockstudio/documentation/attributes/filtering/) for more information.
```php
add_filter('blockstudio/blocks/attributes/render', function ($value, $key, $block) {
if (
$key === 'copyButton' &&
$block['name'] === 'blockstudio-element/code'
) {
$value = true;
}
return $value;
}, 10, 3);
```
### attributes/populate
This filter allows you to add custom data to the options of a `checkbox`, `select` or `radio` field. See [Populating options](https://fabrikat.local/blockstudio/documentation/attributes/populating-options/) for more information.
```php
add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['customData'] = [
[
'value' => 'custom-1',
'label' => 'Custom 1',
],
[
'value' => 'custom-2',
'label' => 'Custom 2',
],
[
'value' => 'custom-3',
'label' => 'Custom 3',
],
];
return $options;
});
```
### components/useblockprops/render
This filter allows you to adjust the output of the `useBlockProps` content.
```php
add_filter('blockstudio/blocks/components/useblockprops/render', function ($attributes, $block) {
if ($block->name === 'blockstudio/title') {
$attributes['class'] = $attributes['class'] . ' new-class';
}
return $attributes;
}, 10, 2);
```
### components/innerblocks/render
This filter allows you to adjust the output of the `` content.
```php
add_filter('blockstudio/blocks/components/innerblocks/render', function ($value, $block) {
if ($block->name === 'blockstudio/columns') {
$value = str_replace('%CONTENT%', 'replace', $value);
}
return $value;
}, 10, 2);
```
### components/innerblocks/frontend/wrap
This filter allows you to remove the `` wrapper from the frontend.
```php
add_filter('blockstudio/blocks/components/innerblocks/frontend/wrap', function ($render, $block) {
if ($block->name === 'blockstudio/my-block') {
$render = false;
}
return $render;
}, 10, 2);
```
### components/richtext/render
This filter allows you to adjust the output of the `` content.
```php
add_filter('blockstudio/blocks/components/richtext/render', function ($value, $block) {
if ($block->name === 'blockstudio/title') {
$value = str_replace('%CONTENT%', 'replace', $value);
}
return $value;
}, 10, 2);
```
## Settings
### path
This filter allows you to adjust the path of the `blockstudio.json` file. By default, this is `blockstudio.json` inside the currently active theme.
```php
add_filter('blockstudio/settings/path', function() {
$path = get_stylesheet_directory() . '/settings';
return $path;
});
```
## Assets
### enable
This filter allows you to disable the asset processing and enqueueing of a specific asset type.
```php
add_filter("blockstudio/assets/enable", function ($value, $data) {
if ($data['type'] === 'css') {
return false;
}
return true;
}, 10, 2);
```
### process/scss/importPaths
This filter allows you to add additional paths to the `@import` statement of the SCSS compiler.
```php
add_filter('blockstudio/assets/process/scss/importPaths', function() {
$paths[] = get_template_directory() . '/src/scss/';
return $paths;
});
```
### process/css/content
This filter allows you to adjust the content of the CSS file before it is being compiled.
```php
add_filter('blockstudio/assets/process/css/content', function($content) {
$content = str_replace('background-color: red;', 'background-color: blue;', $content);
return $content;
});
```
### process/js/content
This filter allows you to adjust the content of the JS file before it is being compiled.
```php
add_filter('blockstudio/assets/process/js/content', function($content) {
$content = str_replace('console.log("hi");', 'console.log("hello");', $content);
return $content;
});
```
## Render
### global
This filter allows you to adjust the output of the page before it is being rendered.
```php
add_action('blockstudio/render', function($output, $blocks) {
if ($blocks['ui/heading']) {
$output = str_replace('` tag before it is being rendered.
```php
add_action('blockstudio/render/head', function($output, $blocks) {
if ($blocks['ui/heading']) {
$output .= '';
}
return $output;
}, 10, 2);
```
### footer
This filter allows you to adjust the output of the `
` before it is being rendered.
```php
add_action('blockstudio/render/footer', function($output, $blocks) {
if ($blocks['ui/heading']) {
$output .= '';
}
return $output;
}, 10, 2);
```
Below you'll find a list of all available PHP hooks that can be used to extend
or adjust the functionality of the plugin.
Path
This filter allows you to adjust the path of the block folder. By default, this
is blockstudio inside the currently active theme. Alternatively it is possible
to create a new
instance for multiple
source directories.
This filter allows you to enable or disable context file generation for LLM tool integration. When enabled, the context file assembles up-to-date block data, Blockstudio settings of the current install, all relevant schemas, and Blockstudio documentation into a single source for use with AI development tools.
