In This Article:

    Internationalization

    In This Article:

      Jump to a section:

      - Setting up translations
      - Translation differences
      - Internationalization FAQ

      This section will cover how to configure the Internationalization package, and what areas of Salsa can be used with internationalization.

      The Internationalization package is not installed in Salsa by default. If you don't currently have it, please contact your Account Manager, who can help set up your organization with this package.


      Setting up translations

      Below is an outline of the process for setting up translations for Salsa pages.

      If translations are available for a page you will find the option below the public facing content sections:

      Clicking the Translations link will bring you to a page to setup the translations for all languages currently supported by Salsa:

      From here you have the option to use Google Translate by clicking the button seen below:

      You will translate the text and then copy and paste it back into the proper language section. You can also simply enter your translated content in the target language manually.

      If you only need to translate into one language you can fill in that box and save the changes. For instance, If only Spanish-speaking supporters will be accessing the page, you don't need to worry about filling in the other language types.

      List of Salsa pages compatible with the Translate interface

      Actions

      • Petition
      • Targeted Action

      Actions 3

      • Blind Targeted Action
      • Multi-targeted Action
      • Targeted Action
      • Petition

      Website Management

      • Website Template
      • Homepage
      • Contact Page
      • Signup Page
      • Custom Content Item
      • Simple Survey
      • Tell a Friend Page
      • Thank you page
      • Privacy Page

      Differences in how translations will appear

      Salsa will automatically determine which language should be displayed to each of your supporters. (This process is outlined in the FAQ.)

      However, you also have the option of locking pages down to a particular language translation, simply by adding a small snippet of code to the page URL. You can find those instructions on the FAQ as well.

      Using this method, you can also translate pages that don't have built-in translation options, such as Donation pages. In those cases, you will place your translated text into the Content section of your page setup, then add the language code to the URL. This will make sure both standard, Salsa-supplied fields (like First Name) and the page content are set to the proper language.

      Example of a page without translations:

      Example of a page with automatic translations from Salsa (by adding /l/spa):

      Example of a page using automatic translations and updating the content with Spanish:


      Internationalization FAQ

      What languages do you support?

      Salsa currently supports

      • English (/l/eng)
      • French (/l/fra)
      • Spanish (/l/spa)
      • Arabic (/l/ara)
      • German (/l/ger)
      • Portuguese (/l/por)

      How do you know what language to display to a user?

      • Salsa will first check to see if the URL has a language code listed, such as "l/ara/". If so, then content saved in that language will be displayed.
      • Next, Salsa will look to see if the user submits a cookie (lang=ara, etc), and use that cookie for the translations.
      • Next, if the user has logged in, or we know who they are because of a past action or email click, Salsa will check the supporter field "Language_Code" to determine what language to deliver.
      • Finally, if no language information can be determined, English will be displayed.
      • For Portuguese use " /l/por/p / dia/action...."

      Some of the text on my page isn't translated. What's up?

      Not all Salsa pages are translated into all languages. While we fully intend to translate all major features into our supported languages, there are still a number of pages that have yet to be translated. To help you sort out what's not translated, there are 3 types of text on your page:

      • Content Translations: For pages that support translations, the Headquarters will present a Translations link for each item of content, such as the Title or Description of a page. You should enter translations for each language you intend to support. If Translations are not available for a specific item of content, please submit a request to us to put it into our translation development list.
      • Template Translations: Salsa Templates also support languages, so that you don't need to maintain a separate template for each language. Before deploying, make sure you translate your Template for content, as well as to cater to Right-To-Left languages (see Alignment, below)
      • Salsa Standard fields: Some translations, such as Submit buttons, First Name, Last Name, etc. are standard across all of Salsa. If there are a couple of words not translated, but the rest of the page is translated, it's likely our translators haven't reached it yet. Let us know, and we can see about getting it translated.

      The text is aligning to the left on Arabic (etc) pages. How can I fix this?

      You'll likely need to create or edit an Arabic translation of your template. Right-To-Left languages require a few changes to the tags, namely adding in

      dir="rtl"
      

      into the html or tags. You can find more information on doing this here, or by Googling "html dir rtl"

      Your translations are wrong/silly/just generally awkward. Can you fix them?

      We do the best we can to provide the most general translations to our common features. Sometimes, though, the translation doesn't fit your needs. If it's just plain wrong, let us know, and we'll get it fixed. But if it's a phrase that you don't want to use, you'll have to resort a custom field on the page. If that doesn't work, you can use our API with your existing content management system, or you can build a page from scratch with SalsaScript. See the Developers section for more details.

      The State field in a public form is in English, and only shows US states. What's up?

      International forms with a State or Region field only makes sense with a corresponding Country field. To show the translated Country & Region selector, make sure that you:

      • Have selected a Country field in your input form
      • Have the Salsa International package installed.

      How do I change other content in a page that isn't translated, such as custom fields, etc?

      While we are working to translate every part of Salsa, in the meantime you can use jQuery or other javascript methods to translate the page with your own translations. For those who want a hint in the right direction, here is a quick snippet that will translate some custom fields in a page to Spanish. This is an unsupported mechanism for translating content, so if you have any questions about how this works, you'll probably want to get a web developer to help out, or wait until we implement custom fields.

      <script>
       $(function(){
        if (document.location.href.indexOf('/spa/')>0){
         $("#fc3").prev().html("Comentarios");
         $("#fc4").parent().prev().html("Por favor elige un  tema*");
        }
       });
       </script>
       

      How do I enable language support on my page?

      There are two easy steps to enabling language support on a Salsa page:

      1. Make sure you have the International package installed in your package manager
      2. Modify the url of your public facing page to include the appropriate language code which follows the format
        /l/(first three letters of language)/
            

      So for instance, to change public page fields to french, you would modify your url like so:

      http://salsa.democracyinaction.org/o/####/l/fre/p/salsa/web/common/public/signup?signup_page_KEY=####
         

      Or if you are using a base url:

      http://action.your-org.org/l/fre/p/salsa/web/common/public/signup?signup_page_KEY=####
          

      I have the international package, how do I collect international donations?

      The international package allows you to change the languages of your public facing pages, however it does not change the way you accept donations. In order to allow international donations you need to choose a gateway that allows these type of transactions.

      Was this article helpful?
      2 out of 2 found this helpful
      Have more questions? Submit a request

      Comments

      3 comments
      • It seems that a related page has been moved - the FAQ mentioned above (https://help.salsalabs.com/learn/packages/website-management/international-faq#h).

      • Hi there. I need to translate a targeted action and a page into Spanish but when I go to the tab shown in the screenshot above, there is no translate button there and I can't find any links/button that would do that. Can you help me out?

      • Hi Eli,

        The Internationalization package is not installed in Salsa by default. If you don't currently have it, please contact your Account Manager, who can help set up your organization with this package.  It should be an easy process for you.

        Best regards,

        Rebecca

      Please sign in to leave a comment.