Get Free Trial
  1. API reference
Connecting to Data Source
Configuring the component
  • Documentation for older versions
  • Table of contents

    Localizing the component

    On our website, you can see an example of a localized version of Flexmonster Pivot in this demo: Localization. The component can be localized to Spanish, French, Italian, Portuguese, Mandarin, etc. The following article describes how the component can be localized.

    The default language for all text elements in the pivot table is English. The full process of component localization involves two steps:

    1. Create a localization JSON file
    2. Set the localization for the pivot table

    Step 1. Create your localization JSON file

    The localization JSON file is a JSON file that has a list of all texts and labels that are used in Flexmonster Pivot and can be localized.

    If you plan to use one of the localizations used in our demos, you are free to download the respective localization file from our site. Just click the file with language below or right click and save locally. Another option is to use a localization file from our CDN.

    If you have downloaded one of the above files, you can jump to Step 2. Set localization for Flexmonster Pivot.

    If you want to use a different language, it is possible to create your own localization file. We recommend using the English localization file as a template. Download it, make a copy, and replace all English texts with your own. After creating a new localization file, our team suggests sharing it with the community to help other users. New localization files can be added by creating a new pull request on GitHub. The Flexmonster team will highly appreciate any new localization files and add them to our website.

    In the following example, we localize the calculated value window in the pivot table to French.

    The original section of the localization file looks as follows.

    "calculatedView": {
    "measureBox": "Drag Values To Formula",
    "measureName": "Value name",
    "calculateIndividualValues": "Calculate individual values"
    }

    Now we replace the respective terms with French.

    "calculatedView": {
    "measureBox": "Deplacez valeur a la formule",
    "measureName": "Nom de la valeur",
    "calculateIndividualValues": "Calculer les valeurs individuelles"
    }

    Once the localization JSON file is loaded (see the next step), your pivot table should show the following changes in the calculated value view:

    calculatingViewFrench

    Your localization can be partial. For example, if you don’t need to localize the pivot table completely, you can replace only those JSON objects that you want to translate. If certain label translations are not mentioned in the localization JSON file, they will be set to their default English values.

    Step 2. Set localization for Flexmonster Pivot

    Localization can be set as inline JSON or a URL to the localization JSON file. To preset localization for all reports, set the localization property in the GlobalObject. Here is an example:

    URL to JSON

    new Flexmonster({
    container: "pivotContainer",
    global: {
    localization: "loc/fr.json"
    },
    ...
    });

    JSON

    new Flexmonster({
    container: "pivotContainer",
    global: {
    localization: {
    "calculatedView": {
    "measureBox": "Deplacez valeur a la formule",
    "measureName": "Nom de la valeur",
    "formula": "Formule"
    }
    }
    },
    ...
    });

    To specify different localization for a particular report, set the localization property in the report object. Here is an example:

    URL to JSON

    new Flexmonster({
    container: "pivotContainer",
    report: {
    localization: "loc/fr.json"
    },
    ...
    });

    JSON

    new Flexmonster({
    container: "pivotContainer",
    report: {
    localization: {
    "calculatedView": {
    "measureBox": "Deplacez valeur a la formule",
    "measureName": "Nom de la valeur",
    "formula": "Formule"
    }
    }
    },
    ...
    });

    Use a localization file from our CDN

    Instead of downloading a localization JSON file, you can localize the component with a file from our CDN. Just specify a URL to the needed localization file:

    For all reports

    new Flexmonster({
       container: "pivotContainer",   
       global: {
           localization: "https://cdn.flexmonster.com/loc/fr.json"
       },
       ...
    }); 

    For a particular report

    new Flexmonster({
       container: "pivotContainer",
       report: {
           localization: "https://cdn.flexmonster.com/loc/fr.json"
       },
       ...
    });

    Find a link to the file with your localization:

    • English: https://cdn.flexmonster.com/loc/en.json
    • German: https://cdn.flexmonster.com/loc/de.json
    • Español: https://cdn.flexmonster.com/loc/es.json
    • Français: https://cdn.flexmonster.com/loc/fr.json
    • Italiano: https://cdn.flexmonster.com/loc/it.json
    • Português: https://cdn.flexmonster.com/loc/pt.json
    • Chinese: https://cdn.flexmonster.com/loc/zh.json
    • Ukrainian: https://cdn.flexmonster.com/loc/uk.json
    • Magyar: https://cdn.flexmonster.com/loc/hu.json
    • Dutch: https://cdn.flexmonster.com/loc/nl.json
    • Turkish: https://cdn.flexmonster.com/loc/tr.json
    • Thai: https://cdn.flexmonster.com/loc/th.json
    • Indonesian: https://cdn.flexmonster.com/loc/id.json

    What’s next?

    You may be interested in the following articles: