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 3w ago

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 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

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

1084d 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.7M131](/packages/timber-timber)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[hellonico/timber-dump-extension

Provides Symfony VarDumper component for Timber

31216.5k10](/packages/hellonico-timber-dump-extension)[pressbooks/pressbooks-book

This theme is named after Canadian media theorist Marshall McLuhan, who coined the phrase “the medium is the message.” It is designed for academic writing and is also suitable for fiction. Headings are set in Cormorant Garamond, and body type is set in Lora.

216.7k](/packages/pressbooks-pressbooks-book)[benjaminmedia/wp-polylang-theme-strings

Polylang Theme Strings with support for Blade syntax

1610.1k](/packages/benjaminmedia-wp-polylang-theme-strings)

PHPackages © 2026

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