Skip to content
The "_s" for Timber: a dead-simple theme that you can build anything from
Branch: master
Clone or download
Latest commit cb1037d Mar 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Fix install-wp-tests.sh Nov 24, 2015
static ref #33 -- let's make that a .html file Nov 4, 2016
templates Merge pull request #77 from stefenphelps/patch-1 Mar 8, 2019
tests Update testFunctionsPHP Mar 11, 2019
.gitignore Complying with WordPress Coding Standards Aug 24, 2018
.travis.yml Update .travis.yml Oct 6, 2017
404.php
LICENSE Added files from the jarednova/timber repo Feb 25, 2015
README.md Link to "ACF Cookbook" updated Mar 1, 2018
archive.php Change Timber::get_context to Timber::context Mar 11, 2019
author.php
composer.json
footer.php Complying with WordPress Coding Standards Aug 24, 2018
functions.php
header.php
humans.txt Add humans.txt! Aug 17, 2017
index.php
page.php
phpunit.xml
screenshot.png Update screenshot Sep 8, 2016
search.php Change Timber::get_context to Timber::context Mar 11, 2019
sidebar.php Complying with WordPress Coding Standards Aug 24, 2018
single.php Change Timber::get_context to Timber::context Mar 11, 2019
style.css

README.md

The Timber Starter Theme

The "_s" for Timber: a dead-simple theme that you can build from. The primary purpose of this theme is to provide a file structure rather than a framework for markup or styles. Configure your Sass, scripts, and task runners however you would like!

Build Status

Installing the Theme

Install this theme as you would any other, and be sure the Timber plugin is activated. But hey, let's break it down into some bullets:

  1. Make sure you have installed the plugin for the Timber Library (and Advanced Custom Fields - they play quite nicely together).
  2. Download the zip for this theme (or clone it) and move it to wp-content/themes in your WordPress installation.
  3. Rename the folder to something that makes sense for your website (generally no spaces and all lowercase). You could keep the name timber-starter-theme but the point of a starter theme is to make it your own!
  4. Activate the theme in Appearance > Themes.
  5. Do your thing! And read the docs.

What's here?

static/ is where you can keep your static front-end scripts, styles, or images. In other words, your Sass files, JS files, fonts, and SVGs would live here.

templates/ contains all of your Twig templates. These pretty much correspond 1 to 1 with the PHP files that respond to the WordPress template hierarchy. At the end of each PHP template, you'll notice a Timber::render() function whose first parameter is the Twig file where that data (or $context) will be used. Just an FYI.

bin/ and tests/ ... basically don't worry about (or remove) these unless you know what they are and want to.

Other Resources

The main Timber Wiki is super great, so reference those often. Also, check out these articles and projects for more info:

You can’t perform that action at this time.