Fluent Commerce Logo
Docs
Sign In

Label Naming Conventions

Essential knowledge

Author:

Fluent Commerce staff

Changed on:

25 Oct 2023

Overview

This page provides naming recommendations to follow for labels across the Fluent platform.

  • nameSpace.domain.[subdomain].module.[submodules...].label
  • submodules = page.tab.component(card/table)
  • All levels use the singular. For example, order instead of orders and component instead of components.
  • Use Camel Case to separate words. For example,: fc.om.order.ui.list.title).

Key points

  • Namespace
  • Domain
  • Module
  • Label

Namespace

fc namespace is reserved for Fluent Commerce components and keys. Partners have their own namespace.

Example: fc.om.order.ui.list.title


Domain

The domain represents the Fluent domain where the key is used. For example, Order Management (om), Global Inventory (gi), and Product Availability (pa).

Example: fc.om.order.ui.list.title

Subdomain

Subdomain represents the entity within the primary domain where this key is used. For example, the keys used in the order entity will have order as the subdomain.

Example.: fc.om.order.ui.list.title


Module

The module is the section where key is used within the application. All UI labels have ui as the module key.

Example: fc.om.order.ui.list.title

Sub modules

There can be a number of sub-modules. For example, the page (list or details), card (summary), tab or list can be included as sub module to create a unique key.

Example: fc.om.order.ui.list.title


Label

Label represents the value that is getting translated.

Example: fc.om.order.ui.list.title

The entire key is checked to find a matching translation available in the language resource bundles.

For example:

Order Management Domain

non-UI-centric order 

fc.om.order.[....].status.created fc.om.order.status.booked fc.om.order.type.hd fc.om.order.type.cc

order listing page

fc.om.order.ui.list.nav fc.om.order.ui.list.title fc.om.order.ui.list.results.column.ref fc.om.order.ui.list.results.column.customer fc.om.order.ui.list.results.column.status fc.om.order.ui.list.results.column.retailer

customer listing page

fc.om.customer.ui.list.nav fc.om.customer.ui.list.title fc.om.customer.ui.list.results.column.ref fc.om.order.ui.detail.title # page title fc.om.order.ui.detail.overview.title # tab title

overview (tab), summary (card) 

fc.om.order.ui.detail.overview.summary.title fc.om.order.ui.detail.overview.summary.field.type fc.om.order.ui.detail.overview.summary.field.status fc.om.order.ui.detail.overview.summary.field.created

overview (tab), retailer (card)

fc.om.order.ui.detail.overview.retailer.title fc.om.order.ui.detail.overview.retailer.field.retailer

fulfilment (tab), list (card/table)

fc.om.order.ui.detail.fulfilment.title fc.om.order.ui.detail.fulfilment.list.title fc.om.order.ui.detail.fulfilment.list.column.id fc.om.order.ui.detail.fulfilment.list.column.status fc.om.order.ui.detail.fulfilment.list.column.deliveryType fc.om.order.ui.detail.fulfilment.list.column.workflow fc.om.order.ui.detail.tab.overview fc.om.order.ui.detail.tab.fulfilment fc.om.order.ui.detail.summary.field.type fc.om.order.ui.detail.summary.field.status fc.om.order.ui.detail.summary.field.created

Fluent Commerce staff

Fluent Commerce staff

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo