Block Code & Assets

Handlebars

Handlebars output method lets you write HTML templates with simple logic using the Handlebars syntax. It's perfect for static content and basic conditional rendering.

Basic Usage

Handlebars Example

{{#if control_name}}
  <div class="message">
    {{control_name}}
  </div>
{{/if}}

Available Helpers

In addition to default Handlebars helpers, Lazy Blocks provides custom helpers for WordPress-specific functionality.

truncate

Truncates text to a specified length.

Truncate Example

{{truncate control_name 100 "true"}}

Parameter	Description
String	Text to truncate
Limit	Character limit
Dots	Show ellipsis (true/false)

compare

Compares values for conditional rendering.

Compare Example

{{#compare price ">" 100}}
  <span class="premium">Premium Item</span>
{{/compare}}

Parameter	Description
First Value	Left side value
Operator	`==`, `===`, `!=`, `!==`, `<`, `>`, `<=`, `>=`, `&&`, `\|\|`
Second Value	Right side value

math

Performs mathematical operations.

Math Example

<div class="price">
  ${{math price "*" quantity}}
</div>

Parameter	Description
First Value	Left side value
Operator	`+`, `-`, `*`, `/`, `%`
Second Value	Right side value

date_i18n

Formats dates using WordPress localization.

Date Example

<time datetime="{{control_date}}">
  {{date_i18n "F j, Y" control_date}}
</time>

Parameter	Description
Format	Date format (e.g., `F j, Y H:i`)
Date	Date string

do_shortcode

Processes WordPress shortcodes.

Shortcode Example

{{{do_shortcode "my_shortcode" this}}}

Parameter	Description
Name	Shortcode name
Attributes	Use `this` for all block attributes

wp_get_attachment_image

Outputs WordPress image with proper srcset.

Image Example

{{{wp_get_attachment_image image_control "large"}}}

Parameter	Description
Image	Image control value
Size	Image size name (default: thumbnail)

Adding Custom Helpers

Create your own Handlebars helpers:

PHP

function my_custom_handlebars_helper($handlebars) {
    $handlebars->registerHelper('format_price', function($price) {
        return '$' . number_format($price, 2);
    });
}
add_action('lzb/handlebars/object', 'my_custom_handlebars_helper');

Usage:

<div class="price">
  {{format_price product_price}}
</div>

Use Handlebars when you need simple templates with basic logic. For complex dynamic content, consider using PHP output instead.

Previous ArticleOverview Next ArticlePHP