説明
Timber なら長期利用でき可搬性の高いコードで、あなたのWordPressテーマの完全なカスタマイズの作成を手早くもたらします。Timberなら、HTMLをTwig テンプレートエンジンを使って記述でき、PHPファイルと分離することができます。このことはテーマのコードをクリーンにして、たとえばPHPファイルはデータやシステムロジックに集中し、Twigのほうは100%HTMLや表示にだけ集中するようにできます。
プラグインディレクトリに Timber をインストールして有効化すれば、すべてのWordPress テーマにて Twig のパワーと他の Timber の機能を利用できるようになります。
詳しく知りたいですか ?
ドキュメンテーションをお探しですか ?
- Timber ドキュメンテーション
- Twig リファレンス (SensioLabsより)
Twig は Timber の中核となるテンプレート言語です。もしテンプレートエンジンとは何なのか基礎知識が必要ならTwig サイト上に概要があります (英語) - 動画チュートリアル
- 概要 / はじめの手引き
サポートが必要ですか ?
- 質問やトラブルシューティングは StackOverflow へ
- バグ・エラーの報告は GitHub issues へ
サポート
StackOverflow “Timber” タグ以下にて投稿してください。そのほかの機能追加の要望やバグの問題に関してだけGitHub issuesを使ってください。
インストール
- WordPress の「プラグイン」メニューからプラグインを有効化してください
-
例として、
home.php
か、index.php
を以下のようにして少し変更してみてください。$context = array();
$context[‘message’] = ‘Timberで出来たよ!’;
Timber::render( ‘welcome.twig’, $context );
つづいてサブディレクトリ views
を作成し、あなたのテーマフォルダーに置きます。ここにファイル views/welcome.twig
を次のような内容で作成します:
<div class="welcome">
<h3>{{ message }}</h3>
</div>
このページを開くと、あなたのマークアップした PHP から来るデータと両方が見えるでしょう。さらに先は、公式のはじめの手引きに続きます。
FAQ
-
実在するテーマで使用されることがありますか ?
-
どうか一度お試しを ! これら動画チュートリアルで どうすればいいのか見られます。
-
これは本番環境用ですか ?
-
何万ものサイトが現在 Timber をして使用しています。そのうちの いくつかは
ショーケースにて ご覧いただけます。 -
これは全て WordPress を難しくしていませんか ? 学ぶことがたくさんあって。
-
jQuery が JavaScript を難しくした ? 確かに、いくらかの追加で学習することがあります。— が、これはあなたの能力を一気に加速して煩雑な JavaScript を書かなくてよくなります (内部的なごちゃごちゃした多くの部分を学ばなくてはいけないことを防ぎます) 。もしあなたの考えが「 jQuery は酷くて、すべての人が生のままの JavaScript を書くことを学ぶべきなのに、愚かな人たちはそうならずに腐ってしまう」というものであれば、このツールはあなたには適さないかもしれません。
-
なんと Timber はシンプルなコードで、テーマをシンプルにしてくれるんでしょう
-
なんにでも。無駄な残骸をそぎ落とし、もっと手の込んだサイトやアプリを作成することに集中できるようにします。jQuery は Javascript を簡略化しますが、すべての範囲の JavaScript の能力を使い続けられるようなものです。
-
それをサポートしますか ?
-
Upstatement (主張) において、私たちは何ダースものサイト群にてこれを使用 (またさらに使用を計画) しています。– 何千もの他のデベロッパーも同じです。これはどこにも行きません。Twig は Symfony や、Drupal 8、Craft のような他の PHP プラットフォームでも採用されている言語です。
評価
貢献者と開発者
変更履歴
Develop (next release)
Changes for Theme Developers
Fixes and improvements
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
-
Improve composer version ranges by @gchtr in #2550
-
@Web-Assembler made their first contribution in #2523
- @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
-
Bump version of Upstatement/Routes to 0.8.1 by @jarednova in https://github.com/timber/timber/pull/2512
-
@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
andget_the_time
filters #2350 (thanks @shvlv) - Fix for how the
wp:more
tag works withnoteaser
#2348 #2351 (thanks @jhhazelaar) - Fix for two cases of where
home_url()
should be used instead ofsite_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)
-
Fixed a bug when using
switch_to_blog()
in combination with Timber images #1312 #2478 (thanks @gchtr)
1.18.2
Fixes and improvements
- 不具合#2216の修正。他のサイトからロードされた画像がtmpディレクトリから削除されない件 (thanks @oxyc)
1.18.1
Fixes and improvements
- 不具合#2305の修正。配列以外の列挙可能型(Iterable)が検査されない(
Timber\PostCollection
など) #2314 (thanks @nlemoine)
1.18.0
Changes for Theme Developers
- Improves control over pagination stops #2302 (thanks @IJMacD)
Fixes and improvements
- #2305エラーの修正。array_filterと後のバージョンのTwigにておこる問題
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
* Allows for translation of time_ago Twig filter #2214 #2215 (thanks @gchtr)
Fixes and improvements
* Fixed an issue where an excessive amount of DELETEs could hit the DB #1834 #2243 (thanks @chads2000 @dennisjac)
* Fix an issue with blank user names #2232 (thanks @flip111)
1.15.2
Fixes and improvements
* Fix error with S3 URLs and resize filters #2213 (thanks @hoangnd25)
1.15.1
Fixes and improvements
* Fixed an issue where null results from PostGetter::get_posts
could trigger a fatal error #2199 (thanks @jhhazelaar)
* Removed a useless and confusing error_log message when a post_type
isn’t found in a class map #2202 (thanks @gchtr)
* Fixed a documentation issue that gave phpStorm a bad time with query_post
#2205 (thanks @mweimerskirch)
1.15.0
Fixes and improvements
– Fixed an issue where a custom field named “content” could conflict with {{ post.content }}
– Fixed an issue where Timber/User::$id
was returned as a string instead of an integer (thanks @rubas)
Changes for Theme Developers
– Timber’s data to Apache/Nginx error logs (via error_log()
) is now prefixed with [ Timber ]
1.14.0
Fixes and improvements
– {{ post.date }} and {{ post.time }} now use date_i18n
under the hood instead of mysql2date
#2104 #2126 (thanks @palmiak)
– WordPress 4.9.8 is the new min supported version.
Changes for Theme Developers
– We’re now using minimum versions of Twig 1.41 and 2.10
– 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
– Fix issue with debug on/off in certain installs #2084 (thanks @kmonahan)
– Fix link to admin pages #2112 (thanks @Beee4life)
1.12.0
Fixes and improvements
– Fix resizing for images with UTF-8 characters in their filename #2072
– Added tests to cover RTL languages and special characters in image file names #2072
– Fixed MenuItem menu recursion #2071 #2083
Changes for Theme Developers
– 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
– 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
– Fix to menu items getting incorrect classes in WPML and others #1974
– Fixed issue with Timber not respecting comment order #1731 #2015
Changes for Theme Developers
– Theme methods (theme.get and theme.display) for headers are now exposed by Timber\Theme #2051 (thanks @dtvn)
1.10.1
Fixes and improvements
– Allows for a MenuItem’s Menu to be unknown #2024 #2025
1.10.0
Important Note
If 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
– You can now skip the eager loading of meta vars through a filter #2014 (thanks @aj-adl @gchtr)
– Use Twig 1.38 to prevent compatibility issues with WPML and other plug-ins
– 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)
– Add support for non-cookied comment awaiting moderation message #1954 (thanks @codeclarified)
– Avoids a potential WSOD when incorrectly specifying template filenames #1984 (thanks @aj-adl)
– Fixes a bug introduced in #1813 that was watching for the query param of supress_filters
(instead of the correct spelling: suppress_filters
)
– Fixes a bug where the last menu item received incorrect CSS classes #2009 #1974 (thanks @strategio)
Changes for Theme Developers
– 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)
– If you run into problems with unknown Twig_SimpleFilter
or unknown Twig_Filter
classes, you can use Timber\Twig_Filter
instead.
– Fixed Timber::get_posts
so that its default query parameters mirror WordPress’s get_posts
#1812 (thanks @bartvanraaij)
– 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
– 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
– 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
– You can now pass params to {{ user.avatar }}
such as {{ user.avatar({size: 128}) }}
#1730 (thanks @palmiak)
Fixes and improvements
– Fix for PHP 7.3 compatibility #1915 (thanks @palmiak)
– Fix for URLHelper::is_external for URLs without protocol #1924 (thanks @hacknug)
1.9.0
Timberは現在PHP 5.6 またはそれ以上を必要とします。Timber は PHP 5.5 やもっと古いバージョンでも動くかもしれませんが、将来のバージョンではサポートはなくなります。
Changes for Theme Developers
– Adds support for roles on the user object. Example: {{ post.author.roles }}
which returns an array of roles #1898 (thanks @palmiak)
– 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
* Fix an error with handling args for nav menus #1865 (thanks @palmiak)
* Allowed tags won’t be stripped when automatically generating an excerpt #1886 (thanks @davefx)
* Fix for JPG/WEBP conversion for some older PHP installs #1854
1.8.4
Fixes and improvements
* Resolve potential pagination issue #1642 (thanks @gchtr)
1.8.3
Fixes and improvements
* Hotfix for PHP versions 5.5 and 5.4
1.8.2
Changes for Theme Developers
– You can now change the query parameters that are used when getting a post’s terms through $post->terms()
. #1802
– New attributes for responsive images post.thumbnail.srcset
and post.thumbnail.sizes
#1819 (thanks @maxxwv)
Fixes and improvements
– Using WordPress’s wp_check_filetype_and_ext
for the mime_type mess #1843 (thanks @gchtr)
– 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
– Timber\Menu now respects modifications sent through WP’s wp_nav_menu_objects
filter #1814 (thanks @pascalknecht)
1.8.1
Fixes and improvements
– Fixed how mime_type was figured out in some PHP installs #1798
1.8.0
Changes for Theme Developers
– Webp is now supported as a conversion format ( {{ post.thumbnail.src | towebp }}
) @mhz-tamb @pascalknecht #1638 #1777 #1780
– Timber now recognizes that SVGs shouldn’t be resized as if they are rasters (for retina, etc.) @palmiak #1726 #1736
Fixes and improvements
– Clean-up on i18n function calls @drzraf #1753
– Fixed some odd port handling @pascalknecht #1760
– Fixed how terms are retrived through a post @shvlv #1729
1.7.1
Fixes and improvements
– Fixes issues previewing custom fields with ACF #1712
– Fixes some edge cases with Menu Item classes #1709
– Improved efficiency of Post class instantiation #1660
1.7.0
Fixes and improvements
– Fixed some issues with animated gif resizing when Imagick isn’t available #1653
– Fixed incorrect reporting of depth level in some comments #1648
– Fixed issues with preview permissions #1607
– Fixed issue with image resize in some WPML setups #1625
– Fixes compatibility issues with Twig 2.4 (and later) #1641
1.6.0
Changes for Theme Developers
– 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
– 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)
– You can now get ACF’s field object data: {{ post.field_object('my_field').key }}
#1597 #1599 (thanks @palmiak)
– You can use the |filter
filter on arrays to return items like so:
{% for post in posts|filter('my-slug') %}
{{ post.title }}
{% endfor %}
by default it looks for slugs, but you can also get into particular fields:
{% for post in posts|filter({post_title: "Cheese", post_content:"Method Man"}) %}
{{ post.title }}
{% endfor %}
… this will return posts that match both parameters. #1594 thanks @pablo-sg-pacheco
1.5.2
Fixes and improvements
– Fixed a bug where multi-level menus weren’t receiving proper data
1.5.1
Fixes and improvements
– Transparent PNGs now work with letterboxing #1554 (thanks @nlemoine)
Changes for Theme Developers
– 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)
– You can now get {{ theme.version }} to get the theme version! #1555 (thanks @herrschuessler)
1.5.0
Fixes and improvements
– home_url
value is now cached, performance win for polylang! #1507 (thanks @oxyc)
– Post::$css_class is only fetched if requested #1522 (thanks @ruscon)
– Improved flexibility of PostCollection to be filterable #1544 (thanks @gchtr)
– More test coverage
Changes for Theme Developers
– None! But the above fixes have significant changes in the code which necessitated the “.x” version jump
1.4.1
Fixes and improvements
– Fix for WPML URLs in some situations #1513 (thanks @ChrisManganaro)
– Fix for PHP 5.5 issue with some URLs #1518 (thanks @danFWD)
1.4.0
Fixes and Improvements
– Improve GIF resize performance #1495 (thanks @ahallais)
– Fix for get_host which could generate an unnecessary warning #1490 (thanks @ahallais)
Changes for Theme Developers
– 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)
Misc 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
-
Bug Fixes
-
Fix to “next” in pagination (thanks @connorjburton) #900
- 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 (thanks @mgmartel)
- Secure urls in TimberImage if current page is served over SSL (thanks @mgmartel)
- Re-wrote most of letterboxing functionality
- Re-organized Helper functions
0.17.2
- TimberPost::children() now sorts by menu_order, title as WordPress core does (thanks @aduth)
- Fixed an occaisonal warning (thanks @matthewsoares)
- TimberImage::alt() now returns your image’s alt tag info from WordPress (thanks @jnweaver)
- In the router, non-404 headers are forced asap (thanks @mgmartel)
- Router now accepts + signs in paths
0.17.1
- Hotfix on timber-admin error
0.17.0
- Now you can resize/crop images with positional preferences, thanks @mmikkel. Here are the docs: https://github.com/timber/timber/wiki/TimberImage#resize
- Removed the Timber Starter Guide from the admin, a link to the GitHub wiki suffices.
0.16.8
- You can now retrieve prev/next posts within the same category (post.next(‘category’).title, etc.). (thanks @slimndap)
- Fixed issue with letterboxing images when WP is installed in a subdirectory ( @wesrice)
- Fix for images stored inside custom content path (@mmikkel)
- Cleaned-up some things in Timber Starter theme (@southernfriedbb, @jarednova)
0.16.7
- Fixed issue with image heights on external images (thanks @AndrewDuthie)
- Added new filter for timber_compile_result (thanks @parisholley)
- Other minor fixes (@jarednova)
0.16.6
- Router plays nice with installs in subdirectories (thanks @TerminalPixel)
- ACF Timber now initializes on Init (thanks @Zerek)
- Composer is updated (thanks @Rarst)
- $autoescape bug fixed (thanks @ParisHolley)
- You can now select a term ID from a specific taxonomy (thanks @mgmartel)
- added stripshortcodes filter
- TimberMenuItems now have is_external method
- Other misc bugs
0.16.5
- print_a lives! added methods for TimberPost
- quick fix on TimberPost::content which was generating warning
0.16.4
- Fixed a few things on image handling
- Updated to Twig 1.15 (thanks @fabpot)
- Added wp_link_pages as TimberPost::pagination
- New filter to help with template selection (thanks @zlove)
0.16.3
- Added width, height and aspect methods for TimberImages
- Timber::pagination can now accept a single integer as the overall “size” argument (for the total number of pages that get shown)
- TimberPost->class (usage:
<article class="{{post.class}}"
>) will now show you the products of post_class - Sanity checks for ACF (thanks @parisholley)
- Fixed bug in TimberPost::prev and TimberPost::next that could return draft posts (thanks @slimndap)
- Fixed bug with extra ellipsis in some previews (thanks @parisholley)
0.16.2
- Added has_term to TimberPost
- Extra checks to make sure redirected links don’t get 404 body class
- Misc bugs
0.16.1
- Bug fix on ugly permalinks for pagination
- Fixed issue where posts retrieved via an array of IDs was truncated at the default post count
- Fixed issue where loading terms from multi taxonomies (thanks @WL-hohoho)
- Added support for post_class on TimberPost (thanks @slimndap)
- new
array
filter to convert single-values into array in twig - Cleaned-up and added translation support to
time_ago
filter (thanks @WL-hohoho)
0.16.0
- TimberTheme is now available in default context as .theme
- Post meta now respects arrays (watch out for some possible compatiblity issues here)
- Template loads now work for parent/child themes in Windows (thanks @matthewsoares)
- Better method for removing 404 body class on manual redirects (thanks @mgmartel)
0.15.5
- Post formats: {{post.format}} !
0.15.4
- More improvements to filters to support external integration with Pods and other WP frameworks
- Fixed bug on date internationalization (thanks @slimndap)
- Fixed bug on using existing image sizes (thanks @matthewsoares)
- Fixed bug on homeurl vs siteurl (thanks @ciarand)
- Added a cache lock to the TimberHelper::transient method
- Added an in-development version of a TimberArchives object
0.15.3
- Upgrayedd to Twig 1.14.2
- Added composer integration
- Bunch of new tests
- Comments now support gravatrs (thanks @asecondwill)
- Moved ACF integration into its own file. It now interacts via hooks instead of in-line
- A few misc. bugs and extra sanity checks
0.15.2
- TimberImages now support alternate sizes
0.15.1
- Fix on revered prev/next post links
0.15.0
- Cacheing!!!
- Cacheing!!
- Cacheing!!!! Timber::render(‘mytemplate.twig’, $data, $expires_time_in_secs);
- Timber::render now automatically echos. Don’t want it to? See below…
- New Timber::compile method which doesn’t automatically echo. (Same args as Timber::render)
- Added post.get_next / post.get_prev for TimberPosts
- Fixed a thing to make get_preview easier when you want to omit the ‘Read More’ link
- Read the Full Release Notes
0.14.1
- Added hooks to play nicely with Timber Debug Bar
- Fixed-up Timber Term aliases, link, path, etc.
- Add DB queries now get properly prepared
- Supports custom author permalinks
- Simplified TimberPost processing; shaved some processing time off
0.14.0
- More flexiblity for custom routes (thanks @mgmartel)
- Added filters for core objects (TimberPost and TimberTerm). This greatly helps when you need to have retrived custom fields or repeaters interprted as posts or terms
- Renamed “WPHelper” to more namespace-friendly “TimberHelper”
- Added function_wrapper helper to execute functions where they are placed in the template as opposed to when they are generated (@mgmartel)
- You can now have custom fields processed via post.get_field(‘my_custom_field’). This is a huge help for using things like Advanced Custom Fields’ repeater.
- Performance improvements
0.13.5
- Added comprehensive support for actions and filters (thanks @mgmartel)
- Rewrote routing to template to be 100% harmonious with WordPress (thanks again @mgmartel)
- Fix to some pagination errors when using a custom rewrite on a taxonomy (thanks to @kylehotchkiss)
- Fixed issue with stripping the ellipses on a preview (thanks to @bryanscode)
- Functions now work more logically, example: {{function(‘my_special_function’, ‘arg1’)}}
0.13.0
- TimberMenuItems now get the WP classes you’ve come to know and love (.current-menu-item, etc.)
- More test coverage for images
- Resizing external images converts the URL into a md5 hash
- Removed a dangerous backtrace that could overload errorlog
- Some object caching on TimberPost->get_terms to improve performance
0.12.2
- TimberMenus now contain metadata ‘bout the menu (thanks @bryanaka)
- Fixed issue with Windows servers (thanks @kzykhys)
- Resizing external images now incl. the full URL to avoid conflicts
- Fixed pagination oddity
- Some code cleanup stuff.
0.12.1
- A few fixes that catch issues with absolute vs. relative URLs in resize
0.12.0
- Pagination is re-factored to be more intuitive, and well, better.
- Resize is also re-factored to respect absolute vs. relative URLs
- Got rid of lots of old, bogus code.
0.11.0
- fixed load order of views so files inside of the child theme have priority over the parent theme.
- comment ordering respects the default set in WordPress
- added getting started screen
- misc bug fixes
- removed lots of old garbage, simplified file organization
- contributors for this release: @ysurian, @thisislawatts, @punkshui and @paulwilde
0.10.7
- more normalization of menus, users
- fixed bug in post.get_content (thanks @paulwilde)
- fixed bug in way menu items with children got their children (thanks @EloB)
0.10.6
- more normalization of comments
- Lots of cleanup of starter theme
0.10.5
- added theme URI to universal context
0.10.4
- Lots of code cleanup thanks to Jakub
- Added new function for bloginfo
- You can now hook into timber_context to filter the $context object
- Added Timber::get_terms to retrieve lists of your blog’s terms
- Added better support for translation
- Added filter for executing a function, ie {{‘my_theme_function’|filter}}
0.10.3
- Corrected error with sidebar retrieval
- language_attributes are now available as part of Timber::get_context(); payload.
- Upgraded to Twig 1.13.1
0.10.2
- added more aliases for easier coding (post.thumbnail instead of post.get_thumbnail, etc.)
- Garbage removal
0.10.1
- load_template for routing can now accept a query argument
- load_template will wait to load a template so that ‘init’ actions can fire.
- way more inline documentation
- print_a now includes the output of (most) methods in addition to properties.
- added lots of aliases so that things like .author will work the same as .get_author