Setup

Installation

Via WordPress.org (easy)

You can grab the all-things-included plugin at WordPress.org either through the WordPress site or through the Plugins menu in the backend. Then skip ahead to using the starter theme.

Via GitHub (for developers)

The GitHub version of Timber requires Composer. If you’d prefer one-click installation, you should use the WordPress.org version.

composer require timber/timber

If your theme is not setup to pull in Composer’s autoload file, you will need to add the following at the top of your functions.php file:

functions.php

<?php
require_once( __DIR__ . '/vendor/autoload.php' );

Initialize Timber with:

functions.php

<?php
$timber = new Timber\Timber();

Use the starter theme

The starter theme is for starting a project from scratch. You can also use Timber in an existing theme.

Like where twentyeleven and twentytwelve live. The Timber Starter Theme will live at the same level.

/wp-content/themes  /twentyeleven
                    /twentytwelve
                    /timber-starter-theme

You should now have:

/wp-content/themes/timber-starter-theme

You should probably rename this to something better.

1. Activate Timber

It will be in wp-admin/plugins.php.

2. Select your theme in WordPress

Make sure you select the Timber-enabled theme after you activate the plugin. The theme will crash unless Timber is activated. Use the timber-starter-theme theme from the step above (or whatever you renamed it to).

3. Let’s write our theme!

Continue ahead in part 2 about Theming.