Download the PHP package itcig/sage-timber without Composer

Sage-9-Timber

Sage-9-Timber is Sage theme version 9 made to work with Timber.

For easy integrations and later compatibility, this repository aimed at making the minimum of changes possible to the original Sage 9 beta 4 in order to make Timber work. This theme has still twig template language support.

Sage 9 is in active development and is currently in beta. This initial fork used version Sage 9 beta 4. If you want a stable version of Sage ported to Timber, have a look at the sage-timber project.

Bedrock specific Install

You must implement the following in the root of the Bedrock project composer.json. Otherwise your controllers will not be loaded by the SageController package since it will be expecting them to load relative to the theme composer autoloader.

Features

• Sass for stylesheets
• ES6 for JavaScript
• Webpack for compiling assets, optimizing images, and concatenating and minifying files
• Browsersync for synchronized browser testing
• Twig as a templating engine
• Controller for passing data to Blade templates
• CSS framework options:
  • Bootstrap 4
  • Bulma
  • Foundation
  • Tachyons
  • None (blank slate)
• Font Awesome (optional)

See a working example at roots-example-project.com.

Requirements

Make sure all dependencies have been installed before moving on:

• Timber as a WordPress plugin
• WordPress >= 4.7
• PHP >= 7.0
• Composer
• Node.js >= 6.9.x
• Yarn

Theme installation

Install Sage-9-timber by copying the project into a new folder within your WordPress themes directory.

Theme structure

Theme setup

Edit app/setup.php to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.

Theme development

• Run yarn from the theme directory to install dependencies
• Update resources/assets/config.json settings:
  • devUrl should reflect your local development hostname
  • publicPath should reflect your WordPress folder structure (/wp-content/themes/sage for non-Bedrock installs)

Build commands

• yarn run start — Compile assets when file changes are made, start Browsersync session
• yarn run build — Compile and optimize the files in your assets directory
• yarn run build:production — Compile assets for production

Documentation

Timber documentation is available at https://timber.github.io/docs/.

Twig documentation is available at http://twig.sensiolabs.org/.

Sage 9 documentation is currently in progress and can be viewed at https://github.com/roots/docs/tree/sage-9/sage.

Controller documentation is available at https://github.com/soberwp/controller#usage.

Contributing

Contributions are welcome from everyone. Just issue a pull request to this repository.

Sage Community

Keep track of development and community news.

• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter
• Listen to the Roots Radio podcast