Adding Translations

Translations can be added to common elements within TimeTap and those elements can be pushed to email templates using internationalized tag formatting.

For instance, let's say you have a position called "Baggage Claim" and you want to show that in your email template that sends out to the candidate in both English and in French Canadian. The standard tag for the position title is %REQ_JOBTITLE% , but you can provide as many translations that you'd like and depending on what language you're translating it to you can just provide the translation's locale code at the end of the tag.

So if you wanted to show your French Canadian translation of position title in the email template, the translation code for French Canadian is fr-CA, so the tag would be formatted as %REQ_JOBTITLE#fr-CA%

In this documentation, we're going to go through:

After reading through this documentation, you'll be familiar with how to define translations based on locales for different elements within TimeTap as well as the different tag formats for those different elements.

A full list of locales and locale codes are available here.




Providing translations for Location

If you go into a location's profile under Settings > Locations, you'll see little language icon next to the Location Name, Address, and Directions:

If you click on that icon next to any of those elements, you'll get a translation pop up window for that element:

In that pop up window, you'll see the option to pick the locale/language you want to translate for on the left and then enter the translation for that locale/language on the right.

If you wanted to translate the address of this location into French Canadian, for instance, you would first click the language icon next to the address field:

Then you would select the locale/language French Canadian from the locale dropdown:

Then you would type out the translation for the address in French Canadian under the Translation column:

Once you've typed that all in, click "Save Translation":

Now, if you wanted to display the location address in French Canadian on any of your email templates you would simply use the location address tag and append the appropriate locale before the closing percentage sign: %LOCATION_ADDRESS#fr-CA%

Please note: the syntax here is important. The locale code has to match the language selected in the translation window (see here for a full list of locale codes by language) and it has to come before the ending percentage sign, separated from the tag by a hash symbol #




Providing translations for Reasons

If you go into a reason's profile under Settings > Reasons, you'll see little language icon next to the Reason Name, Description, Instructions and Additional Instructions:



If you click on that icon next to any of those elements, you'll get a translation pop up window for that element. In that pop up window, you'll see the option to pick the locale/language you want to translate for on the left and then enter the translation for that locale/language on the right.

If you wanted to translate the name of this reason into French Canadian, for instance, you would first click the language icon next to the Reason Name field:

Then you would select the locale/language French Canadian from the locale dropdown:

Then you would type out the translation for the reason name in French Canadian under the Translation column:

Once you've typed that all in, click "Save Translation":

Now, if you wanted to display the Reason Name in French Canadian on any of your email templates you would simply use the reason name tag and append the appropriate locale before the closing percentage sign: %REASON#fr-CA%

Please note: the syntax here is important. The locale code has to match the language selected in the translation window (see here for a full list of locale codes by language) and it has to come before the ending percentage sign, separated from the tag by a hash symbol #

Helpful Hint

If you don't know the tag for a certain field, you can typically find out what it should be if you hover over the field name on the profile:




Providing translations for Positions

If you want to include positions in your email templates, the standard tag for the position title is %REQ_JOBTITLE%. You can also supply the position title in multiple languages by entering in translations for those languages.

To do this, go to the Positions menu on your account and find the position you want to translate for. Click the "Translate" button to the right of the position name:

This will bring up the translation window for that position. On the left you'll see the locale/language dropdown selection:

Select the language you want to translate for on the left and then enter the translation on the right:

Once you've entered all the translations you want to for that position title, click the button to Save Translation:

Now, if you wanted to display the Position Title in French Canadian on any of your email templates you would simply use the position title tag and append the appropriate locale before the closing percentage sign: %REQ_JOBTITLE#fr-CA%

Please note: the syntax here is important. The locale code has to match the language selected in the translation window (see here for a full list of locale codes by language) and it has to come before the ending percentage sign, separated from the tag by a hash symbol #




Providing translations for Dates and Times

Below is a table of date and time tags and their respective translations for French Canadian formats. If you want to use the French Canadian format in any of the email templates, simply use the French Canadian tag shown below:
Standard TagStandard Example TranslationFrench Canadian TagFrench Canadian Example Translation

%APPT_CLIENT_START_DATE_FULL%

Sunday, July 23, 2017

%APPT_CLIENT_START_DATE_FULL#fr-CA%

dimanche 23 juillet 2017

%APPT_CLIENT_START_TIME_FULL%

11:10:00 AM EDT

%APPT_CLIENT_START_TIME_FULL#fr-CA%

11 h 10 EDT

%APPT_CLIENT_START_DATE_LONG%

July 23, 2017

%APPT_CLIENT_START_DATE_LONG#fr-CA%

23 juillet 2017

%APPT_CLIENT_START_TIME_LONG%

11:10:00 AM EDT

%APPT_CLIENT_START_TIME_LONG#fr-CA%

11:10:00 EDT

%APPT_CLIENT_START_DATE_MEDIUM%

Jul 23, 2017

%APPT_CLIENT_START_DATE_MEDIUM#fr-CA%

2017-07-23
%APPT_CLIENT_START_TIME_MEDIUM%11:10:00 AM%APPT_CLIENT_START_TIME_MEDIUM#fr-CA%11:10:00
%APPT_CLIENT_START_DATE_SHORT%7/23/17%APPT_CLIENT_START_DATE_SHORT#fr-CA%17-07-23
%APPT_CLIENT_START_TIME_SHORT%11:10 AM%APPT_CLIENT_START_TIME_SHORT#fr-CA%11:10