cbi18n

What problem does it solve?

Provide a consistent internationalization and localization layer for ColdBox and BoxLang applications so that user-facing strings are centralized, translations are manageable, and locale-specific formatting is correct across handlers, views, and modules.

Core Features & Use Cases

• Installation and configuration of the cbi18n module with defaultResourceBundle, defaultLocale, and localeStorage options.
• Support for resource bundle files in Java properties and JSON formats, plus multiple named bundles for areas like admin and emails.
• Translation helpers to retrieve strings from bundles and perform positional or named substitutions for dynamic content.
• Locale management and switching with persistence, plus Java-based date, number, and currency formatting per locale.
• Programmatic access via injected i18n services in handlers for contexts where view helpers are unavailable.

Quick Start

Install and enable the cbi18n module, set defaultResourceBundle and defaultLocale in ColdBox.cfc, and call the getResource or $r helper in views to render translated strings.