PHPackages                             bluecadet/timber-fractal-paths - 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. bluecadet/timber-fractal-paths

ActiveWordpress-plugin[Templating & Views](/categories/templating)

bluecadet/timber-fractal-paths
==============================

A custom twig loader for Timber and Fractal

3.0.0(2y ago)52.0kPHP

Since Sep 19Pushed 2y ago2 watchersCompare

[ Source](https://github.com/bluecadet/timber-fractal-paths)[ Packagist](https://packagist.org/packages/bluecadet/timber-fractal-paths)[ RSS](/packages/bluecadet-timber-fractal-paths/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

timber-fractal-paths
====================

[](#timber-fractal-paths)

Custom loader that allows Fractal paths to reroute to Fractal files.

Fractal
-------

[](#fractal)

Your [Fractal](https://fractal.build/) build should use a [twig engine](https://github.com/frctl/twig). You can then call your fractal patterns as is typical of Fractal:

```
{% include
  '@patterns/components/awesome-pattern' with {
    data: {
      title: 'Hi',
      content: 'Am content'
    }
  }
%}

{% include
  '@patterns/components/cool-patterns/real-cool-pattern' with {
    data: {
      title: 'Hi',
      content: 'Am content'
    }
  }
%}

```

The loader will attempt to load a `.twig` file matching the parent folders name, which is the last item in the include path. This assumes that you have the following file structure (given the above example):

```
THEME_DIR
- fractal
  - patterns
    - awesome-pattern
      - awesome-pattern.twig
    - cool-patterns
      - really-cool-pattern
        - really-cool-pattern.twig

```

`@patterns` is the default namespace used in this plugin, but `@components` is typical for Fractal.

Configuration
-------------

[](#configuration)

Namespace defaults to '@patterns'. Define `FRACTAL_HANDLE` in your theme to change the handle (DO NOT use @ in the definition, i.e. 'patterns' *not* '@patterns').

```
define('FRACTAL_HANDLE', 'patterns' );

```

Path defaults to 'THEME\_PATH/fractal/patterns' (`get_stylesheet_directory() . '/fractal/patterns'`). Define `FRACTAL_PATH` in your theme to change the handle (DO NOT use @ in the definition, i.e. 'patterns' *not* '@patterns').

```
define('FRACTAL_PATH', get_stylesheet_directory() . '/fractal/patterns' );

```

Want to add other Custom Loaders?
---------------------------------

[](#want-to-add-other-custom-loaders)

The `timber_fractal_paths/loaders` provides and array of loaders before they are pushed into the custom chain loader. Create your loader, add it to the array, and return it.

```
add_filter('timber_fractal_paths/loaders', function($loaders) {
  $loaders[] = new SomeCustomLoaderClass($paths);
  return $loaders;
}));

```

---

The scaffolding of this plugin came from [weareindi/timber-custom-loader](https://github.com/weareindi/timber-custom-loader)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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 ~464 days

Total

4

Last Release

1033d ago

Major Versions

1.0.0 → 2.0.02022-10-25

2.0.1 → 3.0.02023-07-14

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4107331?v=4)[Shaun Baer](/maintainers/baerkins)[@baerkins](https://github.com/baerkins)

---

Top Contributors

[![baerkins](https://avatars.githubusercontent.com/u/4107331?v=4)](https://github.com/baerkins "baerkins (7 commits)")

---

Tags

pluginwordpresstwigfractaltimber

### Embed Badge

![Health badge](/badges/bluecadet-timber-fractal-paths/health.svg)

```
[![Health](https://phpackages.com/badges/bluecadet-timber-fractal-paths/health.svg)](https://phpackages.com/packages/bluecadet-timber-fractal-paths)
```

###  Alternatives

[timber/timber

Create WordPress themes with beautiful OOP code and the Twig Template Engine

5.7k3.4M111](/packages/timber-timber)[hellonico/timber-dump-extension

Provides Symfony VarDumper component for Timber

31197.9k8](/packages/hellonico-timber-dump-extension)[benjaminmedia/wp-polylang-theme-strings

Polylang Theme Strings with support for Blade syntax

159.9k](/packages/benjaminmedia-wp-polylang-theme-strings)[frozzare/digster

Twig templates for WordPress

107.1k](/packages/frozzare-digster)

PHPackages © 2026

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