A look at Rareloop's new WordPress starter theme (and framework), Lumberjack 2. The slides cover what problem it solves and some of the features it includes.

1. Supercharging WordPress
Development in 2018
by Joe Lambert, Rareloop
LUMBERJACK 2
@joelambert

2. Overview

3. Overview
• The Problem

4. Overview
• The Problem
• Overview of Lumberjack 1

5. Overview
• The Problem
• Overview of Lumberjack 1
• Overview of Bedrock & Timber

6. Overview
• The Problem
• Overview of Lumberjack 1
• Overview of Bedrock & Timber
• Lumberjack 2 features

7. The Digital Product Studio

8. What problem are we solving?

9. Project Spectrum

10. CONTENT SITE
Project Spectrum

11. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

12. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

13. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

14. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

15. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

16. Lumberjack 1

17. Lumberjack 1
• Launched end of 2015

18. Lumberjack 1
• Launched end of 2015
• Aimed to make development more sane, came up with some conventions

19. Lumberjack 1
• Launched end of 2015
• Aimed to make development more sane, came up with some conventions
• Built on two open source projects

20. Lumberjack 1
• Launched end of 2015
• Aimed to make development more sane, came up with some conventions
• Built on two open source projects
• Timber

21. Lumberjack 1
• Launched end of 2015
• Aimed to make development more sane, came up with some conventions
• Built on two open source projects
• Timber
• Bedrock

22. Lumberjack 1
• Launched end of 2015
• Aimed to make development more sane, came up with some conventions
• Built on two open source projects
• Timber
• Bedrock
• Stopped short of being a full framework

23. What is Timber?

24. <h1><?php echo get_post_meta(get_the_ID(), 'customTitle'); ?></h1>
<p><?php echo get_post_meta(get_the_ID(), 'customDescription'); ?></p>
<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
<div id="post-<?php the_ID(); ?>">
<h1><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h1>
<?php the_content(); ?>
</div>
<?php endwhile; ?>
index.php

25. <h1>{{ customTitle }}</h1>
<p>{{ customDescription }}</p>
{% for post in posts %}
<div id="post-{{ post->id }}">
<h2><a href="{{ post->permalink }}">{{ post->title }}</a></h2>
{{ post->content|raw }}
</div>
{% endfor %}
index.twig
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
Timber::render('index.twig', $context);
index.php

26. <h1>{{ customTitle }}</h1>
<p>{{ customDescription }}</p>
{% for post in posts %}
<div id="post-{{ post->id }}">
<h2><a href="{{ post->permalink }}">{{ post->title }}</a></h2>
{{ post->content|raw }}
</div>
{% endfor %}
index.twig
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
Timber::render('index.twig', $context);
index.php

27. <h1>{{ customTitle }}</h1>
<p>{{ customDescription }}</p>
{% for post in posts %}
<div id="post-{{ post->id }}">
<h2><a href="{{ post->permalink }}">{{ post->title }}</a></h2>
{{ post->content|raw }}
</div>
{% endfor %}
index.twig
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
Timber::render('index.twig', $context);
index.php

28. <h1>{{ customTitle }}</h1>
<p>{{ customDescription }}</p>
{% for post in posts %}
<div id="post-{{ post->id }}">
<h2><a href="{{ post->permalink }}">{{ post->title }}</a></h2>
{{ post->content|raw }}
</div>
{% endfor %}
index.twig
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
Timber::render('index.twig', $context);
index.php

29. What is Bedrock?

30. Traditional WordPress

31. Traditional WordPress
WordPress

32. Traditional WordPress
WordPressTimber

33. Traditional WordPress
WordPressTimber
Yoast

34. Traditional WordPress
WordPressTimber
Yoast
ACF

35. Traditional WordPress
Theme
WordPressTimber
Yoast
ACF

36. Lumberjack 1

37. Lumberjack 1
Bedrock

38. Lumberjack 1
Bedrock
WordPress v4.5.*

39. Lumberjack 1
Bedrock
WordPress v4.5.*
Timber
v1.1.*

