{"active_installs":30000,"added":{"timestamp":1373328000,"timezone":"UTC"},"author":"jarednova","author_profile":{"url":"https://profiles.wordpress.org/jarednova/","alt":"jarednova"},"banners":[{"type":"high","url":"https://ps.w.org/timber-library/assets/banner-1544x500.jpg?rev=1481635"},{"type":"low","url":"https://ps.w.org/timber-library/assets/banner-772x250.jpg?rev=1481619"}],"changelog":"

1.23.4

Correct issues with faulty build script in order to implement security fix for 1.23.3

1.23.3

Fix security vulnerabilities in Twig. See GHSA-6j75-5wfj-gh66. This updates the minimum required Twig version for the plugin version of Timber to ^1.44.8 to fix the issue.

1.23.1

Fix a security vulnerability where a file processed through Timber image operations could possibly execute arbitrary code in certain circumstances. This vulnerability only exists for websites running on PHP 7.4 or lower.

1.23.0

Improve GitHub pull request template by @gchtr in https://github.com/timber/timber/pull/2641
Update bug report template and CODEOWNERS by @gchtr in https://github.com/timber/timber/pull/2711
Add Erik to Contributors List by @jarednova in https://github.com/timber/timber/pull/2735
Fix PHPDoc typo by @LogicEveryWhere in https://github.com/timber/timber/pull/2709
Add sponsorship information to Readme by @gchtr in https://github.com/timber/timber/pull/2777
doc: Add drop support notice to issue template by @nlemoine in https://github.com/timber/timber/pull/2810
Add documentation and plugin notice about the end of the plugin version by @Levdbas in https://github.com/timber/timber/pull/2800
Workflow: fix path to guide by @Levdbas in https://github.com/timber/timber/pull/2823
@LogicEveryWhere made their first contribution in https://github.com/timber/timber/pull/2709

Full Changelog: https://github.com/timber/timber/compare/1.22.1…1.23.0

1.22.1

Fixed a bug when Twig version 3 was accidentally installed when installing Timber through Composer, by @rmens in https://github.com/timber/timber/pull/2679.

1.22.0

Fixed included Twig version. In the plugin version 1.21.0 of Timber, Twig version 2.15.3 was accidentally included instead of Twig version 1.44.7.
Removed official support for PHP 8.1 in the plugin version. If you need to support PHP 8.1 in the future, please install Timber through Composer instead of installing Timber as a plugin. This will the only supported way of installing Timber when Timber version 2 will be released.
Updated minimum required WordPress version to 5.3.

1.21.0

Updated minimum required PHP version to 7.2 to make the included Twig version support PHP 8.0 and 8.1, by @gchtr in #2640.
Updated minimum Twig version to 1.44.0 to support PHP 8.0 and 8.1, by @gchtr in #2640.
Fixed support for PHP 8.0 and PHP 8.1, by @nlemoine and @gchtr in #2638, #2640.

1.20.0

Use newest version of Upstatement/routes for WordPress 6.0 by @jarednova in #2595

1.19.2

Fixes and improvements

Handle for duplicate term names in difft taxes by @jarednova in #2390
Fix typo in resize error message. by @Web-Assembler in #2523
Add webp support to letterbox filter by @ThomasBerends in #2528
Update composer/installers from v1 to v2 by @adamtomat in #2543
\n
Improve composer version ranges by @gchtr in #2550
\n
\n
@Web-Assembler made their first contribution in #2523
\n
@ThomasBerends made their first contribution in #2528
Full Changelog: https://github.com/timber/timber/compare/1.19.1…1.19.2

1.19.1

Fixes and improvements

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
\n
Bump version of Upstatement/Routes to 0.8.1 by @jarednova in https://github.com/timber/timber/pull/2512
\n
\n
@titouanmathis made their first contribution in https://github.com/timber/timber/pull/2463
\n

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)
\n
Fix for proper ignoring of the Cache directory on case-insensitive file systems #342 #2416 (thanks @toonvandeputte)
\n
\n
Fixed a bug when using switch_to_blog() in combination with Timber images #1312 #2478 (thanks @gchtr)
\n

1.18.2

Fixes and improvements

Fixes an issue where images loaded from another domain/site weren’t properly deleted from the tmp directory #2216 (thanks @oxyc)

1.18.1

Fixes and improvements

Corrects an issue where #2305 tested for arrays but not other Iterables (like Timber\\PostCollections) #2314 (thanks @nlemoine)

1.18.0

Changes for Theme Developers

Improves control over pagination stops #2302 (thanks @IJMacD)

Fixes and improvements

Fixes an error with array_filter and later versions of Twig #2305

1.17.0

Changes for Theme Developers

Adds new filter: timber/allow_fs_write to ensure compatibility with WordPress VIP and other hosts with filewrite restrictions. #2250 (thanks @mjangda)

Fixes and improvements

Add a catch so that {{ dump() }} when WP_DEBUG = FALSE doesn’t cause a fatal error #2217, #2282
Performance improvement for the deletion of transients #2281 (thanks @opengeekv2)
Fix for “More” block issue with Gutenberg #2256

1.16.0

Changes for Theme Developers
\n* Allows for translation of time_ago Twig filter #2214 #2215 (thanks @gchtr)

Fixes and improvements
\n* Fixed an issue where an excessive amount of DELETEs could hit the DB #1834 #2243 (thanks @chads2000 @dennisjac)
\n* Fix an issue with blank user names #2232 (thanks @flip111)

