PHPackages                             palmiak/timber-acf-wp-blocks - 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. palmiak/timber-acf-wp-blocks

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

palmiak/timber-acf-wp-blocks
============================

Create Gutenberg blocks from Twig templates and ACF fields.

1.15(4y ago)24872.5k—7.7%28[17 issues](https://github.com/palmiak/timber-acf-wp-blocks/issues)[6 PRs](https://github.com/palmiak/timber-acf-wp-blocks/pulls)1MITPHPPHP >=5.6CI passing

Since Jun 4Pushed 1y ago14 watchersCompare

[ Source](https://github.com/palmiak/timber-acf-wp-blocks)[ Packagist](https://packagist.org/packages/palmiak/timber-acf-wp-blocks)[ RSS](/packages/palmiak-timber-acf-wp-blocks/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (30)Used By (1)

 [![](timber-wp-acf-blocks.png)](timber-wp-acf-blocks.png)

Timber ACF WP Blocks
====================

[](#timber-acf-wp-blocks)

Generate ACF Gutenberg blocks just by adding templates to your Timber theme. This package is based heavily on [this article](https://medium.com/nicooprat/acf-blocks-avec-gutenberg-et-sage-d8c20dab6270) by [nicoprat](https://github.com/nicooprat) and the [plugin](https://github.com/MWDelaney/sage-acf-wp-blocks) by [MWDelaney](https://github.com/MWDelaney).

Complete documentation
----------------------

[](#complete-documentation)

[Read the complete documentation](https://palmiak.github.io/timber-acf-wp-blocks/#/)

Contributors
------------

[](#contributors)

This plugin is build with help of contributors:

- [roylodder](https://github.com/roylodder)
- [BrentWMiller](https://github.com/BrentWMiller)
- [Marcin Krzemiński](https://github.com/marcinkrzeminski)
- [Kuba Mikita](https://github.com/Kubitomakita)
- [LandWire](https://github.com/landwire)
- [Viktor Szépe](https://github.com/szepeviktor)

Creating blocks
---------------

[](#creating-blocks)

Add twig templates to `views/blocks` which get and use ACF data. Each template requires a comment block with some data in it:

```
{#
  Title: Testimonial
  Description: Customer testimonial
  Category: formatting
  Icon: admin-comments
  Keywords: testimonial quote "customer testimonial"
  Mode: edit
  Align: left
  PostTypes: page post
  SupportsAlign: left right
  SupportsMode: false
  SupportsMultiple: false
#}

    {{ fields.testimonial }}

      {{ fields.author }}

  [data-{{ block.id }}] {
    background: {{ fields.background_color }};
    color: {{ fields.text_color }};
  }

```

Timber 2.0
----------

[](#timber-20)

**Timber ACF WP Blocks** is fully compatible with both **Timber 1.x** and **Timber 2.x** versions.

How can I report security bugs?
-------------------------------

[](#how-can-i-report-security-bugs)

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team helps validate, triage, and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/7e30249d-c84c-42d1-81b7-2c9238f86638)

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity49

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 91.4% 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 ~43 days

Recently: every ~92 days

Total

20

Last Release

1725d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a994ca6946b431eaa5a51804f5eec26ef034dfc25435a26142fd9fc6318eb03b?d=identicon)[palmiak](/maintainers/palmiak)

---

Top Contributors

[![palmiak](https://avatars.githubusercontent.com/u/2342458?v=4)](https://github.com/palmiak "palmiak (85 commits)")[![tlewap](https://avatars.githubusercontent.com/u/5683825?v=4)](https://github.com/tlewap "tlewap (3 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (2 commits)")[![badabingbreda](https://avatars.githubusercontent.com/u/12700954?v=4)](https://github.com/badabingbreda "badabingbreda (1 commits)")[![dylanjameswagner](https://avatars.githubusercontent.com/u/893345?v=4)](https://github.com/dylanjameswagner "dylanjameswagner (1 commits)")[![jdamner](https://avatars.githubusercontent.com/u/482959?v=4)](https://github.com/jdamner "jdamner (1 commits)")

---

Tags

hacktoberfesttwig-templateswordpressadvanced custom fieldsgutenberg

### Embed Badge

![Health badge](/badges/palmiak-timber-acf-wp-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/palmiak-timber-acf-wp-blocks/health.svg)](https://phpackages.com/packages/palmiak-timber-acf-wp-blocks)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[mwdelaney/sage-acf-gutenberg-blocks

Create Gutenberg blocks from Sage blade templates and ACF fields.

354359.9k1](/packages/mwdelaney-sage-acf-gutenberg-blocks)[gamajo/template-loader

A class for your WordPress plugin, to allow loading template parts with fallback through the child theme > parent theme > plugin

29647.0k5](/packages/gamajo-template-loader)

PHPackages © 2026

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