Jump to content
KAZOOcon: hackathon signup and details here! ×
  • 2600Hz-logo-RGB copy.png

    Welcome our Monster UI Apps Resource Pages!
    Below is a list of the applications developed by 2600Hz for KAZOO using the Monster UI Interface and documentation related to it. 
    If you have a question that is not covered here, check out our community forums.  

          Featured Apps

      New Updates!    Check it out!     

               SmartPBX_x512.png          

              CallCenter-PRO_x512.png          

              PortingManager_x512.png          

             commio_AppIcon-updated_round_x512.png          

             \DynamicCallerID.png            

             CallThruUs_x512.png          

    Smart PBX

    Call Center Pro

    Porting Manager   Comm.land   Dynamic Caller ID CallThru.us

     

    >>  2600Hzroundorangelogo.png  Return to Monster Apps Home Page  

     

  • Language Pack Editor STEP Guide


     

    To download a .pdf, click the link below:
    Language Pack Editor - Step Guide.pdf 911.46 kB · 1 download

    2600HZ STEP GUIDE – LANGUAGE PACK EDITOR

    What is this?   

    Language packs provide localization for Kazoo apps.  The Language Pack Editor allows you to view, edit, and create language packs of your own in order to support your language of choice.  This guide contains step-by-step instructions for using the Language Pack Editor. 
     

     image.png
     

    English to German Translation, Underway! 

    The Language Pack Editor provides you with the terms to translate on the left and a field to enter your translation on the right: 

    image.png

    For simple menu items and titles, this is relatively straightforward.  But for other items, such as the following error messages, things get tricky: 

    image.png

     

    How would you know what to enter for "noMatchingNumbers"?  We'll dive into this more deeply later, but the short answer is that you can use the existing English translations as your guide.  In fact, the Language Pack Editor supplies "reference files" just for this purpose.  Here's a sample from an English reference file: 

     

    image.png

    Quick Steps 

    We'll be covering the following topics:   

    1. Accessing the Language Pack Editor 
    2. Creating a new language pack 
    3. Modifying your new language pack 
    4. Cloning an existing language pack 
    5. Submitting your completed language pack 
    6. Reference File shortcuts 
    7. Downloading all language packs

     

    1. Accessing the Language Pack Editor 

    image.png   From your Kazoo home page, select the Apps icon in the application bar. 

    Search for "Languages" using the search tool.  Open the app by clicking on the Languages icon.  

     

    image.png

    You should see the following screen: 

    image.png

    Each application can have one or more language packs.  You may use the search tool on this page to filter the applications based on your search criteria. 

     

    2. Creating a new language pack 

    There are a few ways of creating a new language pack.  We're going to start with the simplest way; starting from scratch. 

     Click on the app icon that you wish to localize: 

     

    image.png

    On the next page, select [ + New Language Pack ]: 

    image.png

    This will bring you to the main language pack editing screen:   

    image.png

    The language pack editor consists of three columns.   

    • The left-most column contains the Content Structure, which is useful for locating the page elements that you wish to add or edit.  You can click on any element in the Content Structure to jump to the corresponding value in the editor. 
    • The middle column contains the main editor.  Here's where you'll be entering your translations. 
    • The top of the middle column contains default working filename and a download button.  Ignore the filename and download button for now.  We'll cover those in just a moment. 

     

    image.png

     

    Selecting a Reference File 

    The right-most column is reserved for displaying reference files.  Reference files provide existing translations which can be helpful when adding new translations in the main editor.   

    image.png   Reference Files might sound fancy, but they're really just exiting language packs that are displayed side-by-side with the language packs that you're creating or editing. 

    It's likely that you'll want to use a reference file while creating your first language pack.  At the top of the right-most column, select a reference file from the drop-down menu: 

     

    image.png

    Once selected, the reference file will appear to the right of the main language pack editor: 

    image.png

    Adding Translations 

    At this point, you're ready to start adding your own translations to the form fields displayed in the middle column.  Go for it!  Any fields left blank will default to English in the application. 

     

     

    image.png

     It's a good idea to frequently download your language pack while you work to avoid any loss of work due to power outages, authentication timeous, etc.  See "Downloading Your Work" in the next section.  

    Downloading Your Work 

    At the top of the middle column in the Language Pack Editor, you'll see the default working filename and a download button.  We ignored these up until now. 

      image.png

    In order to save your work, you must download the active language pack to your computer.  Rename the working file name to something like "japanese-user-portal.json", ensuring that the filename ends in   .json , then click the Download button.  You'll be able to upload this file later if you need to make updates. 

     Next Steps 

    Now that you've completed entering all of your translations and have downloaded a local copy of the language file to your computer, you're ready to deliver that file to our staff for installation.  Continue to the section below titled "Submitting your completed language pack" for further instructions.  

     

    3. Modifying your new language pack 

    If you haven't already, please complete the tutorial above titled "Creating a new language pack".  That tutorial covers essential information about using the language pack editor and saving your work.  

    Open the Languages app and select the app associated with the language pack that you'd like to edit: 
     

    image.png

    On the next page, click on the browse button to locate your previously downloaded language pack: 

     

    image.png

    Select your previously saved language definition file.  The file selection dialog box may look different depending on your operating system: 

     

    image.png

    Click on Open to continue. 

     

    The previously saved language pack should now open and be editable in the language pack editor.   

    image.png

    (Please be aware that we do not currently provide a Japanese language pack.
    The Japanese shown is for illustration purposes only.) 

    It may be helpful to open a reference file while editing your language pack.   

    image.png

       For more information about reference files, please refer to the instructions under the section titled "Creating a new      language pack" above where reference files are introduced. 

     Once you have completed making updates to your language pack, download your language pack. 

    4. Cloning an existing language pack 

    This section assumes that you've completed the "Creating a new language pack" tutorial above.  If you haven't already, please complete that tutorial before proceeding. 

    This tutorial teaches you how to clone an existing language pack.  This may be useful if you wish to implement British English as opposed to American English, or customize an existing language pack to your own liking. 

    Open the Languages app and select the app associated with the language pack that you'd like to clone: 

    image.png

    On the next page, select [ + Clone Exiting Language Pack ]: 

    image.png

    You will be prompted to select an existing language pack to clone. 

      image.png

    Select a language pack and click on Clone Language Pack.  The language pack will load in the language pack editor to allow you to make changes: 

    image.png

    It may be helpful to open a reference file while editing your language pack.   

    image.png

      For more information about reference files, please refer to the instructions under the section titled "Creating a new language pack" above where reference files are introduced. 

     Once you have completed making updates to your language pack, download the modified language pack. 

     

    5. Submitting your completed language pack 

     Once you've completed editing your language pack, the next step is simple. Contact us! Our staff will be happy to review your language pack and add it to Kazoo. 

    6. Reference File shortcuts 

    On the Language Packs APP home page, you may have noticed a column called "Languages".  These buttons are shortcuts that: 

    • Create a new language pack 
    • Automatically open a reference file based on the button you select 

    image.png

    7. Downloading all language packs 

    Each app displayed on the Language Packs APP home page has a corresponding download button.  These buttons can be used to download all language packs associated with an app at once: 

     

    image.png

     

     

     

    Languages App - Step Guide (Emily Ransford).docx

    Edited by Emily R (show revisions)




    User Feedback

    Recommended Comments

    There are no comments to display.


×
×
  • Create New...