https://github.com/sbsedv/twig-bundle

A Symfony bundle that adds some commonly used filters and functions to the twig templating language.
https://github.com/sbsedv/twig-bundle

php php8 php81 symfony symfony-bundle symfony6 twig twig-extension

Last synced: 14 days ago
JSON representation

A Symfony bundle that adds some commonly used filters and functions to the twig templating language.

• Host: GitHub
• URL: https://github.com/sbsedv/twig-bundle
• Owner: SBSEDV
• License: mit
• Created: 2021-05-18T14:40:59.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-12-01T15:43:59.000Z (12 months ago)
• Last Synced: 2023-12-01T16:38:53.879Z (12 months ago)
• Topics: php, php8, php81, symfony, symfony-bundle, symfony6, twig, twig-extension
• Language: PHP
• Homepage:
• Size: 90.8 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![PHPStan](https://github.com/SBSEDV/twig-bundle/actions/workflows/phpstan.yml/badge.svg)](https://github.com/SBSEDV/twig-bundle/actions/workflows/phpstan.yml)

[![PHPCS-Fixer](https://github.com/SBSEDV/twig-bundle/actions/workflows/phpcsfixer.yml/badge.svg)](https://github.com/SBSEDV/twig-bundle/actions/workflows/phpcsfixer.yml)

# sbsedv/twig-bundle

A [Symfony](https://symfony.com/) bundle that adds some commonly used filters and functions to the twig templating language.

---

### **Functions**

This bundle registers the following twig functions:

#### **call_static**

As the name implies, this forwards a static call to the given class and method.

This function requires two arguments, the class name and the method name.

Any extra parameters are passed to the static call as arguments.

This function returns the return value of the forwarded call.

```php

call_static(string $class, string $method, mixed ...$args): mixed

```

#### **parameter** and **has_parameter**

Wrapper for Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface.

```php

parameter(string $key): mixed

has_parameter(string $key): bool

```

---

### **Filters**

This bundle also registers the following native PHP functions as twig filters:

```php

'123'|str_pad(5, '0') // => '00123'

'/var/www/index.html'|basename // => 'index.html'

'/var/www/index.html'|pathinfo(constant(PATHINFO_EXTENSION)) // => html

'test%40example.com'|url_decode // => '[email protected]'

```

---

### **TimezoneEventListener**

Sets the default timezone used by twigs date filter.

[More information can be found here.](https://twig.symfony.com/doc/3.x/filters/date.html#timezone)

```yaml

# config/packages/sbsedv_twig.yaml

sbsedv_twig:

    event_listeners:

        timezone_listener:

            enabled: true # Enabled by default

            cookie_name: timezone # the cookie to look for

            session_name: timezone # the session key to look for

            header_name: X-Timezone # the header to look for

```

---

### **LocalizationEventListener**

Sets locale specific default options for the "numer_format" and "date" filter.

Values are definied in the `sbsedv_twig` translation domain. See [here](translations/sbsedv_twig.en.yaml).

```yaml

# config/packages/sbsedv_twig.yaml

sbsedv_twig:

    event_listeners:

        localization_listener:

            enabled: true # Enabled by default

```