Feature/twig hooks filters

[slawkens]

This commit introduces new type of hooks: filters.

The usage is similar to WordPress filters: https://developer.wordpress.org/plugins/hooks/filters/

Example 1:

Hook into twig->display & $twig->render

Plugin.json:

"hooks": {
	"Twig Display": {
		"type": "FILTER_TWIG_DISPLAY",
		"file": "plugins/example/twig-display.php"
	}
},

plugins/example/twig-display.php

<?php

// if the template is characters.html.twig, replace the town visible for user
if ($args['viewName'] == 'characters.html.twig') {
	$args['town'] = 'My Custom City';
}
return $args;

Example 2

Remove Powered by MyAAC

Plugin.json

"hooks": {
	"Twig Display": {
		"type": "FILTER_THEME_FOOTER",
		"file": "plugins/example/remove-footer.php"
	}
},

plugins/example/remove-footer.php

<?php

/**
 * @var array $args
 */

$elementsToRemove = [];
foreach ($args as $id => &$footerPart) {
	if (str_contains($footerPart, 'Powered by')) {
		$elementsToRemove[] = $id;
	}
}

foreach ($elementsToRemove as $id) {
	unset($args[$id]);
}

return $args;