{"id":3960,"date":"2023-09-22T07:39:02","date_gmt":"2023-09-22T06:39:02","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&p=3960"},"modified":"2024-03-19T13:25:45","modified_gmt":"2024-03-19T12:25:45","slug":"get-text","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/dynamic-content\/text-operations\/get-text\/","title":{"rendered":"Get text"},"content":{"rendered":"\n

Dynamic Content can be used to get localized text based on subscriber locale, using GetText method.<\/p>\n\n\n\n

To use this you need to create data table with name Translations and following structure:<\/p>\n\n\n\n

Column name<\/th>Type<\/th>PK<\/th><\/tr><\/thead>
key<\/td>string(255)<\/td>Yes<\/td><\/tr>
locale<\/td>string min. 7 characters<\/td>Yes<\/td><\/tr>
translation<\/td>text<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Method signature:<\/strong><\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
$<\/span>{<\/span>GetText<\/span>(<\/span>key<\/span>,<\/span> locale<\/span>,<\/span> fallback<\/span>,<\/span> valuepairs<\/span>)}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
    \n
  • key<\/code> of translated value<\/li>\n\n\n\n
  • locale<\/code> is a culture of translation e.g. ‘RU’, ‘PL’, ‘default’<\/li>\n\n\n\n
  • fallback<\/code> is default value which will be returned when there is no translation for provided key and locale and there is no default locale for the key.<\/li>\n\n\n\n
  • valuepairs<\/code> is dictionary of parameters which will be replaced in translated sentence. Note that parameter name needs to be placed between % signs.<\/li>\n<\/ul>\n\n\n\n
    Example:<\/strong><\/p>\n\n\n\n
    Let’s say that we have following rows in our Translations table:<\/p>\n\n\n\n
    Key<\/th>Locale<\/th>translation<\/th><\/tr><\/thead>
    expiration_date<\/td>default<\/td>Your %param_account% subscription expires on: %param_date%<\/td><\/tr>
    expiration_date<\/td>PL<\/td>Twoja subskrypcja %param_account% wygasa: %param_date%<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/path><\/path><\/svg><\/span>
    <%<\/span><\/span>\nvar<\/span> <\/span>valuepairs<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>System<\/span>.<\/span>Collections<\/span>.<\/span>Generic<\/span>.<\/span>Dictionary<\/span><<\/span>string<\/span>,<\/span> <\/span>string<\/span>>();<\/span><\/span>\n<\/span>\nvaluepairs<\/span>.<\/span>Add<\/span>(<\/span>'<\/span>param_account<\/span>'<\/span>,<\/span>'<\/span>Netflix<\/span>'<\/span>);<\/span><\/span>\nvaluepairs<\/span>.<\/span>Add<\/span>(<\/span>'<\/span>param_date<\/span>'<\/span>,<\/span>'<\/span>2020-04-15 00:13:00<\/span>'<\/span>);<\/span><\/span>\n%><\/span><\/span>\n<\/span>\nDefault<\/span>:<\/span> $<\/span>{<\/span>GetText<\/span>(<\/span>'<\/span>expiration_date<\/span>'<\/span>)}<\/span> <\/span><<\/span>br <\/span>\/><\/span><\/span>\nDefault<\/span>:<\/span> $<\/span>{<\/span>GetText<\/span>(<\/span>'<\/span>expiration_date<\/span>'<\/span>,<\/span> <\/span>'<\/span>default<\/span>'<\/span>,<\/span> <\/span>''<\/span>,<\/span> valuepairs<\/span>)}<\/span> <\/span><<\/span>br <\/span>\/><\/span><\/span>\n<\/span>\nPL<\/span>:<\/span> $<\/span>{<\/span>GetText<\/span>(<\/span>'<\/span>expiration_date<\/span>'<\/span>,<\/span> <\/span>'<\/span>PL<\/span>'<\/span>,<\/span> <\/span>''<\/span>,<\/span> valuepairs<\/span>)}<\/span> <\/span><<\/span>br <\/span>\/><\/span><\/span>\n<\/span>\nBR<\/span> <\/span>(<\/span>no translation <\/span>in<\/span> table<\/span>):<\/span> $<\/span>{<\/span>GetText<\/span>(<\/span>'<\/span>expiration_date<\/span>'<\/span>,<\/span> <\/span>'<\/span>BR<\/span>'<\/span>,<\/span> <\/span>''<\/span>,<\/span> valuepairs<\/span>)}<\/span> <\/span><<\/span>br <\/span>\/><\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
    Output:<\/p>\n\n\n\n
    <\/path><\/path><\/svg><\/span>
    Default: Your %param_account% subscription expires on: %param_date%<\/span><\/span>\nDefault: Your Netflix subscription expires on: 2020-04-15 00:13:00<\/span><\/span>\nPL: Twoja subskrypcja Netflix wygasa: 2020-04-15 00:13:00<\/span><\/span>\nBR (no translation in table): Your Netflix subscription expires on: 2020-04-15 00:13:00<\/span><\/span><\/code><\/pre><\/div>\n","protected":false},"author":5,"featured_media":0,"parent":3952,"menu_order":187,"template":"","format":"standard","emp-category":[],"class_list":["post-3960","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/5"}],"version-history":[{"count":2,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3960\/revisions"}],"predecessor-version":[{"id":8901,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3960\/revisions\/8901"}],"up":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3952"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=3960"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=3960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}