Slide links: - https://github.com/Rareloop/lumberjack - https://docs.lumberjack.rareloop.com - http://slack.lumberjack.rareloop.com - https://github.com/Rareloop/lumberjack-example - https://github.com/Rareloop/lumberjack-validation - https://github.com/Rareloop/lumberjack-bedrock-installer - https://github.com/Rareloop/lumberjack-querybuilder - https://github.com/Rareloop/hatchet - https://github.com/Rareloop/lumberjack-debugbar - https://github.com/Rareloop/lumberjack-var-dumper-server - https://lizkeogh.com/2017/08/31/reflecting-reality/amp - https://www.upstatement.com/timber - https://roots.io/bedrock - https://scotch.io/bar-talk/s-o-l-i-d-the-first-five-principles-of-object-oriented-design - https://github.com/zendframework/zend-diactoros - https://www.php-fig.org - http://php-di.org

1. Supercharging WordPress
Development in 2018
by Adam Tomat, Rareloop
LUMBERJACK
@adamtomat

2. The Digital Product Studio

3. Projects
vs
Products

4. – Liz Keogh
“You’re not really ‘done’ until the software
has been retired and is no longer used at all”

5. Make your website easier to change

6. I ❤ PHP
I ❤ WordPress

10. Lumberjack

11. What are the problems with
WordPress?

12. $the_query = new WP_Query([
'posts_per_page' => 5,
'tag' => 'club'
]);
if ($the_query->have_posts()) : ?>
<h4>Recent Articles</h4>
<ul>
<?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
<li class="article">
<h3><?php the_title(); ?></h3>
<?php the_excerpt(10); ?>
<a href="<?php the_permalink(); ?>">Read more</a>
</li>
<?php endwhile; ?>
</ul>
<?php endif; ?>
t
Mix of concerns:
Presentation logic &
Database queries
"
This file has multiple
reasons to change
index.php

13. $the_query = new WP_Query([
'posts_per_page' => 5,
'tag' => 'club'
]);
if ($the_query->have_posts()) : ?>
<h4>Recent Articles</h4>
<ul>
<?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
<li class="article">
<h3><?php the_title(); ?></h3>
<?php the_excerpt(10); ?>
<a href="<?php the_permalink(); ?>">Read more</a>
</li>
<?php endwhile; ?>
</ul>
<?php endif; ?>
t
Procedural
"
Procedural code is often
not DRY or reusable.
It’s difficult to change.
Hard to read.
index.php

14. Timber!

15. <?php
$context = Timber::get_context();
$context['posts'] = Timber::get_posts([
'posts_per_page' => 5,
'tag' => 'club'
]);
Timber::render('index.twig', $context);
{% if posts is not empty %}
<h4>Recent Articles</h4>
<ul>
{% for post in posts %}
<li class="article">
<h3>{{ $post->title }}</h3>
{{ $post->preview }}
<a href="{{ $post->link }}">Read the full story</a>
</li>
{% endfor %}
</ul>
{% endif %}
index.twig
index.php

16. What are the problems with
Timber controllers?

17. <?php
$context = Timber::get_context();
$context['posts'] = Timber::get_posts([
'posts_per_page' => 5,
'tag' => 'club'
]);
Timber::render('index.twig', $context);
index.php
t
Procedural
"
Procedural code is often
not DRY or reusable.
It’s difficult to change.
Hard to read.

18. index.php
class IndexController
{
}
public function handle()
{
$context = Timber::get_context();
$context['posts'] = Timber::get_posts([
'posts_per_page' => 5,
'tag' => 'club'
]);
}
extends BaseController
return new TimberResponse('index.twig', $context);return Timber::render('index.twig', $context);

19. index.php
class IndexController extends BaseController
{
public function handle()
{
$context = Timber::get_context();
$context['posts'] = $this->getPosts();
return new TimberResponse('index.twig', $context);
}
private function getPosts()
{
return Timber::get_posts([
'posts_per_page' => 5,
'tag' => 'club'
]);
}
}

20. Benefits
• Write Object Orientated code rather than Procedural 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

21. Config

22. What are the problems with
wp-config?

23. // ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wordpress');
/** MySQL database username */
define('DB_USER', 'root');
/** MySQL database password */
define('DB_PASSWORD', ‘letmein');
/** MySQL hostname */
define('DB_HOST', 'localhost');
/** Database Charset to use in creating database tables. */
define('DB_CHARSET', 'utf8');
/** The Database Collate type. Don't change this if in doubt. */
define('DB_COLLATE', '');
wp-config.php

24. DB_NAME=wordpress
DB_USER=root
DB_PASSWORD=letmein
# Optional variables
# DB_HOST=localhost
# DB_PREFIX=wp_
WP_ENV=development
WP_HOME=http://example.com
WP_SITEURL=${WP_HOME}/wp
GOOGLE_MAPS_API_KEY=KJjn32s32dN2
.env
$apiKey = getenv('GOOGLE_MAPS_API_KEY');
Some PHP file

25. What is Bedrock?

26. Traditional WordPress
Theme
WordPressTimber
Yoast
ACF

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

28. How does Lumberjack fit
into this?

29. Lumberjack Starter Theme
Lumberjack + Bedrock = ❤
Bedrock
WordPress v4.5.*
Timber
v1.1.*
Yoast
v5.2.3
ACF
v5.6.1.2
Lumberjack Core v3.0.*

30. DB_NAME=wordpress
DB_USER=root
DB_PASSWORD=letmein
# Optional variables
# DB_HOST=localhost
# DB_PREFIX=wp_
WP_ENV=development
WP_HOME=http://example.com
WP_SITEURL=${WP_HOME}/wp
GOOGLE_MAPS_API_KEY=KJjn32s32dN2
.env
$apiKey = getenv('GOOGLE_MAPS_API_KEY');
Some PHP file
t
You can’t change config
settings
Your code shouldn’t
actually care about
dotenv

31. Your code just wants to say:
“Hey config, can I get the ‘google maps api key’ please?”

32. Some PHP file
$apiKey = Config::get('app.google_maps_api_key');
config/app.php
return [
'google_maps_api_key' => getenv('GOOGLE_MAPS_API_KEY', 'dummy-api-key'),
];

33. return [
'logs' => [
'enabled' => true,
'location' => '/tmp',
],
];
config/app.php
Some PHP file
$location = Config::get('app.logs.location'); // => '/tmp'

34. Lumberjack Config
• Post Type Registration
• Image sizes
• Error logging
• Menu locations
• Load paths of Twig files for Timber
• Basic theme support (e.g. enable Featured Image support)

35. Querying Posts

36. $args = [
'post_type' => 'product',
'posts_per_page' => 10,
'orderby' => 'title',
'order' => 'ASC',
'meta_query' => [
'relation' => 'AND',
[
'key' => 'available_from_date',
'value' => [$from_date, $to_date],
'compare' => 'BETWEEN',
'type' => 'DATE',
],
[
'key' => 'available_to_date',
'value' => [$from_date, $to_date],
'compare' => 'BETWEEN',
'type' => 'DATE',
],
]
];
$query = new WP_Query($args);
$posts = $query->get_posts();

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

38. use RareloopLumberjackPost;
use AppPostTypesProduct;
$post = new Post(1);
$collection = Post::query($wpQueryArray);
$product = new Product(1);
$collection = Product::query($wpQueryArray);
Lumberjack Post Object

39. 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();

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

41. Making queries more readable

42. Advanced Queries
$productType = new ProductType;
$products = Product::whereStatus('publish')
->whereMeta('type', '"' . $productType->id . '"', 'LIKE')
->limit(10)
->orderBy('title', 'asc')
->get();

43. Using the Query Builder directly
$products = QueryBuilder::wherePostType([
Product::getPostType(),
GiftSet::getPostType(),
])
->whereStatus('publish')
->limit(10)
->orderBy(‘title', 'asc')
->get();

44. Extending the Query Builder
$announcements = Announcement::whereStatus('publish')
->whereAddedSince('10 days ago')
->whereSearchTerm('Lorem Ipsum')
->orderBy('date', 'desc')
->paginate();

45. Custom Requests

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

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

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

49. AJAX endpoint that returns JSON
class ArticleCommentController
{
}
Router::post('articles/{id}/comments', 'AppHttpControllersArticleCommentController@store');
public function store($id, ServerRequest $request) {
}
$content = json_decode($request->getBody(), true);
$user = wp_get_current_user();
wp_new_comment([
'comment_post_ID' => (int) $articleId,
'comment_author' => $user->ID,
'comment_content' => data_get($content, 'comment'),
]);
return new JsonResponse([
'data' => [
'content' => $content['comment'],
'author' => $user->display_name,
]
], 201);

50. Router benefits
• Extend WordPress site with custom URL endpoints
• Access to all REST based verbs
• Can add Groups, for collecting similar resources together

51. Responses

52. Baked-in Responses
$response = new TimberResponse(‘templates/home.twig’, $context);
// From https://github.com/zendframework/zend-diactoros
$response = new TextResponse('Hello world!');
$response = new HtmlResponse($htmlContent);
$response = new XmlResponse($xml);
$response = new JsonResponse($data);
$response = new EmptyResponse(); // Basic 204 response:
$response = new RedirectResponse('/user/login');

54. CONTENT SITE BESPOKE SYSTEM
Project Spectrum

56. “Don’t use what you
don’t understand.”

57. Everything I’ve shown
you is optional

58. • PSR11 Dependency Injection
Container (using PHP-DI)
• Facades
• Exception Handling (PSR3)
• Validation (currently an external
package)
• View Models
More power at your fingertips ✨
• Service Providers
• Hatchet (CLI)
• Global helper functions (e.g.
config(‘app.environment’); )
• Debug bar & Dump server
• ‘Responsable’ objects (from Laravel) -
in, but currently undocumented

59. • Sessions (coming soon)
• Example theme (currently in development)
• Automated Testing
• Unit tests with PHPUnit
• Integration tests with Laravel Dusk
On the radar 📡

60. namespace TestsBrowser;
use ChadanukDuskWordpressTestsTestCase;
class ExampleTest extends TestCase
{
/* @test */
public function can_see_home_page_title()
{
$postFactory = new WP_UnitTest_Factory_For_Post();
$postId = $postFactory->create_object([
'post_title' => 'Home page title',
'post_type' => 'page',
'post_name' => 'home'
]);
$this->browse(function ($browser) {
$browser->visit(‘/')
->assertSee('Home page title');
});
}
}

64. Get Involved

65. Take Lumberjack for a spin

66. • Evaluate the product mindset for you (and your team?)
• WordPress is awesome, we can make it even more awesome!
• Challenge and push your stack forward
• Write code which is easier to change
• Lumberjack is basically Laravel in WordPress
• Use only what you need to in Lumberjack
In summary…

68. docs.lumberjack.rareloop.com slack.lumberjack.rareloop.com
Documentation Join Slack
We’re always hiring 😊