Additional options

Learn how to add options for specific fields

Using the Bricks builder syntax, users can pass one or more arguments to dynamic data using:

{dynamic_data:arg1:arg2}

ACPT allows the user to specify additional options for certain field types.

Skip string sanitizing

By default, Bricks sanitizes the HTML strings, removing JavaScript and any other potentially malicious code.

If you want to skip the sanitization, use the skip_sanitize option, like this:

{acpt_name_of_the_field:skip_sanitize}

Address field

The Address field stores four distinct properties:

• latitude

• longitude

• city

• country

Each of these can be displayed individually.

Example of usage:

{acpt_name_of_the_field:lat}
{acpt_name_of_the_field:lng}
{acpt_name_of_the_field:city}
{acpt_name_of_the_field:country}

Country field

The Country field supports four display formats:

• code — Example: it

• default — Example: Italian (Italy)

• flag — Displays only the country flag

• full — Displays both the flag and the default label

To select a format, simply append it to the field slug. Example:

{acpt_name_of_the_field:flag}

Number field

Under the hood, ACPT uses the standard PHP number_format function.

These arguments are supported, please follow this order:

• decimals

• decimal point

• decimal separator

Suppose you want to render the number 1600 as 1,600.00.

Here is how:

{acpt_name_of_the_field:2:.:,}

Date fields

Specifying the desired date format is possible for every date field.

Example:

{acpt_name_of_the_field:d/m/Y}

The current WordPress date and time formats are used if the date format is not specified.

Currency, Length, and Weight fields

These arguments are supported, please follow this order:

• format - the string format (default: full, allowed: full | symbol | value)

• decimal separator - the decimal separator (default: .)

• thousands separator - the thousands separator (default: ,)

• position - the unit of measure position (default: after, allowed: after | before)

Suppose you want to render 1600000USD.

Here are some examples:

{acpt_field_currency:full}              // 1,600,000.00 USD
{acpt_field_currency:symbol}            // 1,600,000.00 $
{acpt_field_currency:value}             // 1,600,000.00
{acpt_field_currency:symbol:.:,:before} // $ 1,600,000.00

If you need numbers in a different format, you can rely on the standard PHP number_format function.

Inside a CODE block, run something like this:

<?php

echo number_format("{acpt_field_name}",5,".",",");

?>

With the correct field name.

Select Multi and Checkbox fields

For Select Multi and Checkbox fields, it is possible to specify how to render them.

1. Render as a list

The default rendering is as HTML <ul>. It is possible to specify the CSS classes to <ul> element:

{acpt_field_list:ul:fancy-class}

The element will be rendered as:

<ul class="fancy-class">
    <li>foo</li>
    <li>bar</li>
    <li>baz</li>
</ul>

If you want to display the list as an ordered list <ol>:

{acpt_field_list:ol:fancy-class}

The element will be rendered as:

<ol class="fancy-class">
    <li>foo</li>
    <li>bar</li>
    <li>baz</li>
</ol>

2. Render as string

You can display these fields as strings, specifying also the string separator:

{acpt_field_list:string:-}

To display a field as strings separated by -, something like that:

foo-bar-baz

Table field

By default, the Table field outputs HTML markup.

If you want to pull out the value from a specific cell, use this syntax:

{acpt_field_table:b3}

Select fields

For Select, Select Multi, Radio, and Checkbox fields, it is possible to display the label instead of the value:

{acpt_field_option:label}

Gallery field

It is possible to display a gallery element by specifying its index (count starts from 0).

Example:

{acpt_gallery_field:1}

This code will render only the second image of the gallery.

Phone field

Phone fields can be rendered in five different formats:

• original

• e164

• international

• national

• rfc3966

Examples:

{acpt_field_phone:original}
{acpt_field_phone:international}
{acpt_field_phone:rfc3966}

Text truncate

For every textual field, it is possible to truncate the text.

Example:

{acpt_text_field:30}