I’m using Timber for the first time, and I’m finding it hard to convert my pure PHP thinking to this templating model.

What I’m confused about at the moment is using a date which is an input field, not the post date.

So I’ve got a repeater field from ACF. It has three sub-fields: release_date, document_file, and document_title. My release date format is YYYY-MM-DD.

As you might have guessed, this repeater field is output as a list of PDFs.

So far so good, but then I want some advanced functionality – namely, to have the PDFs display by release_date by default. I also want to be able to filter by the year, i.e. – if you click “2015”, it would only show the documents from that year.

I know exactly how I would do this in straight WordPress, but I’m pretty confused as to how to do it in Timber. I’ve been trying to do it using a custom filter, but I have a feeling what I actually want is a custom class?

In addition, when I installed Timber it didn’t come with the starter theme, so I did a search and downloaded one from GitHub. I’ve got a feeling this is a legacy version though, because the file structure and syntax doesn’t seem to match the documentation.

Downloaded from here: https://github.com/timber/starter-theme

But for example this code in the starter theme functions.php:

function add_to_twig( $twig ) {
/* this is where you can add your own functions to twig */
$twig->addExtension( new Twig_Extension_StringLoader() );
$twig->addFilter('split_date', new Twig_SimpleFilter('split_date', array($this, 'split_date')));
return $twig;


Doesn’t quite match the syntax in https://github.com/timber/timber/wiki/Extending-Timber under “Adding to Twig”.

Read more here: Extending Timber


If you know the solution of this issue, please leave us a reply in Comment section, to update the question.

Wordpress related questions and answers: