Timber Timber Versions Save

This release comes with compatibility for PHP 8.0 and 8.1. To support this, we updated the minimum required PHP version from 5.3 to 7.2.

(Please be aware that WordPress itself is still in beta support for PHP 8.0 and 8.1, which means it’s not completely completely compatible yet (see Trac tickets). You might see deprecation warnings for some functionality in WordPress.)

What’s changed

• Fixed support for PHP 8.0 and PHP 8.1 by @nlemoine in https://github.com/timber/timber/pull/2638
• Updated minimum required PHP version to 7.2 to make the included Twig version (1.44) support PHP 8.0 and 8.1, by @gchtr in https://github.com/timber/timber/pull/2640
• Added release checklist by @jarednova in https://github.com/timber/timber/pull/2597
• Deleted deprecated ISSUE_TEMPLATE.md by @szepeviktor in https://github.com/timber/timber/pull/2598

Full Changelog: https://github.com/timber/timber/compare/1.20.0...1.21.0

This is the first beta version of the long awaited Version 2 of Timber. We consider this beta feature-complete. We will concentrate on fixing bugs to be able to soon release a first release candidate.

You can try it out by following the Installation Guide. When installing Timber through Composer, you need to quire the 2.0.0-beta.1 version:

composer require timber/timber:2.0.0-beta.1

There are quite a few breaking changes in Version 2 of Timber. Refer to the Upgrade Guide for more information.

The overall goals of Timber 2.0 include:

• Making Timber more consistent.
• Making Timber easier to handle and extend.
• Refactoring how Timber Core works under the hood to improve compatibility with WordPress Core and be ready for future challenges.
• Making Timber more compatible with other plugins.

High-level changes include:

• Timber will only work as a Composer package.
• A newer, streamlined API for accessing Posts, Terms, Users, Comments and Menus.
• Class Maps for a more loosely coupled way to extend Timber with your own Post, Term, User, Menu, MenuItem, and Comment objects.
• No more direct instantiation of the classes mentioned above. Use Class Maps instead.
• New PostCollectionInterface for a unified way to deal with various lists of posts.
• An upgraded Context.
• A big update for how fetching meta values works.
• An updated WP-CLI integration.
• Better options to control and extend Twig.
• Better integration with the WordPress Date and Time functionality.

We’re happy if you want to test out the first Timber beta. In case you find errors, please open an issue (and label with 2.x and bug) or create a discussion in case you have questions.

We want to thank so so so many people for being a part of Timber and helping us achieve this milestone. We're so proud of the work and the evolution to a stable and widely-used part of so many developer's tools.

---

If you've been using the alpha versions, here's what's changed in this version of 1.0.0-beta.1:

What's Changed

• Add a .git-blame-ignore-revs file by @gchtr in https://github.com/timber/timber/pull/2606
• 2.x Add missing query() method to Timber\PostQuery by @gchtr in https://github.com/timber/timber/pull/2613
• 2.x Reintroduce Timber’s WP-CLI integration by @gchtr in https://github.com/timber/timber/pull/2611
• 2.x Remove unused WPML integration class by @gchtr in https://github.com/timber/timber/pull/2616
• 2.x Remove Attachment::$caption property in favor of Attachment::caption() method by @gchtr in https://github.com/timber/timber/pull/2612
• Make snippets CS compliant by @nlemoine in https://github.com/timber/timber/pull/2620
• 2.x update tests fix indentation by @nlemoine in https://github.com/timber/timber/pull/2622
• 2.x Fix tests in #2614 by @gchtr in https://github.com/timber/timber/pull/2621
• Use yoast/wp-test-utils by @nlemoine in https://github.com/timber/timber/pull/2614
• 2.x Document the timber/menuitem/classmap filter by @gchtr in https://github.com/timber/timber/pull/2618
• 2.x Add wp_object() method and $wp_object property for Core objects by @gchtr in https://github.com/timber/timber/pull/2615
• 2.x Update Upgrade Guide by @gchtr in https://github.com/timber/timber/pull/2617
• 2x Update CONTRIBUTING.md by @gchtr in https://github.com/timber/timber/pull/2619

Full Changelog: https://github.com/timber/timber/compare/2.0.0-alpha.5...2.0.0-beta.1

What's Changed

• Improve #2592 by @szepeviktor in https://github.com/timber/timber/pull/2593
• Add lint-composer script by @nlemoine in https://github.com/timber/timber/pull/2594
• Add QA tooling by @nlemoine in https://github.com/timber/timber/pull/2592
• add correct title to "Extending Twig" guide in v2 docs by @stefenphelps in https://github.com/timber/timber/pull/2602