40. Lumberjack 1
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3

41. Lumberjack 1
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2

42. Theme
Lumberjack 1
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2

43. Lumberjack 2

44. Lumberjack 2
Bedrock

45. Lumberjack 2
Bedrock
WordPress v4.5.*

46. Lumberjack 2
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2

47. Lumberjack 2
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2
Lumberjack v2.0.*

48. Theme
Lumberjack 2
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2
Lumberjack v2.0.*

49. Feature tour…
It’s designed so you can use as much or as little as you need

50. Controllers

51. $context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
Timber::render('index.twig', $context);
index.php

52. namespace App;
use RareloopLumberjackHttpResponsesTimberResponse;
use RareloopLumberjackPost;
use TimberTimber;
class IndexController
{
public function handle()
{
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
}
}
Timber::render('index.twig', $context);
index.php

53. namespace App;
use RareloopLumberjackHttpResponsesTimberResponse;
use RareloopLumberjackPost;
use TimberTimber;
class IndexController
{
public function handle()
{
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
}
}
Timber::render('index.twig', $context);
extends BaseController
index.php

54. namespace App;
use RareloopLumberjackHttpResponsesTimberResponse;
use RareloopLumberjackPost;
use TimberTimber;
class IndexController
{
public function handle()
{
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
}
}
Timber::render('index.twig', $context);
extends BaseController
index.php

55. namespace App;
use RareloopLumberjackHttpResponsesTimberResponse;
use RareloopLumberjackPost;
use TimberTimber;
class IndexController
{
public function handle()
{
$context = Timber::get_context();
// Get custom meta from current page
$context['customTitle'] = get_post_meta(the_ID(), 'customTitle');
$context['customDescription'] = get_post_meta(the_ID(), 'customDescription');
// Get list of posts to show
$context['posts'] = Timber::get_posts();
}
}
return new TimberResponse('index.twig', $context);
extends BaseController
index.php

56. Controller Benefits
• Procedural -> Object Orientated code
• Can use inheritance to extend a base class for common functionality
• Can encapsulate more complex routines in private functions
• Make use of PSR-7 compliant Response objects

57. Routing

58. use RareloopLumberjackFacadesRouter;
use ZendDiactorosResponseHtmlResponse;
Router::get('hello/world', function () {
return HtmlResponse('<h1>Hello World!</h1>');
});
Simple Routes

59. Router::get('hello/{name}', function ($name) {
return HtmlResponse('<h1>Hello ' . $name . '!</h1>');
});
Params & Named Routes

60. Router::get('hello/{name}', function ($name) {
return HtmlResponse('<h1>Hello ' . $name . '!</h1>');
});->name('hello.world');
Params & Named Routes

61. Router::get('hello/{name}', function ($name) {
return HtmlResponse('<h1>Hello ' . $name . '!</h1>');
});
echo Router::url('hello.world', ['name' => 'joe']);
->name('hello.world');
Params & Named Routes

