[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-8324":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":15,"starSnapshotCount":15,"syncStatus":16,"lastSyncTime":32,"discoverSource":33},8324,"timber","timber\u002Ftimber","Create WordPress themes with beautiful OOP code and the Twig Template Engine","https:\u002F\u002Ftimber.github.io\u002Fdocs\u002F",null,"PHP",5651,507,120,29,0,2,5,39.12,"MIT License",false,"2.x",true,[24,25,5,26,27,28],"hactoberfest","php","twig","upstatement","wordpress","2026-06-12 02:01:52","\u003Cdiv style=\"text-align: center\">\n\u003Ca href=\"https:\u002F\u002Fupstatement.com\u002Ftimber\u002F\">\u003Cimg src=\"https:\u002F\u002Fi.imgur.com\u002FPbEwvZ9.png\" style=\"display:block; margin:auto; width:100%; max-width:100%\"\u002F>\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n## Timber 2.0\n\nBy\n[Jared Novack](https:\u002F\u002Fgithub.com\u002Fjarednova) ([@jarednova](https:\u002F\u002Ftwitter.com\u002Fjarednova)),\n[Lukas Gächter](https:\u002F\u002Fgithub.com\u002Fgchtr) ([@lgaechter](https:\u002F\u002Ftwitter.com\u002Flgaechter)),\n[Nicolas Lemoine](https:\u002F\u002Fgithub.com\u002Fnlemoine) ([@nlemoine](https:\u002F\u002Fn5s.dev\u002F)),\n[Erik van der Bas](https:\u002F\u002Fgithub.com\u002FLevdbas) ([website](https:\u002F\u002Fbasedonline.nl\u002F)),\n[Coby Tamayo](https:\u002F\u002Fgithub.com\u002Facobster) ([@cobytamayo](https:\u002F\u002Fkeybase.io\u002Facobster)),\n[Upstatement](https:\u002F\u002Ftwitter.com\u002Fupstatement) and [hundreds of other GitHub contributors](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Fgraphs\u002Fcontributors):\n\n[![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Fcontributors.svg?width=900&button=false)](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Fgraphs\u002Fcontributors)\n\n[![PHP unit tests](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Factions\u002Fworkflows\u002Fphp-unit-tests.yml\u002Fbadge.svg?branch=2.x)](https:\u002F\u002Fgithub.com\u002F\u002Ftimber\u002Ftimber\u002Factions\u002Fworkflows\u002Fphp-unit-tests.yml?query=branch:2.x)\n[![Codecov](https:\u002F\u002Fimg.shields.io\u002Fcodecov\u002Fc\u002Fgithub\u002Ftimber\u002Ftimber?style=flat)](https:\u002F\u002Fapp.codecov.io\u002Fgh\u002Ftimber\u002Ftimber)\n[![Latest Stable Version](https:\u002F\u002Fimg.shields.io\u002Fpackagist\u002Fv\u002Ftimber\u002Ftimber.svg?style=flat-square)](https:\u002F\u002Fpackagist.org\u002Fpackages\u002Ftimber\u002Ftimber)\n[![!Financial Contributors](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fbadge.svg)](https:\u002F\u002Fopencollective.com\u002Ftimber\u002F)\n\n### ⚠️ Important information about the Timber plugin ⚠️\n> With the release of Timber 2.0, Composer is the only supported install method. We are unable to continue releasing or supporting Timber as a plugin on WordPress.org. We advise everyone to **[switch to the Composer based install of Timber 1 as a first step](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv1\u002Fgetting-started\u002Fswitch-to-composer\u002F)** as soon as possible. If you need PHP 8.2 support you will have to switch to Timber 2.0.\n\nFor more information and a list of additional resources, please visit this [discussion](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Fdiscussions\u002F2804).\n\n## What is Timber?\n\n> Because WordPress is awesome, but [The Loop](https:\u002F\u002Fdeveloper.wordpress.org\u002Fthemes\u002Fbasics\u002Fthe-loop\u002F) isn’t.\n\nTimber helps you create fully-customized WordPress themes faster with more sustainable code. With Timber, you write your HTML using the [Twig Template Engine](https:\u002F\u002Ftwig.symfony.com\u002F) separate from your PHP files.\n\nThis cleans up your theme code so, for example, your PHP file can focus on being the data\u002Flogic, while your Twig file can focus 100% on the HTML and display.\n\nThis is what Timber's `.twig` files look like (from this [Hello World example](https:\u002F\u002Fgist.github.com\u002Fjarednova\u002Fdc75030fd2c7dd6fe52a6fef459c450e))\n\n```twig\n{% extends \"base.twig\" %}\n\n{% block content %}\n  \u003Ch1 class=\"big-title\">{{ foo }}\u003C\u002Fh1>\n  \u003Ch2 class=\"post-title\">{{ post.title }}\u003C\u002Fh2>\n\n  \u003Cimg src=\"{{ post.thumbnail.src }}\" \u002F>\n\n  \u003Cdiv class=\"body\">\n\t{{ post.content }}\n  \u003C\u002Fdiv>\n{% endblock %}\n```\n\nOnce Timber is installed, it gives any WordPress theme the ability to take advantage of the power of Twig and other Timber features.\n\n## Documentation\n\n* [Timber Documentation](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002F)\n* [Timber 2.0 Upgrade Guide](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Fupgrade-guides\u002F2.0\u002F)\n* [Twig Reference](https:\u002F\u002Ftwig.symfony.com\u002Fdoc\u002F3.x\u002F)\n* [Overview \u002F Getting Started Guide](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Fgetting-started\u002Fintroduction\u002F)\n\n* * *\n\n### Installation\n\nFollow the [Installation Guide](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Finstallation\u002Finstallation\u002F) for how to install Timber using Composer.\n\n### What Now?\n\nSetup the [Timber Starter Theme](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Finstallation\u002Finstallation\u002F#use-the-starter-theme). Once you have that installed in your WordPress setup, continue reading the [Getting Started guide to Theming](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Fgetting-started\u002Fintroduction\u002F).\n\n## Timber’s mission\n\nTimber is a tool for developers who want to translate their HTML into high-quality WordPress themes through an intuitive, consistent and fully-accessible interface.\n* **Intuitive**: The API is written to be user-centric around a programmer's expectations.\n* **Consistent**: WordPress objects can be accessed through common polymorphic properties like slug, ID and name.\n* **Accessible**: No black boxes. Every effort is made so the developer has access to 100% of their HTML.\n\n### What does it look like?\nNothing. Timber is meant for you to build a theme on. Like [underscores](https:\u002F\u002Fgithub.com\u002FAutomattic\u002F_s) it comes style-free, because you're the style expert. Instead, Timber handles the logic you need to make a kick-ass looking site.\n\n### Who is it good for?\nTimber is great for any WordPress developer who cares about writing good, maintainable code. It helps teams of designers and developers working together. At [Upstatement](https:\u002F\u002Fupstatement.com) we made Timber because while our entire team needs to participate in building WordPress sites, not everyone knows the ins-and-outs of the_loop(),  codex and PHP (nor should they). With Timber your best WordPress engineer can focus on building the `.php` files with requests from WordPress and pass the data into `.twig` files. Once there, designers can easily mark-up data and build out a site's look-and-feel.\n\n### Should I use it?\n\nTimber is MIT-licensed, so please use in personal or commercial work. Just don't re-sell it. Timber is used on [tens of thousands of sites](https:\u002F\u002Fwww.upstatement.com\u002Ftimber\u002F#showcase) (and tons more we don't know about)\n\n## Timber 1\n\nYou can find the code for Timber 1 on the [1.x branch](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Ftree\u002F1.x) and read the Timber 1 documentation [over here](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv1\u002F).\n\n## Links\n\n### Related & Official Projects\n\n* [**Twig**](https:\u002F\u002Fgithub.com\u002Ftwigphp\u002FTwig) The template language used by Timber.\n* [**Timber Starter Theme**](https:\u002F\u002Fgithub.com\u002Ftimber\u002Fstarter-theme) The \"_s\" of Timber to give you an easy start to the most basic theme you can build upon and customize.\n* [**wp-i18n-twig**](https:\u002F\u002Fgithub.com\u002Ftimber\u002Fwp-i18n-twig) WP CLI Command to grab translatable strings from Twig files.\n* [**Timber Debug Bar**](https:\u002F\u002Fgithub.com\u002Ftimber\u002Fdebug-bar-timber) Adds a debug bar panel that will show you which template is in-use and the data sent to your twig file.\n\n### Related Timber Projects\n\n* [**Editor for Timber**](https:\u002F\u002Fwordpress.org\u002Fplugins\u002Feditor-for-timber\u002F) Edit your Twig files from the WordPress admin\n* [**Pine**](https:\u002F\u002Fgithub.com\u002Fazeemhassni\u002Fpine) A CLI _installer_ for Timber\n* [**Query Monitor Twig Profile**](https:\u002F\u002Fgithub.com\u002FNielsdeBlaauw\u002Fquery-monitor-twig-profile) An add-on for [Query Monitor](https:\u002F\u002Fwordpress.org\u002Fplugins\u002Fquery-monitor\u002F) to see what's going on inside your Twig files (automatically works with Timber!)\n* [**Timber ACF WP Blocks**](https:\u002F\u002Fgithub.com\u002Fpalmiak\u002Ftimber-acf-wp-blocks) Easy ACF Gutenberg blocks creation\n* [**Timber CLI**](https:\u002F\u002Fgithub.com\u002Fnclud\u002Fwp-timber-cli) A CLI for Timber\n* [**Timber Commented Include**](https:\u002F\u002Fgithub.com\u002Fdjboris88\u002Ftimber-commented-include) Debug output via HTML comments before and after each include statement in Twig\n* [**Timber Debugger**](https:\u002F\u002Fgithub.com\u002Fdjboris88\u002Ftimber-debugger) Package that provides extra debugging options for Timber\n* [**Timber Dump Extension**](https:\u002F\u002Fgithub.com\u002Fnlemoine\u002Ftimber-dump-extension) Debug output with nice formatting\n* [**Timber Photon**](https:\u002F\u002Fgithub.com\u002Fslimndap\u002FTimberPhoton) Plug-in to use JetPack's free Photon image manipulation and CDN with Timber\n* [**Timber VS Code Extension**](https:\u002F\u002Fgithub.com\u002FJDevx97\u002FTimber-Snippets) Snippets for Timber in Visual Studio Code\n* [**Timber Sugar**](https:\u002F\u002Fgithub.com\u002Ftimber\u002Fsugar) A catch-all for goodies to use w Timber\n* [**Timber WebLink Extension**](https:\u002F\u002Fgithub.com\u002Fnlemoine\u002Ftimber-weblink-extension) Provides Twig functions to manage the Link HTTP header needed for Web Linking when using HTTP\u002F2 Server Push as well as Resource Hints\n* [**Timmy**](https:\u002F\u002Fgithub.com\u002FMINDKomm\u002FTimmy) Advanced image manipulation for Timber\n\n### Projects that use Timber\n* [**Branch**](https:\u002F\u002Fgithub.com\u002FJeyKeu\u002Fbranch\u002F) Bootstrap 3 + Timber = Branch starter theme!\n* [**Flynt**](https:\u002F\u002Fflyntwp.com\u002F) a component based WordPress starter theme built on Timber and ACF Pro\n* [**Gantry5**](https:\u002F\u002Fwordpress.org\u002Fplugins\u002Fgantry5\u002F) a framework for theme development\n* [**Hozokit**](https:\u002F\u002Fgithub.com\u002Fcsalmeida\u002Fhozokit) a component based starter theme\n* [**Juniper**](https:\u002F\u002Fwww.osomstudio.com\u002Fblog\u002Fmeet-the-juniper-starter-pack-your-wordpress-development-new-best-friend\u002F) Starter pack that incorporates Timber and Bedrock\n* [**Seedling**](https:\u002F\u002Fgithub.com\u002Fmaxdmyers\u002Fseedling) a starter theme using Bootstrap 4\n\n### Helpful Links\n\n* [**CSS Tricks**](https:\u002F\u002Fcss-tricks.com\u002Ftimber-and-twig-reignited-my-love-for-wordpress\u002F) introduction to Timber by [@tjFogarty](https:\u002F\u002Fgithub.com\u002FtjFogarty)\n* [**Twig for Timber Cheatsheet**](https:\u002F\u002Fnotlaura.com\u002Fthe-twig-for-timber-cheatsheet\u002F) by [@laras126](https:\u002F\u002Fgithub.com\u002Flaras126)\n* [**Timber Cheatsheet**](https:\u002F\u002Fgist.github.com\u002Ftaotiwordpress\u002F266fd95513f97f3c17748288579c56b9) by [@taotiwordpress](https:\u002F\u002Fgithub.com\u002Ftaotiwordpress)\n* [**TutsPlus**](https:\u002F\u002Fcode.tutsplus.com\u002Farticles\u002Fkick-start-wordpress-development-with-twig-introduction--cms-24781) A guide to getting started by [@ahmadawais](https:\u002F\u002Fgithub.com\u002Fahmadawais)\n\n## Reporting Security Issues\nTo disclose a security issue to our team, please submit a report via [GitHub](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Fsecurity).\n\n## Support\nPlease post on [StackOverflow under the \"Timber\" tag](https:\u002F\u002Fstackoverflow.com\u002Fquestions\u002Ftagged\u002Ftimber). Please use GitHub issues _only_ for specific bugs, feature requests and other types of issues.\n\n## Contributing & Community\nWe love PRs! Read the [Contributor Guidelines](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Fblob\u002Fmaster\u002FCONTRIBUTING.md) for more info. Say hello, share your tips\u002Fwork, and spread the love on Twitter at [@TimberWP](https:\u002F\u002Ftwitter.com\u002FTimberWP).\n\n## Sponsor us\n\nSince 2013 our goal at Timber is to create a library to that helps you create fully-customized WordPress themes _faster_ with more _sustainable code_.\n\nThrough the collaborative efforts of both our dedicated team and countless contributors, we have invested numerous hours in maintaining and enhancing Timber. To keep doing that, we rely on the invaluable support of our sponsors.\n\nAre you a WordPress pro or part of an agency who relies on Timber? Keep the magic alive by [becoming a sponsor](https:\u002F\u002Fopencollective.com\u002Ftimber)! By becoming a sponsor, you contribute to the continuous maintenance and enhancement of Timber, ultimately benefiting developers worldwide.\n\n![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fbronze-sponsor.svg?avatarHeight=36&limit=0&button=true)\n\n### Gold Sponsors\n\n![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fgold-sponsor.svg?avatarHeight=36&button=false)\n\n\u003C!-- Enable when available.\n### Silver Sponsors\n\n![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fsponsors.svg?avatarHeight=36?avatarHeight=36&button=false)\n-->\n\n\u003C!-- Enable when available.\n### Basic Sponsors\n\n![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fbronze-sponsor.svg?avatarHeight=36&button=false)\n-->\n\n### Our backers\n\n![](https:\u002F\u002Fopencollective.com\u002Ftimber\u002Ftiers\u002Fbackers.svg?avatarHeight=36&button=false)\n\n## Documentation\n\nThe Official [Documentation for Timber](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002F) is generated from the contents of this repository:\n\n* Documentation for classes and functions is [auto generated](https:\u002F\u002Fgithub.com\u002Ftimber\u002Fdocs). Any changes to the [Reference section](https:\u002F\u002Ftimber.github.io\u002Fdocs\u002Fv2\u002Freference\u002F) of the docs should be made by editing the function’s DocBlock. For inline documentation, we follow the [WordPress PHP Documentation Standards](https:\u002F\u002Fmake.wordpress.org\u002Fcore\u002Fhandbook\u002Fbest-practices\u002Finline-documentation-standards\u002Fphp\u002F).\n* To make a change to one of the guides, edit the relevant file in the [`docs` directory](https:\u002F\u002Fgithub.com\u002Ftimber\u002Ftimber\u002Ftree\u002F2.x\u002Fdocs).\n","Timber 是一个用于创建WordPress主题的工具，它通过使用面向对象编程（OOP）和Twig模板引擎来实现代码与设计分离。其核心功能包括利用PHP处理数据逻辑，而将HTML结构和展示层交由Twig文件负责，从而提高代码可读性和维护性。此外，Timber支持Composer安装，并且自2.0版本起推荐使用该方式进行部署。此项目特别适合于需要高效开发高质量、易维护WordPress网站或博客的开发者及团队使用。","2026-06-11 03:17:22","top_language"]