wp-app-framework

    #[TemplateFunction]

    Attribute on methods.

    use WebCodingCat\WpAppFramework\Twig\TemplateFunction;

    Registers a public method of a service as a Twig function.

    The service is resolved only when a template calls the function. The return value is escaped like any other output unless html is true; then it is printed as is and the method must return a string. Arguments are passed unescaped, so an HTML function must escape every argument it puts into its result.

    With public: true, a plugin offers the function to the templates of other consumers (the theme, other plugins), and a theme to the templates of its child theme. Its name must start with the template prefix of the plugin or theme (the slug with underscores, e.g. my_plugin_) and its signature must not use classes of the framework or of other dependencies. Consumers declare the plugin in extra.wp-app-framework.template-plugins of their composer.json and call the function by its name; for a child theme, its parent theme is declared automatically. Child themes cannot offer functions.

    Arguments

    #[TemplateFunction(string $name, bool $html = false, bool $public = false)]
    ParameterTypeDefaultDescription
    namestringrequiredName of the function in templates, a valid identifier, e.g. price; it must not reuse a function Twig provides or the framework already uses.
    htmlboolfalseThe method returns HTML (string), which is printed unescaped.
    publicboolfalseOffer the function to the templates of other consumers: a plugin to themes and other plugins, a theme to its child themes. The name must then start with the template prefix.