62. Router::get(‘hello/world', 'AppControllersHelloController@show');
Controller Definitions

63. Middleware

64. Middleware
Application

65. Middleware
Application
Request

66. Middleware
Application
Request Response

67. Middleware
Middleware
Application
Request Response

68. Middleware
Middleware
Application
Request Response

69. Middleware
Middleware
Application
Request Response

70. Router::get('hello/world', function () {
return JsonResponse({
text: 'Hello World'
});
});
Middleware

71. Router::get('hello/world', function () {
return JsonResponse({
text: 'Hello World'
});
});->middleware(new CorsMiddleware);
Middleware

72. Router benefits
• Extend WordPress site with custom URL endpoints
• Access to all REST based verbs
• Can add Groups, for collecting similar resources together
• PSR-15 compatible Middleware

73. Post Objects

74. use TimberPost;
$post = new Post(1);
$collection = Timber::get_posts($wpQueryArray);
Timber Post Object

75. use RareloopLumberjackPost;
$post = new Post(1);
$collection = Post::query($wpQueryArray);
Lumberjack Post Object

76. class Product extends Post
{
public function getPhotos() : array
{
// Do database query to get the assigned photos
}
}
Encapsulate Business Logic

77. class Product extends Post
{
public function getPhotos() : array
{
// Do database query to get the assigned photos
}
}
Encapsulate Business Logic
$product = new Product(123);
$photos = $product->getPhotos();

78. class Product extends Post
{
}
Register Custom Post Types

79. class Product extends Post
{
}
Register Custom Post Types
public static function getPostType()
{
return ‘product';
}

80. class Product extends Post
{
}
Register Custom Post Types
protected static function getPostTypeConfig()
{
return [
'labels' => [
'name' => __('Products'),
'singular_name' => __('Product'),
],
'public' => true,
'has_archive' => false,
];
}
public static function getPostType()
{
return ‘product';
}

81. class Product extends Post
{
}
Register Custom Post Types
// config/posttypes.php
return [
'register' => [
AppProduct::class,
],
];
protected static function getPostTypeConfig()
{
return [
'labels' => [
'name' => __('Products'),
'singular_name' => __('Product'),
],
'public' => true,
'has_archive' => false,
];
}
public static function getPostType()
{
return ‘product';
}

82. Config

83. // config/app.php
return [
'debug' => true,
‘environment’ => getenv('WP_ENV'),
'logs' => [
'enabled' => true,
'location' => '/tmp',
],
];

84. // config/app.php
return [
'debug' => true,
‘environment’ => getenv('WP_ENV'),
'logs' => [
'enabled' => true,
'location' => '/tmp',
],
];
// functions.php
use RareloopLumberjackFacadesConfig;
Config::get('app.debug'); // => true

85. // config/app.php
return [
'debug' => true,
‘environment’ => getenv('WP_ENV'),
'logs' => [
'enabled' => true,
'location' => '/tmp',
],
];
// functions.php
use RareloopLumberjackFacadesConfig;
Config::get('app.debug'); // => true
Config::get('app.logs.location'); // => ‘/tmp'

86. Out the box config

87. Out the box config
• Post Type Registration

88. Out the box config
• Post Type Registration
• Image sizes

89. Out the box config
• Post Type Registration
• Image sizes
• Logging

90. Out the box config
• Post Type Registration
• Image sizes
• Logging
• Menu’s

91. Out the box config
• Post Type Registration
• Image sizes
• Logging
• Menu’s
• Timber load paths

92. Out the box config
• Post Type Registration
• Image sizes
• Logging
• Menu’s
• Timber load paths
• Basic theme support (e.g. enable Featured Image support)

93. Advanced Features

94. Advanced Features
• Dependency Injection Container (using PHP-DI)

95. Advanced Features
• Dependency Injection Container (using PHP-DI)
• This allows us to use Facades

96. Advanced Features
• Dependency Injection Container (using PHP-DI)
• This allows us to use Facades
• Makes the framework and themes more testable

97. Recap

98. Recap
• The Problem

99. Recap
• The Problem
• Overview of Lumberjack 1

100. Recap
• The Problem
• Overview of Lumberjack 1
• Overview of Bedrock & Timber

101. Recap
• The Problem
• Overview of Lumberjack 1
• Overview of Bedrock & Timber
• Lumberjack 2 features

102. Give it a try

103. Give it a try
Lumberjack 2 Starter Theme
https://github.com/rareloop/lumberjack/tree/v2

104. Give it a try
Lumberjack 2 Framework
https://github.com/rareloop/lumberjack-core
Lumberjack 2 Starter Theme
https://github.com/rareloop/lumberjack/tree/v2

105. Give it a try
Lumberjack 2 Framework
https://github.com/rareloop/lumberjack-core
Lumberjack 2 Starter Theme
https://github.com/rareloop/lumberjack/tree/v2
@joelambert@rareloop

106. Give it a try
Lumberjack 2 Framework
https://github.com/rareloop/lumberjack-core
Lumberjack 2 Starter Theme
https://github.com/rareloop/lumberjack/tree/v2
Warning - this is still beta!!
@joelambert@rareloop