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.

Navigate to your WordPress themes directory #

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.