PHPackages                             juvo/bricks-dynamic-data-tags - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. juvo/bricks-dynamic-data-tags

ActiveLibrary[Utility & Helpers](/categories/utility)

juvo/bricks-dynamic-data-tags
=============================

Easy to use dynamic data tags for Bricks

1.1.6(1y ago)172.5k↓90.8%1[1 issues](https://github.com/JUVOJustin/bricks-dynamic-data-tags/issues)[1 PRs](https://github.com/JUVOJustin/bricks-dynamic-data-tags/pulls)GPL-3.0-or-laterPHPPHP >=7.4.0

Since Feb 17Pushed 1y ago2 watchersCompare

[ Source](https://github.com/JUVOJustin/bricks-dynamic-data-tags)[ Packagist](https://packagist.org/packages/juvo/bricks-dynamic-data-tags)[ RSS](/packages/juvo-bricks-dynamic-data-tags/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (8)Dependencies (3)Versions (10)Used By (0)

God damn easy Bricks Builder Dynamic Data Tags
==============================================

[](#god-damn-easy-bricks-builder-dynamic-data-tags)

You are a developer and want to add dynamic data tags to the bricks builder? This package is for you. From now on you can add your dynamic data tags with 3 lines of code. It automatically registered tags, parses filters and even allows you to add your very own pattern parsing.

Feature overview:

- Simple registration of dynamic data tags
- Automatic parsing of filters
- Custom pattern parsing
- Output Filtering with wp\_kses

Quick Demo using within Child Theme
-----------------------------------

[](#quick-demo-using-within-child-theme)

[![](https://camo.githubusercontent.com/28823bf7b038e9795ff269919ff3ac951bfd500295c8ed10c309bca2dd66a46e/68747470733a2f2f696d672e796f75747562652e636f6d2f76692f704a346a35695a4b4b56302f6d617872657364656661756c742e6a7067)](https://youtu.be/pJ4j5iZKKV0)

Installation
------------

[](#installation)

To install the package you can use composer. Run the following command in your terminal:

```
composer require juvo/bricks-dynamic-data-tags
```

You should initiate the registry as early as possible. The best place to do this is in your plugin's main file or the functions.php of your theme.

```
add_action('init', function() {
    juvo\Bricks_Dynamic_Data_Tags\DDT_Registry::getInstance();
});
```

Usage
-----

[](#usage)

To register a simple dynamic data tag you can use the following code snippet. The first parameter is the tag name, the second parameter is the tag label, the third parameter is the tag group and the last parameter is the callback that returns the tag output.

```
DDT_Registry::getInstance()
    ->set('my_tag', 'My Tag', 'My Tag Group', function($post, $context, array $filters = []) {
        return "Hello World";
    });
```

To register another tag to the same group you simply do:

```
DDT_Registry::getInstance()
    ->set('my_tag2', 'My Tag 2', 'My Tag Group', function($post, $context, array $filters = []) {
        return "Hello World 2";
    });
```

[![Bricks Builder Dynamic Data Tags List](https://camo.githubusercontent.com/59dae81cb33acf37290988307eec887766bf2285875069e74f86da16c0b4382a/68747470733a2f2f692e706f7374696d672e63632f624e5030793854722f436170747572652d323032342d30322d31372d3134303830312e706e67)](https://postimg.cc/7bBJ9Fjr)

Filter tags that get registered
-------------------------------

[](#filter-tags-that-get-registered)

The `juvo/register_dynamic_tags` filter allows you to modify the tags that get registered. This filter passes the at this point added data tags as array. You can use this to remove tags.

```
apply_filters('juvo/dynamic_tags/register', $tags);
```

Filter the tag pattern
----------------------

[](#filter-the-tag-pattern)

The `juvo/dynamic_data_tag/parse_tag` filter allows you to modify how all tags are parsed. This filter passes the tag pattern and the tag name as arguments. It allows you to parse a custom structure of for your data tags. To add new variables that are passed to the callback make sure to add them as a [named capturing group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Named_capturing_group) with the regex.

```
// Adds "modifier" as a named capturing group to the tag pattern
add_filter("juvo/dynamic_data_tag/parse_tag", function($pattern, $tag) {
    $pattern = str_replace("}/", "", $pattern);
    return $pattern . "(\~(?[0-9a-zA-Z_-]+(\~[0-9a-zA-Z_-]+)*))?}/";
}, 10, 2);
```

Your callback now needs one more parameter:

```
DDT_Registry::getInstance()->set( 'single_tag', 'Single Tag', 'Custom Tags', function( $post, $context, array $filters = [], array $modifier = [] )

```

### Filter the tag pattern by tag name

[](#filter-the-tag-pattern-by-tag-name)

The `juvo/dynamic_data_tag/parse_tag` filter allows you to modify the tag pattern for a specific tag.

```
apply_filters("juvo/dynamic_data_tag/parse_tag/$tag", $pattern, $this->tag);
```

### Modify the data passed to the callback

[](#modify-the-data-passed-to-the-callback)

If you used one of the `parse_tag` filters to add your own structure and variables to a tag, you can use this filter to modify the variable itself. This is needed e.g. if you can add your new strucutre multiple times. By default parameters are split with ":" and filters are split with "|". If you add a new structure that is for example split with "~" you should use this filter split the data accordingly.

```
add_filter("juvo/dynamic_data_tag/parse_tag/pattern_modifier", function($value) {
    return explode("~", $value);
});
```

### Use named filters

[](#use-named-filters)

It is possible to register dynamic data tags like these: `{single_tag:tag=tag_slug:link=true}`. In your callback you need to parse the filter values to work with key value pairs. This example allows you to display tags, filter which tag to display by slug and filter the tags name should be wrapped in a link to the term itself.

```
DDT_Registry::getInstance()->set( 'single_tag', 'Single Tag', 'Custom Tags', function( $post, $context, array $filters = [] ) {
    // Parse filters to be key-value pairs
    $parsed_filters = [];
    foreach ( $filters as &$item ) {
        list( $key, $value ) = explode( '=', $item );
        $parsed_filters[ $key ] = $value;
    }
    $filters = $parsed_filters;

    $tags = get_the_terms( get_the_ID(), 'post_tag' );
    if ( empty( $tags ) || is_wp_error( $tags ) ) {
        return '';
    }

    // Filter to select a specific tag
    $selected_tag = $filters['tag'] ?? '';
    $output       = [];

    foreach ( $tags as $tag ) {
        if ((!empty($selected_tag) && $tag->slug === $selected_tag) || empty($selected_tag)) {

            // Check if we need links or not
            if ( isset( $filters['link'] ) && $filters['link'] === 'true' ) {
                $output[] = '' . esc_html( $tag->name ) . '';
            } else {
                $output[] = esc_html( $tag->name );
            }
        }
    }

    return implode( ', ', $output );
    } );
```

In this example

Modify allowed html tags
------------------------

[](#modify-allowed-html-tags)

The output of the callback is filtered with `wp_kses` to prevent XSS attacks. You can modify the allowed tags with the `wp_kses_allowed_html` filter. This filter passes the allowed tags and the context as arguments. You can use this to modify allowed html tags.

```
add_filter("wp_kses_allowed_html", function($allowedtags, $context) {
    if ($context !== "juvo/dynamic_data_tag") {
        return $allowedtags;
    }
    $allowedtags['iframe'] = [
        'src' => true,
        'width' => true,
        'height' => true,
        'frameborder' => true,
        'allow' => true,
        'allowfullscreen' => true,
        'title' => true,
    ];
    return $allowedtags;
        }, 10, 2);
```

To allow different html tags per dynamic data tag there is also a special hook. As you can see in the code snippet, general tags are filtered first and then passed to a tag specific filter.

```
$allowed_tags = wp_kses_allowed_html("juvo/dynamic_data_tag");
$allowed_tags = apply_filters("juvo/dynamic_data_tag/allowed_html_tags/$tag", $allowed_tags);
```

Advanced examples:
------------------

[](#advanced-examples)

### iFrame

[](#iframe)

Registers a dynamic data tag that displays the current post embedded in an iFrame.

```
// Register '{collection}' tag
DDT_Registry::getInstance()
    ->set('collection', 'Collection', 'Collections', function($post, $context, array $filters = []) {
        return "";
    });

// Add custom allowed html tags for the collection tag. In this case we allow iframes.
add_filter("juvo/dynamic_data_tag/allowed_html_tags/collection", function($allowedtags) {
    $allowedtags['iframe'] = [
        'src' => true,
        'width' => true,
        'height' => true,
        'frameborder' => true,
        'allow' => true,
        'allowfullscreen' => true,
        'title' => true,
    ];
    return $allowedtags;
});
```

### Post Data

[](#post-data)

Register a dynamic data tag {post\_data} to display post data. A filter allows to select which data to display. Another custom filter "bold" allows to mark certain data to be bolded. The tag can be used like this: `{post_data:title:post_type~bold=post_type~bold=title}` will be displayed as "**Title**, Post Type".

```
DDT_Registry::getInstance()->set(
    'post_data',
    'Post Data',
    'Posts',
    function( \WP_Post $post, string $context, array $filters= [], array $bold = [] ) {

        $output = [];
        foreach ( $filters as $filter ) {
            switch ( $filter ) {
                case 'title':
                    $output['title'] = get_the_title();
                    break;
                case 'excerpt':
                    $output['excerpt'] = get_the_excerpt();
                    break;
                case 'content':
                    $output['content'] = get_the_content();
                    break;
                case 'post_type':
                    $output['post_type'] = get_post_type();
                    break;
            }
        }

        // Add some of the filtered values tobe bold
        foreach($bold as $key) {
            if (in_array($key, $filters)) {
                $output[$key] = "".$output[$key]."";
            }
        }

        return implode( ', ', $output );
    }
);

// Add a custom pattern to introduce a "bold" capture group.
add_filter("juvo/dynamic_data_tag/parse_tag/post_data", function($pattern, $tag) {
    $pattern = str_replace("}/", "", $pattern);
    return $pattern . "(?:~bold=(?[0-9a-zA-Z_-]+))*}/"; // use ~bold= as separator
}, 10, 2);

// To allow the freshly added "bold" capture group to have multiple values we need to split the values by the separator
add_filter("juvo/dynamic_data_tag/parse_tag/pattern_bold", function($value) {
    return explode("~bold=", $value);
});
```

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~32 days

Recently: every ~53 days

Total

8

Last Release

643d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32efecde6068b3efb5bd8edbfc59500f23c7047b43f7846790925f73e23317a6?d=identicon)[JUVOJustin](/maintainers/JUVOJustin)

---

Top Contributors

[![laura-usc](https://avatars.githubusercontent.com/u/112548939?v=4)](https://github.com/laura-usc "laura-usc (1 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (1 commits)")

---

Tags

bricksbuilderdatatagwordpresswordpressdatatagsdynamicbricksbuilder

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/juvo-bricks-dynamic-data-tags/health.svg)

```
[![Health](https://phpackages.com/badges/juvo-bricks-dynamic-data-tags/health.svg)](https://phpackages.com/packages/juvo-bricks-dynamic-data-tags)
```

###  Alternatives

[fakerphp/faker

Faker is a PHP library that generates fake data for you.

4.0k390.0M4.6k](/packages/fakerphp-faker)[dflydev/dot-access-data

Given a deep data structure, access data by dot notation.

722393.7M109](/packages/dflydev-dot-access-data)[php-stubs/wordpress-stubs

WordPress function and class declaration stubs for static analysis.

20416.0M413](/packages/php-stubs-wordpress-stubs)[juvo/bricks-custom-query

Easy to use custom bricks query

122.2k](/packages/juvo-bricks-custom-query)[bostondv/bootstrap-ninja-forms

Adds Bootstrap classes to Ninja Forms

222.2k](/packages/bostondv-bootstrap-ninja-forms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)