It’s good practice to parameterize labels, rather than hard-coding them, so that they can localized easily. In SFCC, you define your labels in .properties files, and you can create separate files for each locale.<\/p>\n
In this post, assume that your cartridge is called int_mycartridge. You would create your .properties file(s) in int_mycartridge\/templates\/resources:<\/p>\n
\/repo_root\n+--int_mycartridge\n +--templates\n +--my_template_files.isml\n +--resources\n +--my_resource_file.properties\n<\/pre>\nYou can have more than one .properties file. The file naming convention for different locales<\/a> is as follows:<\/p>\n
\n
- my_resource_file.properties: Default locale file<\/li>\n
- my_resource_file_es.properties: Localization file for all Spanish (ES) locales<\/li>\n
- my_resource_file_es_ES.properties: Localization file for the es_ES (Spanish-Spain) locale<\/li>\n<\/ul>\n
The file will look something like this, with one entry per line:<\/p>\n
\nfield.shipping.address.rut=Rol Unico Tributario\n<\/pre>\nYou can use your judgment as to the dot syntax – in the example above, which is for a checkout form, I followed the same pattern as other checkout fields.<\/p>\n
Then, in either your ISML templates, you can reference the labels as follows:<\/p>\n
\n&lt;label&gt;\n${Resource.msg('field.shipping.address.rut', 'my_resource_file', 'Rol Unico Tributario')}:\n&lt;\/label&gt;\n<\/pre>\nNote that uses the Resource class<\/a>. The second argument is the name of your .properties file (without the extension), and the third is the default text to show if the label couldn’t be found.<\/p>\n
Forms<\/strong>
\nIf you’re using SFRA’s declarative XML to define a form, complete with validation, then you will want to reference error messages in the definition XML, e.g.<\/p>\n\n&lt;?xml version="1.0"?&gt;\n&lt;form xmlns="http:\/\/www.demandware.com\/xml\/form\/2008-04-19"&gt;\n&lt;field formid="regionCode" type="string" mandatory="true"\nlabel="form.mycartridge.label.region"\nmissing-error="form.mycartridge.region.missing"\nvalue-error="form.mycartridge.region.invalid"\nparse-error="error.message.required"\nregexp="(^[a-zA-Z0-9]+$)"&gt;\n&lt;\/field&gt;\n\n&lt;\/form&gt;\n<\/pre>\nNote how this XML file references labels such as form.mycartridge.label.region<\/strong>. In this case, you simply need to define a resource file named forms.properties<\/strong> for the framework to locate your labels.<\/p>\n","protected":false},"excerpt":{"rendered":"
It’s good practice to parameterize labels, rather than hard-coding them, so that they can localized easily. In SFCC, you define your labels in .properties files, and you can create separate files for each locale. In this post, assume that your cartridge is called int_mycartridge. You would create your .properties file(s) in int_mycartridge\/templates\/resources: \/repo_root +–int_mycartridge +–templates … Continue reading Using Template Resource Files For Labels in Commerce Cloud<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[17],"tags":[],"_links":{"self":[{"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/posts\/389"}],"collection":[{"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/comments?post=389"}],"version-history":[{"count":16,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/posts\/389\/revisions"}],"predecessor-version":[{"id":458,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/posts\/389\/revisions\/458"}],"wp:attachment":[{"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/media?parent=389"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/categories?post=389"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.antunkarlovac.com\/blog\/wp-json\/wp\/v2\/tags?post=389"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}