PHPackages                             mmx/twig - 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. [Templating & Views](/categories/templating)
4. /
5. mmx/twig

ActiveLibrary[Templating & Views](/categories/templating)

mmx/twig
========

Twig Template Engine for MODX 3

1.0.2(2y ago)215MITPHPPHP >=7.4

Since May 14Pushed 2y ago1 watchersCompare

[ Source](https://github.com/bezumkin/mmx-twig)[ Packagist](https://packagist.org/packages/mmx/twig)[ RSS](/packages/mmx-twig/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

Twig Template Engine for MODX 3
-------------------------------

[](#twig-template-engine-for-modx-3)

> This extra is part of **MMX** initiative - the **M**odern **M**OD**X** approach.

### Prepare

[](#prepare)

This package can be installed only with Composer.

If you are still not using Composer with MODX 3, just download the `composer.json` of your version:

```
cd /to/modx/root/
wget https://raw.githubusercontent.com/modxcms/revolution/v3.0.5-pl/composer.json
```

Then run `composer update --no-dev` and you are ready to install the **mmx** packages.

### Install

[](#install)

```
composer require mmx/twig --update-no-dev --with-all-dependencies
composer exec mmx-twig install
```

### Remove

[](#remove)

```
composer exec mmx-twig remove
composer remove mmx/twig
```

### How to use

[](#how-to-use)

You can get and configure the instance of Twig in any snippet.

For example, snippet `Test`:

```
$tpl = $modx->getOption('tpl', $scriptProperties);
$var = $modx->getOption('var', $scriptProperties);

if ($service = $modx->services->get('mmxTwig')) {
    $service->addFilter(
        new \Twig\TwigFilter('hello', static function($var) {
            return $var . ' World!';
        }
    ));

    return $service->render($tpl, ['var' => $var]);
}

return '';
```

Chunk `Test`:

```
{{ var | hello }}
```

And MODX call of snippet with chunk:

```
[[!Test?tpl=`test`&var=`Hello`]]

```

You will get `Hello World!`.

---

If you use this package as a dependency for your own extra, you can load and configure the instance inside your class and make it shared through all snippets to make the same settings and modifiers.

### Template Loaders

[](#template-loaders)

You have 3 template loaders by default:

- MODX Chunk (default, no prefix - just specify id or name)
- MODX Template (template:1, or template:BaseTemplate)
- File (file:name.tpl)

If the MODX element has a static file, it will be used first, without checking the contents of the element in database.

File loader is native for Twig, it makes no connection to database at all. Use it for maximum Twig experience.

### System Settings

[](#system-settings)

All settings are prefixed with `mmx-twig.`.

#### elements-path

[](#elements-path)

The root directory for File provider.

If it is not existing or not readable, provider will be disabled and you will get INFO record in MODX log.

By default, it is not existing `core/elements` directory.

#### options

[](#options)

JSON encoded string with options to override defaults of Twig instance. For example:

```
{"strict_variables":  true}
```

See [Twig documentation](https://twig.symfony.com/doc/3.x/api.html#environment-options) for more information.

The default setting are:

```
{
    "auto_reload": true,
    "strict_variables": false,
    "autoescape": false,
    "optimizations": -1
}
```

#### use-modx

[](#use-modx)

You can enable the potentially **dangerous** use of MODX instance in templates with `{{ modx }}` global.

It will allow you to access to everything in MODX, including deleting resources, elements and directories!

```
Current id of MODX resource is: {{ modx.resource.id }}

```

### Filters

[](#filters)

Feel free to use all the [standard Twig filters](https://twig.symfony.com/doc/3.x/filters/index.html).

There are also 3 additional filters:

- `print` - print escaped variable, `{{ var | print }}`
- `dump` - dump escaped variable, `{{ var | dump }}`
- `esc` - escape MODX tags in variable, `{{ var | esc }}`

### Globals

[](#globals)

You can access system globals in your template:

- `env` to access `$_ENV`
- `get` to access `$_GET`
- `post` to access `$_POST`
- `files` to access `$_FILES`
- `cookie` to access `$_COOKIE`
- `server` to access `$_SERVER`
- `session` to access `$_SESSION`
- `request` to access `$_REQUEST`

For example `{{ server | print }}`

### Database Tables

[](#database-tables)

This extra use 2 additional database table to store time of update of MODX chunks and templates, as they have no this data by default:

- `mmx_twig_chunks_time`
- `mmx_twig_templates_time`

Also, there is additional table for tracking migrations:

- `mmx_twig_migrations`

### Caching

[](#caching)

When caching is enabled, you will get compiled templates in `core/cache/mmx-twig` directory.

This directory will be deleted when you clear MODX cache.

You cannot change this directory using the system settings, but you can set the value to `false` to disable caching.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

3

Last Release

734d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/022a5cefd3f21223338606065f89cf280b6d9dda930fd9f992c74b42077f70cf?d=identicon)[bezumkin](/maintainers/bezumkin)

---

Top Contributors

[![bezumkin](https://avatars.githubusercontent.com/u/1257284?v=4)](https://github.com/bezumkin "bezumkin (3 commits)")

### Embed Badge

![Health badge](/badges/mmx-twig/health.svg)

```
[![Health](https://phpackages.com/badges/mmx-twig/health.svg)](https://phpackages.com/packages/mmx-twig)
```

###  Alternatives

[twig/extra-bundle

A Symfony bundle for extra Twig extensions

91492.0M315](/packages/twig-extra-bundle)[twig/intl-extra

A Twig extension for Intl

36763.2M221](/packages/twig-intl-extra)[rcrowe/twigbridge

Adds the power of Twig to Laravel

9105.9M50](/packages/rcrowe-twigbridge)[twig/string-extra

A Twig extension for Symfony String

22046.0M133](/packages/twig-string-extra)[twig/cssinliner-extra

A Twig extension to allow inlining CSS

22918.5M55](/packages/twig-cssinliner-extra)[symfony/ux-twig-component

Twig components for Symfony

21914.8M162](/packages/symfony-ux-twig-component)

PHPackages © 2026

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