我应该在单个 wordpress 模板中使用 $post = Timber::query_post() 还是 $post = new TimberPost() ？

Question

我在官方 Timber 存储库上读到，关于使用的一般问题应该在这里发布。

我是 Timber/Twig 的新手，我有一个非常“基本”的问题。

在启动主题中，我看到在 single.php 中，传递给 $context 的 $post 变量设置为

$post = Timber::query_post()

page.php 设置为

$post = new TimberPost();

那么，当我需要设置一个single-cpt.php 时，我应该使用什么方法呢？ Timber::query_post() 或 new TimberPost()?

我都试过了，他们都在工作，但正确的方法是什么？

谢谢！

PS：我在index.php 中看到$context['post'] 正在与new Timber\PostQuery() 一起设置。这是否基本再现了模板层次结构的标准循环？

Answer 1

我知道对于使用哪些方法可能存在相当大的困惑。目前，有很多方法可以做到这一点，您尝试过的所有方法都应该有效。

随着即将发布的 Timber 版本 2，我们尝试统一这一点，我们将弃用一些仍然存在的方法。所以，从现在开始，你应该这样做。

---

2020 年 3 月更新 – 我们反复讨论了 2.x 的新 API 应该如何，我们提出了一个基本固定的解决方案。那里有些事情会发生变化，如果您想了解更多信息，可以查看此pull request。

在此之前，这是我们推荐的做事方式：

---

获取单个帖子

罢工>

$post = new Timber\Post();

$post = Timber::get_post();

获取帖子集合

罢工>

$post = new Timber\PostQuery();

$post = Timber::get_posts();

如果您想在帖子中使用分页，您仍然必须使用Timber\PostQuery：

$post = new Timber\PostQuery();

（在 Timber 2.x 中 Timber::get_posts() 可以使用分页，但在 1.x 中还不行。）

标准循环

我已经看到在 index.php 中 $context['post'] 正在使用 new Timber\PostQuery() 进行设置。这是否基本再现了模板层次结构的标准循环？

是的！

事实上，如果你不向PostQuery()传递任何参数，你甚至不必设置$context['posts']，因为Timber does that already for you in Timber::get_context()。

index.php

<?php
use Timber\Timber;

$context = Timber::get_context();

Timber::render( 'index.twig', $context );

使用命名空间的类名

目前，您可能仍会看到 TimberPost() 而不是 Timber\Post()。对于版本 1，所有 Timber 类都是命名空间的，所以从现在开始推荐的方法是在 PHP 中使用命名空间的类名，例如Timber\Term 而不是 TimberTerm。

但是！在 Twig 中，您仍然会使用非命名空间版本：

{% set post = Post(post_id) %}

或

{% set post = TimberPost(post_id) %}

我希望这可以解决问题。