Skip to main content

[bec_unit_field]

Outputs a single scalar value from the unit’s synced provider payload (bec_sync_payload → raw). Use it for simple text or numbers that are not covered by [bec_unit_info] renderers or canonical bec_core_* meta.

For the Italian CIN (Codice Identificativo Nazionale), prefer the canonical field synced into bec_core_cin (editable under Unit — core fields). You can still read it with this shortcode when needed.

Where to put it​

Unit templates, footers, compliance lines, or archive cards where you need one fact (registration code, custom API field, size, etc.).

Attributes​

AttributeDefaultMeaning
field(empty)Required. Dot path under the provider raw object (e.g. cin, size_sqm, custom_fields.custom_1.it).
typestringstring (default) or number — coerces output; non-scalar values fall back to default.
unit_id0Units post ID; 0 uses the current loop post.
default(empty)Plain text shown when the field is missing or invalid (HTML-escaped).

Locale-specific maps in the payload require an explicit locale segment in the path (e.g. custom_fields.custom_1.it) — there is no automatic locale fallback inside the path.

Examples​

CIN from raw payload (also available as canonical meta after sync):

[bec_unit_field field="cin"]

Custom Kross field with locale segment:

[bec_unit_field field="custom_fields.custom_1.it"]

Numeric size:

[bec_unit_field field="size_sqm" type="number"]

Explicit unit on an archive card:

[bec_unit_field field="cin" unit_id="456" default="—"]

Visitor output​

  • Prints escaped plain text only (no HTML wrapper).
  • Empty field → default or nothing.
  • Wrong post type / missing payload → default or nothing.

Developer hooks​

FilterPurpose
bec_unit_field_valueAdjust resolved value before coercion ($value, $field, $postId, $decoded, $context, $passThrough).
bec_kross_unit_field_valueKross-specific adjustment (same arguments).

Providers implement ProviderInterface::getUnitFieldValue() — see Adding a provider.