library timber {🖫 167,832, ⚐ 146, ★ 3,853}

timber/timber

Plugin to write WordPress themes w Object-Oriented Code and the Twig Template Engine

Friday, July 20, 2018
by connorjburton
Repository
138 Watchers
3853 Stars
167,832 Installations

PHP
37 Dependents
2 Suggesters
378 Forks
240 Open issues
100 Versions
15 % Grown

The README.md

By Jared Novack (@jarednova), Lukas Gächter (@lgaechter), Nicolas Lemoine (@nlemoine), Erik van der Bas (website), Coby Tamayo (@cobytamayo), Upstatement and hundreds of other GitHub contributors:, _(*1)

, _(*2)

, _(*3)

⚠️ Important information about the Timber plugin ⚠️

With the release of Timber 2.0, Composer is the only supported install method. We are unable to continue releasing or supporting Timber as a plugin on WordPress.org. We advise everyone to switch to the Composer based install of Timber 1 as a first step as soon as possible. If you need PHP 8.2 support you will have to switch to Timber 2.0., _(*4)

For more information and a list of additional resources, please visit this discussion., _(*5)

Timber 2

Timber 2 is out now and is the recommended version., _(*6)

GitHub: Timber 2
Documentation: https://timber.github.io/docs/v2/

Because WordPress is awesome, but the_loop isn't

Timber helps you create fully-customized WordPress themes faster with more sustainable code. With Timber, you write your HTML using the Twig Template Engine separate from your PHP files., _(*7)

This cleans up your theme code so, for example, your PHP file can focus on being the data/logic, while your Twig file can focus 100% on the HTML and display., _(*8)

This is what Timber's .twig files look like (from this Hello World example), _(*9)

{% extends "base.twig" %}
{% block content %}
  <h1 class="big-title">{{ foo }}</h1>
  <h2 class="post-title">{{ post.title }}</h2>
  <img src="{{ post.thumbnail.src }}" />
  <div class="body">
    {{ post.content }}
  </div>
{% endblock %}

Once Timber is installed and activated in your plugins directory, it gives any WordPress theme the ability to take advantage of the power of Twig and other Timber features., _(*10)

Looking for docs?

Installation

The GitHub version of Timber requires Composer and is setup for inclusion within a theme or plugin., _(*11)

cd ~/wp-content/themes/my-theme
composer require timber/timber

If your theme/plugin is not setup to pull in Composer's autoload file, you will need to, _(*12)

/* functions.php */
require_once(__DIR__ . '/vendor/autoload.php');

After this line, initialize Timber with, _(*13)

$timber = new \Timber\Timber();

What Now?

Setup the Timber Starter Theme. Once you have that installed in your WordPress setup, continue reading the Getting Started guide to Themeing., _(*14)

Mission Statement

Timber is a tool for developers who want to translate their HTML into high-quality WordPress themes through an intuitive, consistent and fully-accessible interface. * Intuitive: The API is written to be user-centric around a programmer's expectations. * Consistent: WordPress objects can be accessed through common polymorphic properties like slug, ID and name. * Accessible: No black boxes. Every effort is made so the developer has access to 100% of their HTML., _(*15)

What does it look like?

Nothing. Timber is meant for you to build a theme on. Like _s it comes style-free, because you're the style expert. Instead, Timber handles the logic you need to make a kick-ass looking site., _(*16)

Who is it good for?

Timber is great for any WordPress developer who cares about writing good, maintainable code. It helps teams of designers and developers working together. At Upstatement we made Timber because while our entire team needs to participate in building WordPress sites, not everyone knows the ins-and-outs of the_loop(), codex and PHP (nor should they). With Timber your best WordPress engineer can focus on building the .php files with requests from WordPress and pass the data into .twig files. Once there, designers can easily mark-up data and build out a site's look-and-feel., _(*17)

Twig The template language used by Timber.
Timber Starter Theme The "_s" of Timber to give you an easy start to the most basic theme you can build upon and customize.
Timber Debug Bar Adds a debug bar panel that will show you which template is in-use and the data sent to your twig file.

