Post Types

Website Rareloop Timber Documentation Twig Documentation
Search…
Post Types
Introduction
Typically in WordPress when you're querying posts you get WP_Post objects back. Timber have taken this a step further and return a Timber/Post object instead. This has a ton of great helper methods and properties which makes it easier and more expressive to use.
1
use Timber\Post;
2
​
3
$post = new Post(1);
4
$posts = Timber::get_posts($wpQueryArray);
Copied!
Lumberjack has its own Post object which makes it easier and more expressive to run queries.
1
use Rareloop\Lumberjack\Post;
2
​
3
$post = new Post(1);
4
$collection = Post::query($wpQueryArray);
Copied!
This becomes especially powerful when you start registering Custom Post Types.
1
use App\PostTypes\Product;
2
​
3
$post = new Product(1);
4
$collection = Product::query($wpQueryArray);
Copied!
In this example $collection contains App\PostType\Product objects. That allows you to add your own methods to a product and encapsulate logic in one place.
1
use App\PostTypes\Product;
2
​
3
$collection = Product::query($wpQueryArray);
4
​
5
foreach ($collection as $product) {
6
    echo $product->price();
7
}
Copied!
1
namespace App\PostTypes;
2
​
3
use Rareloop\Lumberjack\Post;
4
​
5
class Product extends Post
6
{
7
    // ...
8
​
9
    public function price()
10
    {
11
        // Get the price from the ACF field for this product
12
        return get_field('price', $this->id);
13
    }
14
}
Copied!
If collections are new to you, be sure the check out the documentation on them:
Collections
Register Custom Post Types
First, create a new file in app/PostTypes/. We recommend using singular names. For this example, lets add a Product.php file there.
You can use this boilerplate to get you started:
1
namespace App\PostTypes;
2
​
3
use Rareloop\Lumberjack\Post;
4
​
5
class Product extends Post
6
{
7
    /**
8
     * Return the key used to register the post type with WordPress
9
     * First parameter of the `register_post_type` function:
10
     * https://codex.wordpress.org/Function_Reference/register_post_type
11
     *
12
     * @return string
13
     */
14
    public static function getPostType()
15
    {
16
        return 'products';
17
    }
18
​
19
    /**
20
     * Return the config to use to register the post type with WordPress
21
     * Second parameter of the `register_post_type` function:
22
     * https://codex.wordpress.org/Function_Reference/register_post_type
23
     *
24
     * @return array|null
25
     */
26
    protected static function getPostTypeConfig()
27
    {
28
        return [
29
            'labels' => [
30
                'name' => __('Products'),
31
                'singular_name' => __('Product'),
32
                'add_new_item' => __('Add New Product'),
33
            ],
34
            'public' => true,
35
        ];
36
    }
37
}
Copied!
Lumberjack will handle the registering of the post type for you. In order to do that, it requires 2 methods (documented above):
getPostType()
getPostTypeConfig()
In order for Lumberjack to register your post type, you need to add the class name to the config/posttypes.php config file.
1
return [
2
    /**
3
     * List all the sub-classes of Rareloop\Lumberjack\Post in your app that you wish to
4
     * automatically register with WordPress as part of the bootstrap process.
5
     */
6
    'register' => [
7
        App\PostTypes\Product::class,
8
    ],
9
];
Copied!
And that's it! You can now start using your new Custom Post Type.
Tip: Try and avoid using ACF's get_field outside of a Post Type class where possible. This will help make your application easy to change.
1
$product = new Product;
2
​
3
// Bad
4
echo get_field('price', $product->id);
5
​
6
// Good: The knowledge of how to get the price is encapsulated within the Product class
7
echo $product->price();
Copied!
Available Methods for Rareloop\Lumberjack\Post
Lumberjack's Post class extends Timber\Post, and adds some convenient methods for you:
1
use Rareloop\Lumberjack\Post;
2
use App\PostTypes\Product;
3
​
4
// Get all published posts, with 10 per page, ordered ascending by title
5
$posts = Post::all(10, 'title', 'asc');
6
​
7
// Accepts the WP_Query args as an array. By default it will filter by published posts for the correct post type too
8
$products = Product::query(['s' => 'Toy Car']);
Copied!
Extending Post Types
The Lumberjack Post class can be extended with custom functionality at runtime (the class is "macroable"). The following example adds an acf method to the Post class that can be used to access Advanced Custom Field (ACF) field values:
1
use Rareloop\Lumberjack\Post;
2
​
3
// Add custom function
4
Post::macro('acf', function ($field) {
5
    return get_field($field, $this->id);
6
});
7
​
8
// Use the functionality
9
$post = new Post;
10
$value = $post->acf('custom_field_name');
Copied!
​
The Basics - Previous
WordPress Controllers
Next - The Basics
Query Builder
Last modified 3yr ago
Copy link
Contents
Introduction
Available Methods for Rareloop\Lumberjack\Post
Extending Post Types