Full Changelog: https://github.com/timber/timber/compare/2.0.0-alpha.5...2.0.0-alpha.6

What's Changed

• Bump version of Upstatement/Routes to 0.8.1 by @jarednova in https://github.com/timber/timber/pull/2512
• Add a timber/{object}/class to all objects types by @nlemoine in https://github.com/timber/timber/pull/2513
• Handle for duplicate term names in difft taxes by @jarednova in https://github.com/timber/timber/pull/2390
• Fix typo in resize error message. by @Web-Assembler in https://github.com/timber/timber/pull/2523
• Add webp support to letterbox filter by @ThomasBerends in https://github.com/timber/timber/pull/2528
• 2.x Fix tests by @gchtr in https://github.com/timber/timber/pull/2547
• Update composer/installers from v1 to v2 by @adamtomat in https://github.com/timber/timber/pull/2543
• Update composer/installers from v1 to v2 by @adamtomat in https://github.com/timber/timber/pull/2544
• Introduce Timber::init() as official way to initialize Timber by @gchtr in https://github.com/timber/timber/pull/2549
• Test against Latest WP Version instead of Trunk by @jarednova in https://github.com/timber/timber/pull/2563
• Improve composer version ranges by @gchtr in https://github.com/timber/timber/pull/2550
• 2.x Remove twig/cache-extension, add support for twig/cache-extra by @gchtr in https://github.com/timber/timber/pull/2546
• Menu API enhancements by @nlemoine in https://github.com/timber/timber/pull/2517
• 2.0 Use null instead of false as return type in factories by @gchtr in https://github.com/timber/timber/pull/2566
• 2.x Clean up Timber\PostCollection by @gchtr in https://github.com/timber/timber/pull/2579
• 2.x Don’t overwrite post global by @gchtr in https://github.com/timber/timber/pull/2545
• 2.x Use assertTrue() and get_class() instead of assertInstanceOf() in certain tests by @gchtr in https://github.com/timber/timber/pull/2591
• 2.x Implement new PagesMenu API by @gchtr in https://github.com/timber/timber/pull/2562
• 2.x Update Upgrade Guide with Twig deprecations by @gchtr in https://github.com/timber/timber/pull/2565

New Contributors

• @Web-Assembler made their first contribution in https://github.com/timber/timber/pull/2523
• @ThomasBerends made their first contribution in https://github.com/timber/timber/pull/2528

Full Changelog: https://github.com/timber/timber/compare/2.0.0-alpha.4...2.0.0-alpha.5

What's Changed

• Use newest version of Upstatement/routes by @jarednova in https://github.com/timber/timber/pull/2595

Full Changelog: https://github.com/timber/timber/compare/1.19.2...1.20.0

What's Changed

• Handle for duplicate term names in difft taxes by @jarednova in https://github.com/timber/timber/pull/2390
• Fix typo in resize error message. by @Web-Assembler in https://github.com/timber/timber/pull/2523
• Add webp support to letterbox filter by @ThomasBerends in https://github.com/timber/timber/pull/2528
• Update composer/installers from v1 to v2 by @adamtomat in https://github.com/timber/timber/pull/2543
• Improve composer version ranges by @gchtr in https://github.com/timber/timber/pull/2550

New Contributors

• @Web-Assembler made their first contribution in https://github.com/timber/timber/pull/2523
• @ThomasBerends made their first contribution in https://github.com/timber/timber/pull/2528

Full Changelog: https://github.com/timber/timber/compare/1.19.1...1.19.2

What's Changed