Editor for Timber Edit your Twig files from the WordPress admin
Pine A CLI installer for Timber
Query Monitor Twig Profile An add-on for Query Monitor to see what's going on inside your Twig files (automatically works with Timber!)
Timber ACF WP Blocks Easy ACF Gutenberg blocks creation
Timber CLI A CLI for Timber
Timber Commented Include Debug output via HTML comments before and after each include statement in Twig
Timber Debugger Package that provides extra debugging options for Timber
Timber Dump Extension Debug output with nice formatting
Timber Photon Plug-in to use JetPack's free Photon image manipulation and CDN with Timber
Timber VS Code Extension Snippets for Timber in Visual Studio Code
Timber Sugar A catch-all for goodies to use w Timber
Timber WebLink Extension Provides Twig functions to manage the Link HTTP header needed for Web Linking when using HTTP/2 Server Push as well as Resource Hints
Timmy Advanced image manipulation for Timber

Projects that use Timber

Branch Bootstrap 3 + Timber = Branch starter theme!
Flynt a component based WordPress starter theme built on Timber and ACF Pro
Gantry5 a framework for theme development
Hozokit a component based starter theme
Juniper Starter pack that incorporates Timber and Bedrock
Seedling a starter theme using Bootstrap 4

Helpful Links

CSS Tricks introduction to Timber by @tjFogarty
Twig for Timber Cheatsheet by @laras126
Timber Cheatsheet by @taotiwordpress
TutsPlus A guide to getting started by @ahmadawais

Support

Please post on StackOverflow under the "Timber" tag. Please use GitHub issues only for specific bugs, feature requests and other types of issues., _(*18)

Should I use it?

Timber is MIT-licensed, so please use in personal or commercial work. Just don't re-sell it. Timber is used on tens of thousands of sites (and tons more we don't know about), _(*19)

Contributing & Community

We love PRs! Read the Contributor Guidelines for more info. Say hello, share your tips/work, and spread the love on Twitter at @TimberWP., _(*20)

Since 2013 our goal at Timber is to create a library to that helps you create fully-customized WordPress themes faster with more sustainable code., _(*21)

Through the collaborative efforts of both our dedicated team and countless contributors, we have invested numerous hours in maintaining and enhancing Timber. To keep doing that, we rely on the invaluable support of our sponsors., _(*22)

Are you a WordPress pro or part of an agency who relies on Timber? Keep the magic alive by becoming a sponsor! By becoming a sponsor, you contribute to the continuous maintenance and enhancement of Timber, ultimately benefiting developers worldwide., _(*23)

, _(*24)

Gold Sponsors

, _(*25)

Our backers

, _(*26)

Documentation

The Official Documentation for Timber 1 is generated from the contents of this repository:, _(*27)

Documentation for classes and functions is auto generated. Any changes to the Reference section of the docs should be made by editing the function’s DocBlock. For inline documentation, we follow the WordPress PHP Documentation Standards.
To make a change to one of the guides, edit the relevant file in the docs directory.

The Versions

20/07 2018

dev-master

9999999-dev http://timber.upstatement.com

Plugin to write WordPress themes w Object-Oriented Code and the Twig Template Engine

library timber

Plugin to write WordPress themes w Object-Oriented Code and the Twig Template Engine

timber/timber

The README.md

⚠️ Important information about the Timber plugin ⚠️

Timber 2

Because WordPress is awesome, but the_loop isn't

Looking for docs?

Installation

What Now?

Mission Statement

What does it look like?

Who is it good for?

Related & Official Projects

Related Timber Projects

Projects that use Timber

Helpful Links

Support

Should I use it?

Contributing & Community

Sponsor us

Gold Sponsors

Our backers

Documentation

The Versions

dev-master

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

2.x-dev

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-mhz-tamb-webp

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

1.7.1

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-2.x-menu-item-target-optimizations

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-docs/internationalization

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-2.x-upgrade-guide

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-style/line_length

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-2.x-streamline-meta

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-1676/simple

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton

dev-2x/1681/meta_exception

The Requires

The Development Requires

by Jared Novack

by Connor J. Burton