1.15.2

Fixes and improvements
\n* Fix error with S3 URLs and resize filters #2213 (thanks @hoangnd25)

1.15.1

Fixes and improvements
\n* Fixed an issue where null results from PostGetter::get_posts could trigger a fatal error #2199 (thanks @jhhazelaar)
\n* Removed a useless and confusing error_log message when a post_type isn’t found in a class map #2202 (thanks @gchtr)
\n* Fixed a documentation issue that gave phpStorm a bad time with query_post #2205 (thanks @mweimerskirch)

1.15.0

Fixes and improvements
\n– Fixed an issue where a custom field named “content” could conflict with {{ post.content }}
\n– Fixed an issue where Timber/User::$id was returned as a string instead of an integer (thanks @rubas)

Changes for Theme Developers
\n– Timber’s data to Apache/Nginx error logs (via error_log()) is now prefixed with [ Timber ]

1.14.0

Fixes and improvements
\n– {{ post.date }} and {{ post.time }} now use date_i18n under the hood instead of mysql2date #2104 #2126 (thanks @palmiak)
\n– WordPress 4.9.8 is the new min supported version.

Changes for Theme Developers
\n– We’re now using minimum versions of Twig 1.41 and 2.10
\n– Twig introduced a filter filter (you read that right, a filter named filter — like {{ sizes | filter(v => v > 38) }}. This wrecked havoc on our own pre-existing Timber filter filter {{ posts | filter({post_title:\"Cheese\", post_content:\"Yum!\"}, \"AND\") }}. In #2124 we gave Twig’s filter the preferred treatment. However, if the arguments look like you intend to use the old filter (which is a wrapper for WordPress’s WP_List_Util class) we use what’s there. Want to keep using the class Timber filter filter? Switch it to wp_list_filter as in {{ posts | wp_list_filter({post_title:\"Cheese\", post_content:\"Yum!\"}, \"AND\") }} (thanks @palmiak @gchtr @nlemoine @aj-adl @rubas @xdevelx and others)

1.13.0

Fixes and improvements
\n– Fix issue with debug on/off in certain installs #2084 (thanks @kmonahan)
\n– Fix link to admin pages #2112 (thanks @Beee4life)

1.12.0

Fixes and improvements
\n– Fix resizing for images with UTF-8 characters in their filename #2072
\n– Added tests to cover RTL languages and special characters in image file names #2072
\n– Fixed MenuItem menu recursion #2071 #2083

Changes for Theme Developers
\n– Added new found_posts property for Timber\\PostQuery. Now you can check how many posts were found in a query.

1.11.0

General Note
\n– If you use WPML with Timber, please upgrade to WPML 4.2.8. The WPML team has removed their included Twig version which means no more conflicts!

Fixes and improvements
\n– Fix to menu items getting incorrect classes in WPML and others #1974
\n– Fixed issue with Timber not respecting comment order #1731 #2015

Changes for Theme Developers
\n– Theme methods (theme.get and theme.display) for headers are now exposed by Timber\\Theme #2051 (thanks @dtvn)

1.10.1

Fixes and improvements
\n– Allows for a MenuItem’s Menu to be unknown #2024 #2025

1.10.0

Important Note
\nIf you use WPML, please do not upgrade to 1.10.* yet. Because WPML also uses Twig, there is a conflict with loading Twig versions. They will release an update soon to keep things in sync. Until then, please use version 1.9.2

Fixes and improvements
\n– You can now skip the eager loading of meta vars through a filter #2014 (thanks @aj-adl @gchtr)
\n– Use Twig 1.38 to prevent compatibility issues with WPML and other plug-ins
\n– This restores the prior behavior before #1813 / 1.9.3 when using Timber::get_posts. This is now controllable by devs via a filter #1989 (thanks @palmiak)
\n– Add support for non-cookied comment awaiting moderation message #1954 (thanks @codeclarified)
\n– Avoids a potential WSOD when incorrectly specifying template filenames #1984 (thanks @aj-adl)
\n– Fixes a bug introduced in #1813 that was watching for the query param of supress_filters (instead of the correct spelling: suppress_filters)
\n– Fixes a bug where the last menu item received incorrect CSS classes #2009 #1974 (thanks @strategio)

Changes for Theme Developers
\n– You can use WordPress’s behavior of get_posts (versus WP_Query) via a filter. By default, Timber uses the behaviors of WP_Query in Timber’s queries #1989 (thanks @palmiak)
\n– If you run into problems with unknown Twig_SimpleFilter or unknown Twig_Filter classes, you can use Timber\\Twig_Filter instead.
\n– Fixed Timber::get_posts so that its default query parameters mirror WordPress’s get_posts #1812 (thanks @bartvanraaij)
\n– You can now more easily work with menu locations and filters #1959 #2018 (thanks @gchtr)

1.9.5

This release was pulled due to compatibility issues with other plug-ins

1.9.4

This release was pulled due to compatibility issues with other plug-ins

1.9.3

This release was pulled due to compatibility issues with other plug-ins

1.9.2

Changes for Theme Developers
\n– You can use Timber::context() as an alias for Timber::get_context(). It’s prettier, it also will prep you for Timber 2.0 where Timber::get_context() is deprecated #1938

Fixes and improvements
\n– Integration of newest version of Upstatement/Routes which uses (newest) version 1.2.0 of AltoRouter #1946 (thanks @seanstickle)

1.9.1

Changes for Theme Developers
\n– You can now pass params to {{ user.avatar }} such as {{ user.avatar({size: 128}) }} #1730 (thanks @palmiak)

Fixes and improvements
\n– Fix for PHP 7.3 compatibility #1915 (thanks @palmiak)
\n– Fix for URLHelper::is_external for URLs without protocol #1924 (thanks @hacknug)

1.9.0

Timber now requires PHP 5.6 or greater. While Timber may work on PHP 5.5 and older versions; support will no longer be maintained in future versions.

Changes for Theme Developers
\n– Adds support for roles on the user object. Example: {{ post.author.roles }} which returns an array of roles #1898 (thanks @palmiak)
\n– Adds support for capabilities on the user object. Example: {{post.author.can(\"moderate_comments\")}} which returns true or false #1898 (thanks @palmiak)

Fixes and improvements
\n* Fix an error with handling args for nav menus #1865 (thanks @palmiak)
\n* Allowed tags won’t be stripped when automatically generating an excerpt #1886 (thanks @davefx)
\n* Fix for JPG/WEBP conversion for some older PHP installs #1854

1.8.4

Fixes and improvements
\n* Resolve potential pagination issue #1642 (thanks @gchtr)

1.8.3

Fixes and improvements
\n* Hotfix for PHP versions 5.5 and 5.4

1.8.2

Changes for Theme Developers
\n– You can now change the query parameters that are used when getting a post’s terms through $post->terms(). #1802
\n– New attributes for responsive images post.thumbnail.srcset and post.thumbnail.sizes #1819 (thanks @maxxwv)

Fixes and improvements
\n– Using WordPress’s wp_check_filetype_and_ext for the mime_type mess #1843 (thanks @gchtr)
\n– Fixed how some previewed data (when looking at an unsaved post from the admin) is handled so that parenting relationships match what happens when published #1752
\n– Timber\\Menu now respects modifications sent through WP’s wp_nav_menu_objects filter #1814 (thanks @pascalknecht)

1.8.1

Fixes and improvements
\n– Fixed how mime_type was figured out in some PHP installs #1798

1.8.0

Changes for Theme Developers
\n– Webp is now supported as a conversion format ( {{ post.thumbnail.src | towebp }} ) @mhz-tamb @pascalknecht #1638 #1777 #1780
\n– Timber now recognizes that SVGs shouldn’t be resized as if they are rasters (for retina, etc.) @palmiak #1726 #1736

Fixes and improvements
\n– Clean-up on i18n function calls @drzraf #1753
\n– Fixed some odd port handling @pascalknecht #1760
\n– Fixed how terms are retrived through a post @shvlv #1729

1.7.1

Fixes and improvements
\n– Fixes issues previewing custom fields with ACF #1712
\n– Fixes some edge cases with Menu Item classes #1709
\n– Improved efficiency of Post class instantiation #1660

1.7.0

Fixes and improvements
\n– Fixed some issues with animated gif resizing when Imagick isn’t available #1653
\n– Fixed incorrect reporting of depth level in some comments #1648
\n– Fixed issues with preview permissions #1607
\n– Fixed issue with image resize in some WPML setups #1625
\n– Fixes compatibility issues with Twig 2.4 (and later) #1641

1.6.0

Changes for Theme Developers
\n– You can now easily access all of a MenuItem’s master object properties through {{ item.master_object }} What’s a master object? It’s when a Menu Item has been created directly from a Post or Term in the WP Admin #1577 #1572
\n– Enabled methods for getting media from posts, you can now do {{ post.video }}, {{ post.audio }} and {{ post.gallery }} to retrieve media include in the body of a post #1583 (thanks @marciojc)
\n– You can now get ACF’s field object data: {{ post.field_object('my_field').key }} #1597 #1599 (thanks @palmiak)
\n– You can use the |filter filter on arrays to return items like so:
\n {% for post in posts|filter('my-slug') %} \n {{ post.title }} \n{% endfor %}
\nby default it looks for slugs, but you can also get into particular fields:
\n {% for post in posts|filter({post_title: \"Cheese\", post_content:\"Method Man\"}) %} \n {{ post.title }} \n{% endfor %}
\n… this will return posts that match both parameters. #1594 thanks @pablo-sg-pacheco

1.5.2

Fixes and improvements
\n– Fixed a bug where multi-level menus weren’t receiving proper data

1.5.1

Fixes and improvements
\n– Transparent PNGs now work with letterboxing #1554 (thanks @nlemoine)

Changes for Theme Developers
\n– You can now interact with Terms in Twig the same as PHP (ex: {% set term = Term(34, \"arts\") %}). The second arg will default to a subclass of Timber\\Term if it exists #1159 (@jarednova)
\n– You can now get {{ theme.version }} to get the theme version! #1555 (thanks @herrschuessler)

1.5.0

Fixes and improvements
\n– home_url value is now cached, performance win for polylang! #1507 (thanks @oxyc)
\n– Post::$css_class is only fetched if requested #1522 (thanks @ruscon)
\n– Improved flexibility of PostCollection to be filterable #1544 (thanks @gchtr)
\n– More test coverage

Changes for Theme Developers
\n– None! But the above fixes have significant changes in the code which necessitated the “.x” version jump

1.4.1

Fixes and improvements
\n– Fix for WPML URLs in some situations #1513 (thanks @ChrisManganaro)
\n– Fix for PHP 5.5 issue with some URLs #1518 (thanks @danFWD)

1.4.0

Fixes and Improvements
\n– Improve GIF resize performance #1495 (thanks @ahallais)
\n– Fix for get_host which could generate an unnecessary warning #1490 (thanks @ahallais)

Changes for Theme Developers
\n– Improve loader performance and logic #1476 #1489 #1491 (thanks @heino). This introduces potential changes if you were loading templates in a non-standard way and with multiple sources (ex: from a theme and plugin directory). Non-existing templates are no longer passed all the way to Twig’s render(), which currently generates an exception.

1.3.4

Fix for Twig 2.0 compatibility issue #1464 (thanks @luism-s)

1.3.3

Fix for HTTPs issues with images

1.3.2

Fix for image bug with WPML and Roots/Bedrock active #1445 (thanks @njbarrett)
Fix for some HTTPs issues #1448 (thanks @baldursson)
Improved docs! #1441 (thanks @gchtr)
Allow ACF to convert single WP_Post objects to Timber Posts #1439 (thanks @luism-s)

1.3.1

Fix for Timber::get_widgets with Twig 2.0 #1422 (thanks @gchtr)
Fix for WPML Menus #1414 (thanks @mikeyb31)
Fix for WPCLI integration #1429 #1430 (thanks @vyarmolenko)
Fix for image format processing #1421 (thanks @mgussekloo)

1.3.0

Default $context object now returns a PostQuery for $context[‘posts’] this is cool because you can use {{ posts.pagination }} in your Twig templates without any further PHP work (thanks @lggorman)
Timber\\Images with PDFs and other content types now return the file instead of null # (thanks @hoandang)
Timber\\Comments now support different comment types #1364 (thanks @yantei)
Timber\\Comments {{ comment.content }} now returns processed comment with <p> tags
Fix for HTTP error when uploading media files in Windows #1346 (thanks Matias Griese)
Fix for image resizing on alternative WP setups (thanks @gillesgoetsch)
Exposing a function to global Twig scope through Timber\\FunctionWrapper is deprecated, the preferred method to do this is through a Twig template like {{ function('my_cool_function', 'my_argument') }} (thanks @gchtr)
Fixed issues with use of Twig 2.0 (#1370)
Fixed up some things with Timber/Archives and getting post_count #1376
Don’t let Timber fail when converting TIFFs or other weird file types, instead return the passed value w/o modifying #1383
Updated FunctionWrapper with appropriate warnings and Twig 2.0 compatibility (thank you thank you @gchtr)
\nMisc fixes to documentation

1.2.4

Fixed regression from S3 handling #1330 (@gchtr)

1.2.3

Fixed a potential XSS security issue
Fixed handling of images stored on S3

1.2.2

A bunch of fixes to how images in themes are handled #1317 #1293 (@jarednova)
Fixed filter for avatar images in comments #1310 (@xavivars)
Upgrades to PHPUnit and testing suite (@jarednova)

1.2.1

Cleaned-up theme handling #1281 (thanks @xavivars)
Refactor of Pagination #1284 (thanks again @xavivars)
Fixed an error in Admin #1285 (thanks @alexanderanberg)
Fixed an issue with User->id #1283 (thanks @drumba)

1.2.0

Fixed issues with WordPress 4.7
Introduced Timber\\CommentThread object

1.1.12

Fixed Twig issue with deprecation #1265 (thanks @codesman)!
Cleaned-up the warnings for WP.org users and disabled easy updates for major/milestone versions 331314d9aaf90a52ff1c5a213656b8c02a27c60e

1.1.11

Improved flexibility for public query_vars #1250 (thanks @xavivars)
Children should inehrit publish state #1255 (thanks @motia)
Pages are sorted by their menu order instead of publish order #1251 (thanks @forgandenny)
Fixes to object caching #1259

1.1.10

Added support for Co-Authors Plus Guest Authors #1239 (thanks @motia)
Fix for Yoast SEO with multisite #1244 (thanks @alexandernanberg)
Fixes issues with basedir restrictions that arose in Timber 1.1.9 #1245

1.1.9

Timber now retrieves native term meta info #824
Added site icon support in Theme #1210
Fixes to menu getting by slug #1237 (thanks @motia)
Fix to off-site image URLs! #1234 (thanks @njbarrett)
Fix inconsistency with Post::get_terms #1222 (thanks @haroldangenent)

1.1.8

Fixed image generation when images are updated/deleted by WordPress (thanks @dudewithamood)

1.1.7.1

Quick fix for backwards compatibility in some situations

1.1.7

A new PostQuery object that comes with pagination (thanks @lggorman).
You can pass an array of post types to post.children() (thanks @njbarrett)

1.1.6

Kill those transients! Timber now wipes expired ones away 9a5851bf36110dcb399e277d51230f1addb0c53c
Fixed a warning that was annoying and nobody liked and didn’t have any friends c53b4c832cfced01157f8196688468ad3318d3fb

1.1.5

Removed change for custom loaders due to incompatability with Gantry

1.1.4

Native support for Co-Authors Plus! just use {{ post.authors }} 939331e282fd54bf3e210645964504304f2b071b
New filter to enable PW propmpt for PW protected posts (timber/post/content/show_password_form_for_protected) 0f9b20ec90b34059634c25bc27671875c18f8fcb
New filter for custom loaders (timber/loader/custom) (thanks @tnottu!) 9097984a7c3df23068056d7835465e0690338567
Fixed some updating bugs with 4.6 (thanks @daronspence) 16b8bd71571be71b298e6306abe2cd4b95d8c9e8
You can now count Query results (thanks Evan Mattson) 141624a0ac18d9dcce62a2a681134009a2b79814

1.1.3

New escapers! (thanks @matgargano) c7e8ed34da6fcd13bdc9005c04045f3a6b33595b
Fix to how categories work in Timber::get_posts 49f6007db3f829097f82ed41d389dd39053fb84a
Fix to usage of class maps in Timber::get_posts (thanks @vilpersson) b1387e443850aa021a0a70203bc20d238d4b21cb
Added Post::password_required method (thanks @marclarr) 2e685ce3d05c50e879817e51256202e032e77122
You can filter the link markup for Post::get_preview (thanks @LiljebergXYZ) b8100d7f2601b4da40bcc0a873c071b6ecf267f1

1.1.2

Fix to how post IDs are retrieved (thanks @lggorman) 798acd90ee603de2d009828127bdeaab503beb10
Fixes to pagination in search (@jarednova) 1d1ab67f124b02d8c60646f7b133abdf68cedc38
Fixes to hooks for Timber Debug Bar (@jarednova) 82a914ec0be5be1011a15c1584c2c8e2999f1c1c

1.1.1

Fixed 301 redirects for pagination (thanks @xavivars)
Added new escaping filter options for |e('wp_kses_post') and |e('esc_url')(thanks @matgargano)
Fixed pagination warning (thanks @nikola3244)
More test coverage
Fixed issue with archive limits (@jarednova)

1.1.0

Fixed how Timber loads with Composer (thanks @connorjburton and @mrgrain)
Updated docs! (thanks @lggorman and @kateboudreau)
Fixed ImageHelper paths (thanks @TuureKaunisto)
Added new filters for render (thanks @johnbillion)
Fixed issue with timestamp conversion (thanks @thedamon)
Fixed localization bugs (thanks @FlyingDR)

1.0.5

Restored prior {{ post.type }} behavior for existing custom fields (@jarednova) 6c9574912e526b8589eb134b79820c7e239a1dda
Fixed errors in PHP 7 (@FlyingDR) 48ba0fc125c2d19eeb0de0a895a83a9d3bb5a398
Misc bug fixes and upkeep (@connorjburton + @jarednova)

1.0.4

New method for {{ post.type }} this makes it easy to access things like {{post.type.labels.name}} right in Twig https://github.com/timber/timber/pull/1003
New method for {{ post.preview }} which makes it easy to customize like {{post.preview.length(50).read_more(\"Keep Reading\").end('........')}} https://github.com/timber/timber/pull/1015
Added Timber::get_term (thanks @connorjburton!) 58fe671757b30a8eb9de2589bbb817448662e121
Fix for revision issue (thanks @dknoben!) 70de6640c68a1321394aaa95202dea70e0755664
Fix for issue with uppercase file extensions (thanks @connorjburton) 5632359329894d1b95cd643470950d319628f4c6
Better handling for gifs (thanks @connorjburton) 91c40b852c056e0f096345d976767f2e5e993ce9
Fix on some old class names in there (thanks @mrgrain) 63fe60ba18c6fce5d545983334af3f752c7c2755
Pagination with post counts (thanks @lggorman) 2bcacbe50c90c7936da61d29238e3b52910a3ff9
Remove Timber::get_pids (@jarednova) 4278d11d25aaca0d60cbde32c32783dc0effac6b
Fixed deprecation in Twig (thanks @simonmilz) 6c80f1d5fd48b8fcbd335f6c8e9c6fed1b008e26
Handle ACF image arrays (thanks @connorjburton) 039be5d880fa7f9c9763f4ebd6c40863f4820e0a

1.0.3

Hot fix for PHP 5.3 error

1.0.2

Fixed possible infinite loop with Timber::get_context (thanks @connorjburton) 376928d59dd5f2dd2f389c61217530ba54e40b24
Removed bug in Term (thanks @Jmayhak) a5e3c30b9eb12acea06bc914cd6b3673ead06012
{{ user.avatar }} now returns an Image object (thanks @connorjburton) 51dd7329aee6212490daee5742280286e221f2e8
Attention Comment Form fans! {{ post.comment_form }} now gives you a friggin’ comment form 9009ac12536a0199a1bb071ac41b2e91152bef4d
Helper\\comment_form also gives you a comment form. 9009ac12536a0199a1bb071ac41b2e91152bef4d

1.0.1

{{ user.avatar }} property is now available (thanks @connorjburton) d21eb85
#947: Fix to pagination base (thanks @matsrietdijk) 270d7c2
Fix to some namespacing issues (thanks @connorjburton) 0a8346a
#958: Call the_post action to help other plugins (thanks @felthy) 4442703
#976: Fixed problem with static declaration (@jarednova) c888606
#978: Bug with arrays for post types (thanks @connorjburton) 571f6f8

1.0.0

Added {{ user }} object to context
Exposed translation functions
Added better error reporting/warnings
Fixed some things with function wrapper
Timber is now namespaced, big big thanks to @connorjburton
Cleanup of spacing
Removed deprecated functions, added warning for key functions
Updated version numbers and build script (@jarednova) 81a281e
Corrected Routes -> /Routes which threw a fatal error (@jarednova) 26b6585

0.22.6

New {{request}} object for post/get variables (thanks @connorjburton) #856
New crop positions (thanks @salaros) #861
\n
Bug Fixes
\n
\n
Fix to “next” in pagination (thanks @connorjburton) #900
\n
Fix to issue with tojpg filter’s images not being deleted (thanks @connorjburton) #897
{{post.parent.children}} used to return unpublished posts due to underlying behavior in WordPress, it now only returns published posts (thanks @connorjburton) #883

0.22.5

Fixed errors in tests (thanks @lggorman)
Fixed error in comments_link (thanks @tehlivi)

0.22.4

Fixed bug in get_calling_script file (thanks @gwagroves)
Added tons of new tests and docs (thanks @lggorman and @jarednova)

0.22.3

Fix to comment threadding (thanks @josephbergdoll)
Fixed-up conditional for when comments are being moderated (thanks @lggorman)
Fixed hooks for when attachments are deleted (thanks @lgaechter)
Added a new filter for list (thanks @lggorman)

0.22.2

New .time method for TimberPost and TimberComment (thanks @lggorman)
Added support for WordPress’s quality filter when resizing (thanks @t-wright)
Added support for animated gifs

0.22.1

Added better support for post.get_terms (thanks @aaemnnosttv)
Fix for issue with ACF date field (thanks @rpkoller)
Fix for resizing jpEgs (thanks @eaton)

0.22.0

Added fetch method to Timber (thanks @xavivars and @erik-landvall)
Added a total to the pagination data array (thanks @lggorman)
Threaded comments get some love! (thanks @josephbergdoll)
A fix to date parsing when handling numeric timestamps (thanks @xavivars)

0.21.10

Removed deprecated twitterify function
Much more docs (and deprecation docs)
Fixed issues with using constants (thanks @xavivars)

0.21.9

Much much much more inline docs
Fix to TimberComment::approved()
HHVM support confirmed (it always worked, but now the tests prove it)
Fixes to multisite handling of themes
Fix to comments pagination (thanks @newkind)

0.21.8

Fixes to things in docs
Added ID to timber/image/src filter (thanks @aaronhippie)
Fixed edgecase with HTTP_HOST vs SERVER_NAME (thanks @maketimetodesign)

0.21.7

Fix for Image src in some situtations

0.21.6

Fix for TimberMenu visiblility
Fix for TimberComment visibility

0.21.5

Patch for method property visibility in TimberPost

0.21.4

Fixed issue with multisite variables
Fixed issue with string conversion on function output

0.21.3

Fixed issues with static post pages
Fixed issues with front pages with static pages

0.21.2

Fixed GIF handling (thanks @josephbergdoll and @jarednova)
Improved handling of diff’t image sizes
Timber Archives are now tested and much improved (thanks @KLVTZ)
Image fixing (thanks @marciojcoelho)
More tests and improving coverage to 77%

0.21.1

Fixed capitalization problem for WP.org version

0.21.0

Routes is now its own independent repo
Timber Starter Theme is now its own independent repo
Improved loading of files (thanks @mgmartel)
Fixed some errors with TimberImages (thanks @imranismail)

0.20.10

Resolved lingering composer issues (thanks @austinpray, @lucasmichot)
You can now access {{comment.status}} when working with comments (thanks @simonmilz)
Better support for alternate setups with uploads directory (thanks @xavierpriour)
Major clean-up of image-handling classes (thanks @xavierpriour)
Starter theme now follows WP coding standards (thanks @kuus)
A slew of other bugs and clean-up (thanks @JeyKeu, @quinn and @jaredNova)

0.20.9

Twig goes from 1.6.2 to 1.6.3 (thanks @fabpot)
Some clean-up items on Menus (thanks @oskarrough)
Simplified composer installation (thanks @lucasmichot)

0.20.8

Fixed some Twig deprecation (thanks @alexlrobertson)
Support for {{img.src|retina}} filter (@jarednova)

0.20.7

Cleaned-up logic for {{post.next}} and {{post.prev}} (thanks @alexlrobertson)
Simplifiying internals of TimberCore, TimberPost (thanks @alexlrobertson)
Initialization of variables from stolen WP functions (thanks @alexlrobertson)
Fixed Twitter API call (thanks @asecondwill)
Matched TimberMenu fallback behavior to grab pages_men (@jaredNova)
Fixed a bug with the_title filter (thanks @kuus)
Fixed weird conflicts when ACF names match methods (@jaredNova)
Added a filter for timber_output (thanks @aristath)
Fix for galleries showing only 5 images (thanks @IJMacD)

0.20.6

Fixed some resulting bugs from numberposts vs. posts_per_page change as relates to galleries (thanks @IJMacD)
Fixed issue with author.php in starter theme (thanks @dmtroyer)
Added some sanity checks when menus are missing (thanks @jaredNova)
New tests, yay!

0.20.5

Fixed issue with sticky posts being included when just feeding an array of ids
Fix for pagination links with search terms (thanks @matthewsoares)

0.20.4

Fixed issue with Timber::get_posts and Timber::query_posts using numberposts in args

0.20.3

Fixed some issues with linking to menu items with a hash

0.20.2

Change default response code on load_view to be 200
Fixed error with relpath and subdomains (thanks @jnweaver)
Various bug fixes (thanks @andyford, @discern)

0.20.1

Hotfix to ensure non-exitent properties don’t throw exception (thanks @kylehotchkiss)

0.20.0

Iterators! You can now get data using query_posts which hooks into WP loop. Methods like get_the_title() now work (big thanks to @mgmartel)
Fixed img_to_jpg issue with alternate WP setups (@thetmkay)
Fixed issue with links in TimberMenuItem
post.date now supports a DateTime object (@aduth)
removal of long-since deprecated functions
Massive code clean-up and bug fixes (@jaredNova, @mgmartel)

0.19.2

Fixed issue with {{post.author.name}}
Bug fixes and code organization (@hsz, @jaredNova)

0.19.1

Removed .git folder hiding in php-router
Added support for WooCommerce and other plugins in starter theme (thanks @jamesagreenleaf)
Starter theme now based on OO-style TimberSite convention
You can not get the modified_author (thanks @jamesagreenleaf)
…oh and the modified date (thanks @jamesagreenleaf)
Code clean-up like mad (thanks @hsz)
Fixed bug when calling Timber::get_posts in loop (thanks @jamesagreenleaf)

0.19.0

Reorganized dependencies into /vendor directories based on composer (thanks @mgmartel, @rarst, @bryanaka)
Fixed issues with image library deletion (thanks @thetmkay)
Fixed issues with sidebar output

0.18.1

Dates now use date_i18n filter (thanks @jamesagreenleaf)
The twig |date filter now defaults to your WP Admin settings (thanks @jamesagreenleaf)
You can send Timber::$dirname an array to specify multiple locations of twig files within a theme
Load views from anywhere on the server (thanks @th3fallen)
Load twig files from anywhere on the server using an absolute path
Use another version of Twig if you have it loaded (thanks @ButlerPCnet)
more tests!

0.18.0

BREAKING CHANGE ALERT wp_title no longer appends bloginfo(‘name’) to end of string (thanks @aduth)
BREAKING CHANGE ALERT get_preview now respects tag (thanks @jnweaver)
TimberHelper::transient is more reliable …

\n","contributors":[{"slug":"jarednova","name":"jarednova","count":6,"is_owner":true,"links":{"profile":{"url":"https://profiles.wordpress.org/jarednova/","alt":"jarednova's profile"},"plugins":{"url":"https://profiles.wordpress.org/jarednova/#content-plugins","alt":"jarednova's plugins"},"activity":{"url":"https://profiles.wordpress.org/jarednova/#content-activity","alt":"jarednova's activity"},"translations":{"url":"https://profiles.wordpress.org/jarednova/#content-translations","alt":"jarednova's translations"}}},{"slug":"jarednova","name":"jarednova","count":1,"is_owner":false,"links":{"profile":{"url":"https://profiles.wordpress.org/jarednova/","alt":"jarednova's profile"},"plugins":{"url":"https://profiles.wordpress.org/jarednova/#content-plugins","alt":"jarednova's plugins"},"activity":{"url":"https://profiles.wordpress.org/jarednova/#content-activity","alt":"jarednova's activity"},"translations":{"url":"https://profiles.wordpress.org/jarednova/#content-translations","alt":"jarednova's translations"}}}],"description":"

With the upcoming release of Timber 2.0, we will not release a 2.0 version and beyond as a plugin, but only as a Composer package. We advise everyone to switch to the Composer based install as soon as possible.
\nYou will find an extensive list with guides and the reasons why we are not going to release Timber 2.0 as a plugin anymore.

Switching to the Composer based version

Announcement: Dropping support for the plugin version of Timber
Guide: How do I switch over from the plugin version to the Composer based version of Timber?
Backstory: Why we are dropping support for the plugin in the first place
GitHub issue: Roadmap for Timber 2.0

Timber helps you create fully-customized WordPress themes faster with more sustainable code. With Timber, you write your HTML using the Twig Template Engine separate from your PHP files. This cleans up your theme code so, for example, your PHP file can focus on being the data/logic, while your Twig file can focus 100% on the HTML and display.

Once Timber is installed and activated in your plugin directory, it gives any WordPress theme the ability to take advantage of the power of Twig and other Timber features.

Want to learn more?

Project Page
Timber on GitHub

Looking for Documentation?

Timber Documentation
Twig Reference (from SensioLabs)
\nTwig is the template language powering Timber; if you need a little background on what a template language is, Twig’s homepage has an overview
Video Tutorials
Overview / Getting Started Guide

Need support?

StackOverflow is for usage questions and troubleshooting
GitHub issues are for reporting bugs and errors

Support

Please post on StackOverflow under the “Timber” tag. Please use GitHub issues only for specific bugs, feature requests and other types of issues.

\n","downloaded":1445784,"faq":"\n

\nCan it be used in an existing theme?\n\n

You bet! Watch these Video Tutorials to see how.

\nIs it used in production?\n\n

Tens of thousands of sites now use Timber. You can check some of them out in the Showcase.

\nDoesn’t this all make WordPress harder since there’s more to learn?\n\n

Does jQuery make JavaScript harder? Yes, it’s an extra piece to learn — but it super-charges your ability to write unencumbered JavaScript (and prevents you from having to learn lots of the messy internals). If your answer is “jQuery sucks and everyone should learn how to write vanilla JavaScript or they’re rotten stupid people,” this tool isn’t for you.

\nOh, Timber is simple code so it’s for making simple themes\n\n

Whatever. It simplifies the silly stuff so that you can focus on building more complicated sites and apps. jQuery simplifies Javascript, but you can still use the full range of JavaScript’s abilities.

\nWill you support it?\n\n

At Upstatement we’re using it in dozens of sites (and many more planned) — thousands of other developers are using it too. This isn’t going anywhere. Twig is the chosen language for other PHP platforms like Symfony, Drupal 8 and Craft.

\n\n","homepage":"https://upstatement.com/timber","icons":[{"type":"1x","url":"https://ps.w.org/timber-library/assets/icon-128x128.png?rev=1482055"},{"type":"2x","url":"https://ps.w.org/timber-library/assets/icon-256x256.png?rev=1482054"}],"installation":"

Activate the plugin through the ‘Plugins’ menu in WordPress
\n
For an example, try modifying your home.php or index.php with something like this:
\n
$context = array();
\n$context[‘message’] = ‘Hello Timber!’;
\nTimber::render( ‘welcome.twig’, $context );
\n

Then create a subdirectory called views in your theme folder. Then create a file views/welcome.twig with these contents:

<div class=\"welcome\">\n    <h3>{{ message }}</h3>\n</div>\n

When you visit this page, you’ll see both the data from PHP come through as you’ve marked it up. For more, continue with the official Getting Started Guide

\n","internal_ranking":0,"languages":[{"slug":"es_ES","label":"Spanish (Spain)","count":32360},{"slug":"nl_NL","label":"Dutch","count":30206},{"slug":"ru_RU","label":"Russian","count":27196},{"slug":"fr_FR","label":"French (France)","count":20849},{"slug":"es_VE","label":"Spanish (Venezuela)","count":17048},{"slug":"sv_SE","label":"Swedish","count":14890},{"slug":"ja","label":"Japanese","count":14019},{"slug":"es_CO","label":"Spanish (Colombia)","count":13464},{"slug":"es_MX","label":"Spanish (Mexico)","count":13287},{"slug":"pt_BR","label":"Portuguese (Brazil)","count":13276},{"slug":"nl_BE","label":"Dutch (Belgium)","count":10363},{"slug":"es_CL","label":"Spanish (Chile)","count":8024}],"last_seen":{"timestamp":1764398396.495,"timezone":"UTC"},"last_updated":{"timestamp":1748722020,"timezone":"UTC"},"last_wordpress_compatible_version":"6.8.3","latest_num_ratings":10,"latest_rating":4.5,"latest_ratings":{"1":0,"2":1,"3":1,"4":0,"5":8,"links":{"1":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=1","alt":"View all 0 one star reviews"},"2":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=2","alt":"View all 1 two star reviews"},"3":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=3","alt":"View all 1 three star reviews"},"4":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=4","alt":"View all 0 four star reviews"},"5":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=5","alt":"View all 8 five star reviews"},"all":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/","alt":"View all 10 reviews"}}},"minimum_php_version":"7.2.5","minimum_wordpress_version":"5.3.0","name":"Timber","num_ratings":71,"pluginid":"timber-library","rating":4.9,"ratings":{"1":0,"2":2,"3":1,"4":1,"5":67,"links":{"1":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=1","alt":"View all 0 one star reviews"},"2":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=2","alt":"View all 2 two star reviews"},"3":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=3","alt":"View all 1 three star reviews"},"4":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=4","alt":"View all 1 four star reviews"},"5":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/?filter=5","alt":"View all 67 five star reviews"},"all":{"url":"https://wordpress.org/support/plugin/timber-library/reviews/","alt":"View all 71 reviews"}}},"reviews":[{"reviewer":"thaikolja","title":"My new WordPress base","content":"Thanks for this awesome plugin! I'm super glad that I've found it. Timber is the bridge between WordPress and Twig. Designing themes with Twig and Timber's great support of most WordPress features is just a breeze.\n\nPlease keep developing this, maybe work on the translation feature (I can't find a way to use gettext for __ calls that are inside HTML elements, for example in title=\"{{ __() \" }}).\n\nTimber Library is now a fundamental part of my WordPress development work, and I don't want to miss it.","rating":0.25,"created":{"timestamp":1565568000,"timezone":"UTC"}},{"reviewer":"Karolina Vyskocilova","title":"Speeds up the HTML to WP so much!","content":"Hi, thanks for such a great plugin. It speeds up development so much and code is finally clean. No more PHP & HTML together in a very messy way!\n\nKarolina","rating":0.25,"created":{"timestamp":1567468800,"timezone":"UTC"}},{"reviewer":"Nerds Farm","title":"WOW","content":"Full integration and perfect documentation!\nThanks for your hard works!","rating":0.25,"created":{"timestamp":1606867200,"timezone":"UTC"}}],"screenshots":"

$\"This$
This what a normal WordPress PHP file looks like
$\"With$
With Timber, you write Twig files that are super-clear and HTML-centric.

","short_description":"Helps you create themes faster with sustainable code. With Timber, you write HTML using Twig Templates http://www.upstatement.com/timber/","support_threads":0,"support_threads_resolved":0,"tags":[{"slug":"templates","label":"templates","count":171},{"slug":"twig","label":"twig","count":13},{"slug":"template-engine","label":"template engine","count":3}],"tags_count":187,"languages_count":214982,"age_days":4557.558660340081,"installs_per_rating":422.53521126760563,"downloads_per_rating":20363.154929577464,"installs_per_day":6.582471501916209,"downloads_per_day":317.2277325975475,"reviews_per_day":0.015578515887868362,"activation_rate":0.02074998755000747,"version":"1.23.4","marketplace":"wordpress","marketplace_url":"https://wordpress.org/plugins/timber-library","price":null,"wordpress_link":{"alt":"WordPress","url":"https://wordpress.org/plugins/timber-library"}}

WP Autoload vs Timber