International deployment guide
Customers with global dealer networks often have a similarly global website or websites that serve an international audience with multiple languages and countries. This article discusses the steps required to deploy MetaLocator in a typical global scenario.
Step 1 - Create a multi-language Interface
When users visit your locator from a different country they will want to see the locator in their preferred language. This involves updating your Interface to use [Language Constants](https://suFew readersTranslating Category Labels
If you have a multilingual setup, and want to provide language translations for your Category names, you do not have to create new categories for each language.
Follow the steps in this tutorial to properly format and translate your Category labels.
When rendering your category labels, MetaLocator will look for a "language constant" following this format:
LOCATOR_CATEGORY_SAFENAME
Where "SAFENAME" is the category name with special characters and spaces removed. So, if your category is "DealFew readersIntegrating a user language preference with MetaLocator
If your website offers content in multiple languages, it is common practice to allow the user to choose their preferred language. Similarly, MetaLocator offers the ability to change language dynamically. This article discusses passing the user's choice of language on your Website to the MetaLocator application embedded within your Website.
This article discusses javascript and technical topics and should be implemented with the help of your Webmaster. MetaLocator manages translations inFew readersChanging the state prompt value on the location form
State names can be changed by translating the drop-down list values in the language files.
See the section Translating drop-down list prompt values in the article:
https://support.metalocator.com/en/articles/1655828-introduction-to-managing-language-and-translation#translating-drop-down-list-prompt-valuesFew readersManaging translations in bulk
The bulk language editor allows users to download the entire language file for easy sharing and export.
To access the bulk language editor, click Languages on the main application navigation as shown below:
[](https://downloads.intercomcdn.com/i/o/139803312/6a55217bfe8147ae4dfd8fcc/image.png?expires=1794512700&signature=e33223f6b275985a65355514327149dcb8f8882e6977c97fFew readersDisplaying your locations in multiple languages
Take the following general steps to offer your locations in multiple languages:
Create an import spreadsheet with each location listed once for each language, containing the appropriately translated content. As in this example that shows one physical location, entered once for English and once for Spanish.
Use the language field to enter English or Spanish (Español if you prefer).
If the locations are actually located in different countries, be sure to assign the correct TLD for eachFew readersChanging the default country
Most MetaLocator interfaces default to the United States when searching by postal code. lf your locator is focused on a single country, you can update the Base TLD setting to your preferred country:
[](https://downloads.intercomcdn.com/i/o/546109393/0aa43b637f9984f84432d6d5/image.png?expires=1794512700&signature=a6602fc0523c744cdafca7d8591491d0777bfaaedc25fb14156f4d4f19ab29Few readersInternationalization Guide
MetaLocator provides the capability to change nearly all customer-facing language. These language strings are stored in language files named according to the language code they are associated with. To view language files in your account, click Language on the control panel main menu as shown below:
[](https://downloads.intercomcdn.com/i/o/214428044/535cfcc4814c7ff349c42f00Few readersIntroduction to Managing Language and Translation
MetaLocator allows you to control all customer facing language. This includes items like the words 'Submit', 'Reset' and 'Postal Code' as shown here:
[](https://downloads.intercomcdn.com/i/o/565423346/05a28b47e06a156c9d031e9d/image.png?expires=1794512700&signature=e26a36cce5b6ebe6fcd5b8e64690c76d86f6af169003b9c633b824c99e6e3ec6&req=cSYiEst9noVZFb4f3HP0gPJL6cr%2FhDbYMNjDBe7kFew readersChanging address field ordering by locale
Some country's mailing standards include variations on address field ordering and formatting.
Some countries place the postal code before the city, others after. Some include commas, others hyphens and so on.
To account for these address formatting differences, a combination of MetaLocator's field templates and language files can be leveraged.
First, update the "Full Address" field to use the International template as shown below:
[![](https://storage.crisp.chat/users/helpdesk/website/-/4/9/Few readersWhy is my country list empty or incomplete?
Drop-down lists on the search screen are build entirely by the data in your location records. Data in your location records are build entirely by the data that is imported or added on the location add/edit screen.
The geocoding process can interpret less-than-complete locations, and place a location in a country when the "Country" field was not provided during the import or added to the location manually. This will not add the "Country" to the list of countries available on the search screen.Few readersInternational Notes
Data TLD: The TLD, or Top Level Domain of your locations should be set according to the country the locations are in. The TLD adds a bias to our search and geocoding service for the most accurate geocoding possible. For a complete list of TLDs available, click here. When importing your locations, ensure the TLD column has the appropriate two-letter value obtained from the spreadsheet. For example importing a location in the UFew readersTranslating Labels
The MetaLocator search form allows complete control over the text displayed to the end user. This control is facilitated by the Language feature found in the Control Panel. To change the name of a standard control, take the following steps:
What are Language Constants?
Language constants are short all upper case variables without spaces or numbers and prefixed with "LOCATOR_". These are set by the system automatically for many fields, categories, and error messages. These can be found undFew readersAdding content to the "No results" message
When no results are found for a user's search, you may want to provide alternative messaging that prompt users to call your location, buy online or similar content other than "No results found". This can be done by modifying the setting found under Results, No Results Message as shown below.
[](https://downloads.intercomcdn.com/i/o/304628141/7629cc79acc31af60d7a0aFew readers