• #2445 Fix documentation inconsistencies around minimum requirements by @gchtr in https://github.com/timber/timber/pull/2506
• 2.x Fix invalid type in DocBlock by @gchtr in https://github.com/timber/timber/pull/2511
• 2.x: Nav menus improvements by @nlemoine in https://github.com/timber/timber/pull/2504
• Make cache extension optional and let users choose their own implemen… by @nlemoine in https://github.com/timber/timber/pull/2486
• 2.x Improve Date/Time Guide by @gchtr in https://github.com/timber/timber/pull/2424
• Update the readme with new link to Twig by @AlexVWeb in https://github.com/timber/timber/pull/2465
• #2417 Add GitHub Actions for 2.x and update version requirements by @gchtr in https://github.com/timber/timber/pull/2480
• Github Actions tests (2.x) by @nlemoine in https://github.com/timber/timber/pull/2417
• Don't prefer lowest for WebP tests by @jarednova in https://github.com/timber/timber/pull/2481
• Fix bug when using switch_to_blog() in combination with Timber images by @gchtr in https://github.com/timber/timber/pull/2478
• Fix the thumbnail() method return type by @titouanmathis in https://github.com/timber/timber/pull/2463
• 2.x Improve routing docs by @gchtr in https://github.com/timber/timber/pull/2469
• 2.x Add hint about checking for Timber’s version by @gchtr in https://github.com/timber/timber/pull/2479
• #2192 - Allow users to filter Timber default Twig functions by @nlemoine in https://github.com/timber/timber/pull/2408
• 2.x Improve documentation for terms by @gchtr in https://github.com/timber/timber/pull/2379
• Fix a test failing with 2.x + Multisite by @jarednova in https://github.com/timber/timber/pull/2485
• Merge in 2.x GH Actions changes by @jarednova in https://github.com/timber/timber/pull/2484
• 2.x Update Twig documentation by @gchtr in https://github.com/timber/timber/pull/2471
• 2.x Deprecate Timber\PostClassMap filter and rename it to timber/post/classmap by @gchtr in https://github.com/timber/timber/pull/2293
• 2.x Update timber/twig/… filters by @gchtr in https://github.com/timber/timber/pull/2419
• Adds @nlemoine to the contribs list! by @jarednova in https://github.com/timber/timber/pull/2488
• 2.x improve meta field handling by @nlemoine in https://github.com/timber/timber/pull/2397
• 2.x Fix bug when page_on_front is not set in some cases by @gchtr in https://github.com/timber/timber/pull/2490
• Update compatibility checks by @nlemoine in https://github.com/timber/timber/pull/2500
• Use Timber full path by @nlemoine in https://github.com/timber/timber/pull/2497
• Integrations API by @acobster in https://github.com/timber/timber/pull/2405
• Fix transforms on file and image by @nlemoine in https://github.com/timber/timber/pull/2498
• Update integration tests: by @nlemoine in https://github.com/timber/timber/pull/2503

New Contributors

• @AlexVWeb made their first contribution in https://github.com/timber/timber/pull/2465
• @titouanmathis made their first contribution in https://github.com/timber/timber/pull/2463

Full Changelog: https://github.com/timber/timber/compare/2.0.0-alpha.2...2.0.0-alpha.4

What's Changed

• Fix bug when using switch_to_blog() in combination with Timber images by @gchtr in https://github.com/timber/timber/pull/2478
• Fix the thumbnail() method return type by @titouanmathis in https://github.com/timber/timber/pull/2463
• Merge in 2.x GH Actions changes by @jarednova in https://github.com/timber/timber/pull/2484
• Adds @nlemoine to the contribs list! by @jarednova in https://github.com/timber/timber/pull/2488
• Bump version of Upstatement/Routes to 0.8.1 by @jarednova in https://github.com/timber/timber/pull/2512

New Contributors

• @titouanmathis made their first contribution in https://github.com/timber/timber/pull/2463

Full Changelog: https://github.com/timber/timber/compare/1.19.0...1.19.1

= 1.19.0 =

Changes for Theme Developers

• You can now get dimensions of SVG images #2421 #2432 (thanks @vyskoczilova)
• You can pass additional variables to the timber/loader/loader filter #2324 (thanks @neojp)

Fixes and improvements

• Fix for double quotes that might appear in a "Read More" in Gutenberg #2337 #2343 (thanks @Keysaw)
• Fix implementation of WP's get_the_date and get_the_time filters #2350 (thanks @shvlv)
• Fix for how the wp:more tag works with noteaser #2348 #2351 (thanks @jhhazelaar)
• Fix for two cases of where home_url() should be used instead of site_url() #2356 #2357 (thanks @Levdbas)
• Fix for where Timber::get_sites returned the same locale for all sites #1908 #2369 (thanks @highbelt)
• Use the latest release of Upstatement/Routes (0.5 => 0.8) #2373 (thanks @jverneaut)
• Fix for sidebar retrieval in PHP 8 #2385 (thanks @marciojc)
• Fix for proper ignoring of the Cache directory on case-insensitive file systems #342 #2416 (thanks @toonvandeputte)

We've been at it pretty hard getting this ready for 2.0. There are just a few issues and PRs remaining before this will become the default branch. Here's a GitHub view to compare what's new in this alpha:

https://github.com/timber/timber/compare/2.0.0-alpha.1...2.0.0-alpha.2