{"title":"Creating and editing translations","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice warning\"><div>\n<p><strong>Hosted Payment Pages are no longer available<\/strong><\/p>\n<p>To accept payments through an Adyen-hosted page, use our <a href=\"\/pt\/online-payments\/build-your-integration\/sessions-flow?platform=Web&amp;integration=Hosted%2BCheckout\">Hosted Checkout<\/a>.<\/p>\n<p>This page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life.  We are no longer processing transactions though HPP.<\/p>\n<\/div><\/div>\n<p>You do not need to create a copy of the skin for every language you want to support. A single skin may contain translations for multiple languages and choose the appropriate string to display.<\/p>\n<p>When loading a page, HPP searches for the string in the following order:<\/p>\n<ol>\n<li>Skin resources files using the payment session locale res file (specified in the <code>shopperLocale<\/code> field).<\/li>\n<li>Skin resources files using the default locale.<\/li>\n<li>Default resources files using the payment session locale (through the Adyen Customer Area).<\/li>\n<li>Default resources files using the default locale (through the Adyen Customer Area).<\/li>\n<\/ol>\n<h2 id=\"supported-languages\">Supported languages<\/h2>\n<p>Adyen provides translations for some languages by default:<\/p>\n<table>\n<thead>\n<tr>\n<th>Language<\/th>\n<th>ShopperLocale<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Chinese \u2013 Traditional<\/td>\n<td>zh_CN<\/td>\n<\/tr>\n<tr>\n<td>Czech<\/td>\n<td>cz<\/td>\n<\/tr>\n<tr>\n<td>Danish<\/td>\n<td>da<\/td>\n<\/tr>\n<tr>\n<td>Dutch<\/td>\n<td>nl<\/td>\n<\/tr>\n<tr>\n<td>English \u2013 British*<\/td>\n<td>en_GB<\/td>\n<\/tr>\n<tr>\n<td>English \u2013 Canadian<\/td>\n<td>en_CA<\/td>\n<\/tr>\n<tr>\n<td>English \u2013 US<\/td>\n<td>en_US<\/td>\n<\/tr>\n<tr>\n<td>Finnish<\/td>\n<td>fi<\/td>\n<\/tr>\n<tr>\n<td>French<\/td>\n<td>fr<\/td>\n<\/tr>\n<tr>\n<td>French \u2013 Belgian<\/td>\n<td>fr_BE<\/td>\n<\/tr>\n<tr>\n<td>French \u2013 Canadian<\/td>\n<td>fr_CA<\/td>\n<\/tr>\n<tr>\n<td>French \u2013 Swiss<\/td>\n<td>fr_CH<\/td>\n<\/tr>\n<tr>\n<td>Frisian<\/td>\n<td>fy_NL<\/td>\n<\/tr>\n<tr>\n<td>German<\/td>\n<td>de<\/td>\n<\/tr>\n<tr>\n<td>Greek<\/td>\n<td>el<\/td>\n<\/tr>\n<tr>\n<td>Hungarian<\/td>\n<td>hu<\/td>\n<\/tr>\n<tr>\n<td>Italian<\/td>\n<td>it<\/td>\n<\/tr>\n<tr>\n<td>Lithuanian<\/td>\n<td>li<\/td>\n<\/tr>\n<tr>\n<td>Norwegian<\/td>\n<td>no<\/td>\n<\/tr>\n<tr>\n<td>Polish<\/td>\n<td>pl<\/td>\n<\/tr>\n<tr>\n<td>Portuguese<\/td>\n<td>pt<\/td>\n<\/tr>\n<tr>\n<td>Russian<\/td>\n<td>ru<\/td>\n<\/tr>\n<tr>\n<td>Spanish<\/td>\n<td>es<\/td>\n<\/tr>\n<tr>\n<td>Swedish<\/td>\n<td>sv<\/td>\n<\/tr>\n<tr>\n<td>Thai<\/td>\n<td>th<\/td>\n<\/tr>\n<tr>\n<td>Turkish<\/td>\n<td>tr<\/td>\n<\/tr>\n<tr>\n<td>Ukrainian<\/td>\n<td>uk<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><em>*\u00a0<\/em>\u00a0<em>British English is the default shopperLocale<\/em><\/p>\n<h2 id=\"editing-existing-files\">Editing existing translations<\/h2>\n<p>To edit translations for\u00a0supported languages\u00a0using the\u00a0Adyen Customer Area:<\/p>\n<ol>\n<li>In your Customer Area, go to <strong>Account<\/strong> &gt; <strong>Skins<\/strong> and on the\u00a0<strong>List<\/strong>\u00a0tab select the desired skin.<\/li>\n<li>On the\u00a0<strong>Edit skin configuration<\/strong>\u00a0page, under\u00a0<strong>Extra options<\/strong>\u00a0select\u00a0<strong>Edit Language Files<\/strong>.<\/li>\n<li>Select the language that you want to add or edit translations for.<\/li>\n<li>Edit the translations and select\u00a0<strong>Save<\/strong>\u00a0to apply the changes.<\/li>\n<\/ol>\n<h2 id=\"adding-translations-for-new-languages\">Adding translations for new languages<\/h2>\n<p>If you want to provide translations for a language that Adyen doesn't support by default, we recommend that you\u00a0use the Customer Area\u00a0for this. Alternatively, you can create a resources file for the new language.<\/p>\n<h3 id=\"add-a-new-language-to-skin-in-customer-area\">Add a new language in the Customer Area<\/h3>\n<p>To add a new language to a skin using the Customer Area:<\/p>\n<ol>\n<li>Look up the <a href=\"https:\/\/en.wikipedia.org\/wiki\/List_of_ISO_639-1_codes\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">locale code<\/a> for the language you want to add.<\/li>\n<li>In your Customer Area, go to <strong>Account<\/strong> &gt; <strong>Skins<\/strong> and on the\u00a0<strong>List<\/strong>\u00a0tab select the desired skin.<\/li>\n<li>On the\u00a0<strong>Edit skin configuration<\/strong>\u00a0page, under\u00a0<strong>Extra options<\/strong>\u00a0select\u00a0<strong>Edit Language Files<\/strong>.<\/li>\n<li>Enter the locale code for the new language and select <strong>add<\/strong>.<\/li>\n<li>Enter the translations for the new language and select\u00a0<strong>Save<\/strong>\u00a0to apply the changes.<\/li>\n<\/ol>\n<h3 id=\"create-a-new-resource-file\">Create a new resources file<\/h3>\n<p>To add a language by creating a new resources file, you <a href=\"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\/customizing\">download skin files<\/a>\u00a0from the Customer Area, manually create a skin resources file for the new language, and then upload the customized resources file to the Customer Area.<\/p>\n<p>After downloading the skin files to your computer, you'll find the resources files for all languages in the\u00a0<strong>res<\/strong>\u00a0folder. The\u00a0<strong>resources.properties<\/strong>\u00a0file contains translations for the default locale, <em>en_GB<\/em>. Resources files containing translations for other locales have locale codes included in the filenames. For example,\u00a0<strong>resources_fr.properties<\/strong>\u00a0for French and\u00a0<strong>resources_en_US.properties<\/strong>\u00a0for US English.<\/p>\n<p>Proceed as follows:<\/p>\n<ol>\n<li>Look up the <a href=\"https:\/\/en.wikipedia.org\/wiki\/List_of_ISO_639-1_codes\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">locale code<\/a> for the language you want to add.<\/li>\n<li>Download the default\u00a0<a href=\"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\/creating-and-editing-translations\/resources.properties.zip\">resources.properties file<\/a>.<\/li>\n<li>Add the locale code to the file name. For example,\u00a0<strong>resources_ja.properties<\/strong>\u00a0for Japanese, or <strong>resources_nb.properties<\/strong> for Norwegian Bokm\u00e5l.<\/li>\n<li>Edit this file and replace the field values with translations for the new language.<\/li>\n<li>Upload your new resources file to the Customer Area.<\/li>\n<\/ol>\n<div class=\"sc-notice note\"><div>\n<p>The resources files use the\u00a0<strong>Latin 1<\/strong>\u00a0encoding (<a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO\/IEC_8859-1\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 8859-1<\/a>). We recommended that you treat them as US-ASCII only. Any character that is outside the US-ASCII set should be encoded in Unicode using the notation \\u + UTF-16 code point. Thus \"\u00e9\" becomes \"\\u00e9\" and \"\u0158\" becomes \"\\u0158\".<\/p>\n<\/div><\/div>","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\/creating-and-editing-translations","articleFields":{"id":"24217139","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"24-04-2019 15:15","sitemap":{"priority":0.3},"parameters":{"anchor_new":"<a href=\"\/online-payments\/build-your-integration\/sessions-flow?platform=Web&integration=Components#localization\">Localization<\/a>","parent_page":"classic Hosted Payment Pages (HPP)","new_desc":"looking for supported languages for Web Drop-in or Components"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\/creating-and-editing-translations","title":"Creating and editing translations","content":"\nHosted Payment Pages are no longer available\nTo accept payments through an Adyen-hosted page, use our Hosted Checkout.\nThis page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life.  We are no longer processing transactions though HPP.\n\nYou do not need to create a copy of the skin for every language you want to support. A single skin may contain translations for multiple languages and choose the appropriate string to display.\nWhen loading a page, HPP searches for the string in the following order:\n\nSkin resources files using the payment session locale res file (specified in the shopperLocale field).\nSkin resources files using the default locale.\nDefault resources files using the payment session locale (through the Adyen Customer Area).\nDefault resources files using the default locale (through the Adyen Customer Area).\n\nSupported languages\nAdyen provides translations for some languages by default:\n\n\n\nLanguage\nShopperLocale\n\n\n\n\nChinese \u2013 Traditional\nzh_CN\n\n\nCzech\ncz\n\n\nDanish\nda\n\n\nDutch\nnl\n\n\nEnglish \u2013 British*\nen_GB\n\n\nEnglish \u2013 Canadian\nen_CA\n\n\nEnglish \u2013 US\nen_US\n\n\nFinnish\nfi\n\n\nFrench\nfr\n\n\nFrench \u2013 Belgian\nfr_BE\n\n\nFrench \u2013 Canadian\nfr_CA\n\n\nFrench \u2013 Swiss\nfr_CH\n\n\nFrisian\nfy_NL\n\n\nGerman\nde\n\n\nGreek\nel\n\n\nHungarian\nhu\n\n\nItalian\nit\n\n\nLithuanian\nli\n\n\nNorwegian\nno\n\n\nPolish\npl\n\n\nPortuguese\npt\n\n\nRussian\nru\n\n\nSpanish\nes\n\n\nSwedish\nsv\n\n\nThai\nth\n\n\nTurkish\ntr\n\n\nUkrainian\nuk\n\n\n\n*\u00a0\u00a0British English is the default shopperLocale\nEditing existing translations\nTo edit translations for\u00a0supported languages\u00a0using the\u00a0Adyen Customer Area:\n\nIn your Customer Area, go to Account &gt; Skins and on the\u00a0List\u00a0tab select the desired skin.\nOn the\u00a0Edit skin configuration\u00a0page, under\u00a0Extra options\u00a0select\u00a0Edit Language Files.\nSelect the language that you want to add or edit translations for.\nEdit the translations and select\u00a0Save\u00a0to apply the changes.\n\nAdding translations for new languages\nIf you want to provide translations for a language that Adyen doesn't support by default, we recommend that you\u00a0use the Customer Area\u00a0for this. Alternatively, you can create a resources file for the new language.\nAdd a new language in the Customer Area\nTo add a new language to a skin using the Customer Area:\n\nLook up the locale code for the language you want to add.\nIn your Customer Area, go to Account &gt; Skins and on the\u00a0List\u00a0tab select the desired skin.\nOn the\u00a0Edit skin configuration\u00a0page, under\u00a0Extra options\u00a0select\u00a0Edit Language Files.\nEnter the locale code for the new language and select add.\nEnter the translations for the new language and select\u00a0Save\u00a0to apply the changes.\n\nCreate a new resources file\nTo add a language by creating a new resources file, you download skin files\u00a0from the Customer Area, manually create a skin resources file for the new language, and then upload the customized resources file to the Customer Area.\nAfter downloading the skin files to your computer, you'll find the resources files for all languages in the\u00a0res\u00a0folder. The\u00a0resources.properties\u00a0file contains translations for the default locale, en_GB. Resources files containing translations for other locales have locale codes included in the filenames. For example,\u00a0resources_fr.properties\u00a0for French and\u00a0resources_en_US.properties\u00a0for US English.\nProceed as follows:\n\nLook up the locale code for the language you want to add.\nDownload the default\u00a0resources.properties file.\nAdd the locale code to the file name. For example,\u00a0resources_ja.properties\u00a0for Japanese, or resources_nb.properties for Norwegian Bokm\u00e5l.\nEdit this file and replace the field values with translations for the new language.\nUpload your new resources file to the Customer Area.\n\n\nThe resources files use the\u00a0Latin 1\u00a0encoding (ISO 8859-1). We recommended that you treat them as US-ASCII only. Any character that is outside the US-ASCII set should be encoded in Unicode using the notation \\u + UTF-16 code point. Thus \"\u00e9\" becomes \"\\u00e9\" and \"\u0158\" becomes \"\\u0158\".\n","type":"page","locale":"pt","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Hosted Payment Pages","lvl4":"Skins for Hosted Payment Pages","lvl5":"Creating and editing translations"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages","lvl4":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin","lvl5":"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\/creating-and-editing-translations"},"levels":6,"category":"Online Payments","category_color":"green","tags":["Creating","editing","translations"]},"articleFiles":{"resources.properties.zip":"<p alt=\"\">resources.properties.zip<\/p>"}}
