Filters and Hooks

Customize the query and output of the shortcode for a Layout.

Please make sure you've installed the latest version of the plugin before using these filters.

Some filters are common and available in both the Lite and Pro plugin versions, where some are only available in the Pro version, these have been labelled as (Pro).

This page lists hooks that are common for both Layouts and Post Selections. Check the child pages to see hooks related to Layouts and Post Selections.

Common hooks list

acf_views/manage_capability

acf_views/container (Pro)

acf_views/twig/custom_functions (Pro)

acf_views/twig/custom_filters (Pro)

Common hooks description

Manage capability

By default, Layout and Post Selection management (menu items, lists, etc.) is available only to administrators (or custom roles with the manage_options capability). To change the default capability use this hook:

add_filter( 'acf_views/manage_capability', function (string $manage_capability): string {
    // Allow management for anyone who can edit posts, e.g. authors.
    return "edit_posts";
} );

You can read more about roles and capabilities in the WordPress Docs.

Container (Pro)

Using this hook, you can define a PHP-DI container, and then use it inside Custom_View_Data and Custom_Card_Data classes. Read more

use DI\Container;

$container = new Container();

add_filter( 'acf_views/container', function () use ( $container ) {
	return $container;
} );

Custom Twig functions (Pro)

add_filter('acf_views/twig/custom_functions', function (array $customFunctions): array {
    return array_merge($customFunctions, [
        [
            'prefixer',
            function ($firstArg) {
                return 'prefix2' . $firstArg;
            }
        ]
    ]);
});

add_filter('acf_views/twig/custom_functions', function (array $customFunctions): array {
    return array_merge($customFunctions, [
        [
            'prefixerWithHtml',
            function ($firstArg) {
                return '<strong>prefix</strong>' . $firstArg;
            },
            ['is_safe' => ['html',],]
        ]
    ]);
});

Note: every item of the array represents the custom function. First argument is the function name, second is the callback. Third argument is optional, here you can pass any function settings supported by Twig.

For the function callback, you can define as many arguments as you need.

Now you can call your functions in twig templates of your Layouts and Post Selections.

{{ prefixer(myVar) }}
{{ prefixerWithHtml(myVar) }}

Custom Twig filters (Pro)

add_filter('acf_views/twig/custom_filters', function (array $customFunctions): array {
    return array_merge($customFunctions, [
        [
            'prefixer',
            function ($value, $firstArg) {
                return $firstArg . $value;
            }
        ]
    ]);
});

add_filter('acf_views/twig/custom_filters', function (array $customFunctions): array {
    return array_merge($customFunctions, [
        [
            'prefixerWithHtml',
            function ($value, $firstArg) {
                return '<strong>'.$firstArg.'</strong>' . $value;
            },
            ['is_safe' => ['html',],]
        ]
    ]);
});

Note: every item of the array represents the custom filter. First argument is the filter name, second is the callback. Third argument is optional, here you can pass any filter settings supported by Twig.

For the filter callback, you can define as many arguments as you need.

Now you can call your filters in twig templates of your Layouts and Post Selection.

{{ myVar|prefixer("prefix") }}
{{ myVar|prefixer("prefix") }}

Do you need to customize something but a filter isn't available?

Then Contact us and we'll try to add it as soon as possible.