PHPackages                             iantsch/wp-hbs-engine - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. iantsch/wp-hbs-engine

ActiveWordpress-plugin[Templating & Views](/categories/templating)

iantsch/wp-hbs-engine
=====================

Renders Handlebars templates within your WordPress Theme/Plugin

0.0.1(8y ago)4355[1 issues](https://github.com/iantsch/wp-hbs-engine/issues)MITPHP

Since Feb 23Pushed 6y ago1 watchersCompare

[ Source](https://github.com/iantsch/wp-hbs-engine)[ Packagist](https://packagist.org/packages/iantsch/wp-hbs-engine)[ RSS](/packages/iantsch-wp-hbs-engine/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

WordPress Handlebars Engine
===========================

[](#wordpress-handlebars-engine)

![licence](https://camo.githubusercontent.com/7982dd5e36dbafbf6707da94ff0331fef95b911ae76f0562835bf5d6042d47fc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e63652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265) ![tag](https://camo.githubusercontent.com/0065b0684cf57e7e4a023d2ce652b08bb6c74e393cd5dcf35783a4f07dc1c448/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7461672d76302e302e312d6c69676874677265792e7376673f7374796c653d666c61742d737175617265)

Renders Handlebars/Moustache templates within your WordPress Theme/Plugin. Handlebars rendering is powered by [LightnCandy](https://github.com/zordius/lightncandy). Tested with WordPress 5.2.3

Installation
------------

[](#installation)

You can install this (must-use) plugin two ways

### Via Composer

[](#via-composer)

If you load your dependenies via Composer you can load this plugin with

```
$ php composer require iantsch/wp-hbs-engine
```

### Via Download

[](#via-download)

Download/fork this repository and copy the plugin-folder into `wp-content/plugins/`. If you visit your Plugin section in the `wp-admin` area, activate it and you are good to go.

### Troubleshoots

[](#troubleshoots)

You need to load the `zordius/lightncandy` dependency via composer. Install composer and run `$ composer install` in the `wp-content/plugins/wp-hbs-engine` folder.

The plugin needs a folder with write permissions for caching the handlebar files. It tries to create the folder `wp-content/plugins/wp-hbs-engine/cache`.

The plugin will try to load partials from the default folder `src/templates/partials` within your current theme. If the folder does not exist please add it (or use the filter hook to adapt).

Usage
-----

[](#usage)

Setup and modify the render engine to your needs in your `functions.php` or your plugin

```
add_filter('MBT/Engine/Handlebars/Helpers', function($helpers) {
  $helpers['__'] = function($string) {
    return __($string, 'mbt');
  };
  $helpers['permalink'] = 'get_permalink';
  $helpers['content'] = function() {
    return apply_filters('the_content', get_the_content());
  };
  return $helpers;
});
```

In your theme call it like a WordPress function.

```
global $post;
while (have_posts()){
  the_post();
  $data = (array) $post;
  the_hbs_template('article', $data);
}
```

In your `article.hbs` it is [handlebarsjs.com](https://handlebarsjs.com) syntax

```
{{this.post_title}}
{{{content}}}
{{__ 'Click'}}
```

API
---

[](#api)

#### get\_hbs\_template

[](#get_hbs_template)

ParameterTypeDescription`$template`stringtemplate name`$data`stringassociative array with all the needed data for the template`$templateDir`string | booleanabsolutee path to template entry directory, defaults to `/src/templates/` in current theme`$cacheDir`string | booleanabsolute path to caching directory, defaults to `/cache/` in plugins folder*Returns*: `$html` - the rendered HTML output#### the\_hbs\_template

[](#the_hbs_template)

ParameterTypeDescription`$template`stringtemplate name`$data`stringassociative array with all the needed data for the template`$templateDir`string | booleanabsolutee path to template entry directory, defaults to `/src/templates/` in current theme`$cacheDir`string | booleanabsolute path to caching directory, defaults to `/cache/` in plugins folderechoes the rendered HTML outputHooks
-----

[](#hooks)

There are several hooks to modify and adapt the render engine

### Filters

[](#filters)

#### MBT/Engine/Handlebars/Extension

[](#mbtenginehandlebarsextension)

ParameterTypeDescription`$extension`stringfile extension, default: `hbs`*Returns*: `$extension` - file extension of your handlebar templates#### MBT/Engine/Handlebars/Helpers

[](#mbtenginehandlebarshelpers)

ParameterTypeDescription`$helpers`arrayassociative array with callback functions for the implemented helpers`$this`objectCurrent instance of Handlebars engine*Returns*: `$helpers` - array of handlebars helper#### MBT/Engine/Handlebars/Flags

[](#mbtenginehandlebarsflags)

ParameterTypeDescription`$flags`intbitwise flags used by LightnCandy`$this`objectCurrent instance of Handlebars engine*Returns*: `$flags` - LightnCandy Flags#### MBT/Engine/Handlebars/Partials

[](#mbtenginehandlebarspartials)

ParameterTypeDescription`$partials`arrayassociative array with the relative path to the partials`$this`objectCurrent instance of Handlebars engine*Returns*: `$partials` - array of available partials#### MBT/Engine/Handlebars/DefaultData

[](#mbtenginehandlebarsdefaultdata)

ParameterTypeDescription`$defaultData`arrayfallback data for the template`$template`stringtemplate name*Returns*: `$defaultData` - fallback data for the template#### MBT/Engine/Handlebars/Data

[](#mbtenginehandlebarsdata)

ParameterTypeDescription`$data`arrayassociative array with all the needed data for the template`$template`stringtemplate name*Returns*: `$data` - the data for the template#### MBT/Engine/Handlebars/Html

[](#mbtenginehandlebarshtml)

ParameterTypeDescription`$html`stringrendered HTML output (with data)`$template`stringtemplate name`$data`arraydata used to render output*Returns*: `$html` - the rendered HTML output### Actions

[](#actions)

#### MBT/Engine/Handlebars/Init

[](#mbtenginehandlebarsinit)

ParameterTypeDescription`$this`objectCurrent instance of Handlebars engineCredits
-------

[](#credits)

[@iantsch](https://twitter.com/iantsch) - [web developer](https://mbt.wien) behind this and other projects.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3049d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22318501?v=4)[Christian Tschugg](/maintainers/iantsch)[@iantsch](https://github.com/iantsch)

---

Top Contributors

[![iantsch](https://avatars.githubusercontent.com/u/22318501?v=4)](https://github.com/iantsch "iantsch (3 commits)")

---

Tags

handlebarslightncandywordpresswordpress-pluginwordpresspluginshandlebarslightncandy

### Embed Badge

![Health badge](/badges/iantsch-wp-hbs-engine/health.svg)

```
[![Health](https://phpackages.com/badges/iantsch-wp-hbs-engine/health.svg)](https://phpackages.com/packages/iantsch-wp-hbs-engine)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45344.0k1](/packages/pressbooks-pressbooks)[proai/laravel-handlebars

A Laravel wrapper for LightnCandy for using the Handlebars (and Mustache) template engine.

38207.7k](/packages/proai-laravel-handlebars)[pressbooks/pressbooks-book

This theme is named after Canadian media theorist Marshall McLuhan, who coined the phrase “the medium is the message.” It is designed for academic writing and is also suitable for fiction. Headings are set in Cormorant Garamond, and body type is set in Lora.

206.7k](/packages/pressbooks-pressbooks-book)[benjaminmedia/wp-polylang-theme-strings

Polylang Theme Strings with support for Blade syntax

1510.0k](/packages/benjaminmedia-wp-polylang-theme-strings)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)