Localization

 

Localization of PageCarton refers to the adaptation of web content to meet the language, cultural and other requirements of a specific target market. PageCarton has been made to support internationalization and so, it is ready to be localized into any such language which its users may want. This feature is supported from PageCarton 1.9 and above.

 

Locale Settings

You are able to set your preferred localization settings and how you want your site to behave in case where you have a visitor from some particular locale. 

• Default Locale - Sets the default locale which determines date and time formatting, decimal separator and system responses.
• Locale Options - Choose whether to 
   
  • Auto Translate Output Text - Choose whether to translate output text
  • Save new words - choose to save new words which are not currently translated into any local language
  • Auto-Detect Locale - Auto-detect locale through user browser.

View or Set Locale Settings

 

Translation

 

You are able to translate your site into any other language of choice. Here are the few steps to achieve this

 

1. Add new language locale to the Locale List on your site. 
    
   • Locale Name - would be the "English" name of the language to be added. e.g. Russian
   • Native Name - would be the local way of spelling the name of the language e.g. native name of "Russian" is "Русский", and the native name of "Yoruba" is "Yorùbá"
   • Locale Code - The internationalized locale code for the language being added. e.g. Russian is "ru_RU" and Yoruba is "yor"
     
     Add new Locale Manage Locale List
      
2. Put the right Settings up
   
   In the PageCarton Locale Settings, set Locale Options to "Save new words", and "Auto Translate Output Text".  This is to allow PageCarton to pick up words and get them ready to translation into the languages set in the Locale List. We wouldn't want to be inputing the words one by one, especially for sites loaded with a lot of words already. 
   
   View or Set Locale Settings


3. Auto populate words 
   
   Normally, all the site pages need to be previewed so that new words may be detected and added to the translation library. But then, to simply the process, PageCarton now has a widget that call all the pages and widgets automatically in other to invoke the right words into the words translation database. This is now as simple has just clicking a button
   
   Populate Words
    
4. Go to the Locale List to see the list of locale you have added on your site.
    
5. Now under any of the locale choose the one you wish to translate, click on "translations". This will bring up a list of all the populated words. Those would be the words set up for translation.
    
6. Pick the words one after the other and click on "translate" 
    
7. Enter the translation of the word into the space provided on the screen that opens up

 

Exporting Locale Translation

 

Once translation is done for words and phrases in a particular locale, it is possible to export the translation as a plugin and make it available for other users with PageCarton sites.

 

Building Language Plugin

The process of creating a plugin is easy and only a few steps:

 

• Go to My Plugins
  
  My Plugins
   
• Click on “Build New Plugins”
   
• Plugin Name could be the name of the Language e.g. “Russian Language Pack”
• Plugin Widgets can be left blank
• Settings can be left blank
• Databases of the words should be selected in “Database Data to Include in Plugin” databases to select should be
   
  • PageCarton_Locale
  • PageCarton_Locale_Originalstring
  • Page_Carton_Locale_Translation
     
• Documents should be left blank
• Pages should be left blank
• Click “Continue” to submit
• Close the pop up screen and the new added plugin should show in the My Plugins list.
• Click on “Download” to download this plugin to your device. The downloaded file should be a “tar.gz” archive

 

Installing the language on another site

 

• Go to Installed Plugins
  
  Installed Plugins
   
• Click on “Upload New” to upload the plugin you have downloaded to your computer/device. The file should be a “tar.gz” archive.
• Continue to Install and “Turn On” the plugin to enable the plugin
• Go to site Locale List and the new language should be listed
• Set the preferred language as default and change other “Locale Settings” to “Auto Translate Output Text” and “Auto-Detect Locale”
• PageCarton should now be displayed in the new language

Uploading Language Plugin to PageCarton Plugin Repository
 

• Go to PageCarton Plugins - https://plugins.pagecarton.org
  
  PageCarton Plugins Repository
   
• Click on upload
• Sign in / Sign up for a new account
• Continue to add a new plugin post into the "Languages" category
• That's it