[PrestaShop][Language][EN] Deep into the translation of modules and system in PrestaShop (Final Episode) Part 2

[PrestaShop][Language][EN] Deep into the translation of modules and system in PrestaShop (Final Episode) Part 2

In the last episode of translations in prestashop, you will see the structure of theme as follows,

The structure of folder Lang from theme for instance, \themes\ap_office\lang. it is the last folder that I will explain.

Please look at below

global $_LANG; 
$_LANG = array(); 

$_LANG['404_d0fbda9855d118740f1105334305c126'] = 'Page not found'; 
$_LANG['404_44b1d05764b093cb00c25b8228cb87d3'] = 'This page is not available'; 
$_LANG['addresses_d95cf4ab2cbf1dfb63f066b50558b07d'] = 'My account'; 
$_LANG['addresses_e45be0a0d4a0b62b15694c1a631e6e62'] = 'My addresses'; 

For the language in which is written by theme that It has a new variable, so you will see the name is $_LANG, and the name as a variable that controls all of messages to express on all screen that more details as below.

$_LANG['addresses_e45be0a0d4a0b62b15694c1a631e6e62'] = 'My addresses'; 

$_LANG means a variable

addresses_ means an action or a template file(*.tpl) that is expected a relations of expression on screen for this example you will see a relation of language and addresses.tpl that contains a command or sentence for instance,

{l s='My addresses'}  you will see the language tag is too small detail, moreover you may not write mod(ule) tag concatenates the language tag.

e45be0a0d4a0b62b15694c1a631e6e62 means MD5 of My addresses

'My addresses' means a message or string to express on screen

          The concluding of explaining translation language, you will see the prestashop that is designed for support multilingual or using multiple language website as well as comfortable.

even though, there are more parts of language I won’t explain but it has more important as good as template file that is a language of database, as if I have never explained on the other hand you can write and save many languages on the screen of prestashop system that the system provided a part of optional language too, furthermore, you will write more details and more languages If you want to express it.

Hopefully, All the articles that I wrote, It will explain you so that you will understand in mechanism of multilingual in prestashop as well as possible. If you have some question you can send a message for me. I glad to meet you all guys.

WindowsDNA wrote.

[PrestaShop][Language][EN] Deep into the translation of modules and system in PrestaShop (Final Episode) Part 1

[PrestaShop][Language][EN] Deep into the translation of modules and system in PrestaShop (Final Episode) Part 1

          Folder both Translations and Lang that there are more different structure, Today, I will explain all of structures to you so that you would try to use its correction and automation if you use with Prestashop Automatic Translations with google.

The structure of translations from system for instance, \translations\en\admin.php

global $_LANGADM; 
$_LANGADM = array(); 

$_LANGADM['AdminAddressesd3b206d196cd6be3a2764c1fb90b200f'] = 'Delete selected'; 
$_LANGADM['AdminAddressese25f0ecd41211b01c83e5fec41df4fe7'] = 'Delete selected items?'; 
$_LANGADM['AdminAddressesb718adec73e04ce3ec720dd11a06a308'] = 'ID'; 

If variables as a part of admin section or it’s an expression a message from backend zone that it will use variable name is $_LANGADM

$_LANGADM['AdminAddressesd3b206d196cd6be3a2764c1fb90b200f'] = 'Delete selected'; 

$_LANGADM means a name of variable

AdminAddresses means module’s name which express with each part

d3b206d196cd6be3a2764c1fb90b200f means MD5 of a message’s name is ‘Delete selected’

'Delete selected' means a message that you want to express on the screen

Although, It has many variables for admin section as if $_ERRORS, $_FIELDS, $_LANGPDF except $_TABS, so It contains a key without encrypt with MD5

the structure of translations from module for instance, fbconnect_psb\translations

global $_MODULE; 
$_MODULE = array(); 
$_MODULE['<{fbconnect_psb}prestashop>registration_fb_6335a00a08fde0fbb8f6d6630cdadd92'] = 'ข้อมูลส่วนบุคคล'; 
$_MODULE['<{fbconnect_psb}prestashop>registration_fb_b78a3223503896721cca1303f776159b'] = 'คำนำหน้า'; 

You will see the structure that It has a different variable which the prestashop system use a name of variable called $_MODULE as follows,

$_MODULE['<{fbconnect_psb}prestashop>registration_fb_6335a00a08fde0fbb8f6d6630cdadd92'] = 'ข้อมูลส่วนบุคคล'; 

$_MODULE means a name’s variable for get value of language

<{fbconnect_psb}prestashop>registration_fb_ means the key that is a part of language’s express and there are covered 3 attributes such as,

·       {fbconnect_psb} means a module name

·       <prestashop> means a Tag of prestashop

·       registration_fb means an action or a part of template file (*.tpl)

When 3 attributes compound, the language file will support module that have a several template files with only one file.

PS1: Even though, it contains the same word, but it is different template file. You must write a new key of template file.

PS2: For example a template file, you will see a statement as bellow,

{l s='Your personal information' mod='fbconnect_psb'}

It means a l(anguage) that contains s(tring) name is ‘Your personal information’ in a part of mod(ule) name is fbconnect_psb that It relates with en.php or th.php from the explanation above.

6335a00a08fde0fbb8f6d6630cdadd92   means MD5 of a message name is “ข้อมูลส่วนบุคคล”

'ข้อมูลส่วนบุคคล' means a message you want to express on the screen

to be continued...

http://windowsdna.blogspot.com/2015/06/prestashoplanguageen-deep-into_21.html

[PrestaShop][Language] เจาะลึกกับ Translations ในส่วนของ Module และ ระบบ

[PrestaShop][Language] เจาะลึกกับ Translations ในส่วนของ Module และ ระบบ (ภาคจบ)

          ใน Folder Translations และ Lang นั้น มีโครงสร้างที่แตกต่างกัน วันนี้จะขออธิบายโครงสร้างทั้งหมด เพื่อให้ทุกท่านได้ลองใช้งานกันได้ถูกต้องและเป็นอัตโนมัติ หากใช้งานคู่กับ Prestashop Automatic Translations with Google

โครงสร้าง translations จากระบบ ตัวอย่างเช่น \translations\en\admin.php

global $_LANGADM; 
$_LANGADM = array(); 

$_LANGADM['AdminAddressesd3b206d196cd6be3a2764c1fb90b200f'] = 'Delete selected'; 
$_LANGADM['AdminAddressese25f0ecd41211b01c83e5fec41df4fe7'] = 'Delete selected items?'; 
$_LANGADM['AdminAddressesb718adec73e04ce3ec720dd11a06a308'] = 'ID'; 

หากเป็นตัวแปรของ admin หรือทำหน้าที่แสดงข้อความจากส่วน Backend นั้นจะใช้ ตัวแปรชื่อว่า $_LANGADM โดยมีส่วนประกอบดังนี้

$_LANGADM['AdminAddressesd3b206d196cd6be3a2764c1fb90b200f'] = 'Delete selected'; 

$_LANGADM คือ ชื่อตัวแปร

AdminAddresses คือ ชื่อโมดูลที่แสดงผลในแต่ละส่วน

d3b206d196cd6be3a2764c1fb90b200f คือ  MD5 ของข้อความ ‘Delete selected’

'Delete selected' คือ ข้อความที่ต้องการแสดงผล

ทั้งนี้ยังมีอีกหลาย ๆ ตัวแปรสำหรับส่วนของ admin ไม่ว่าจะเป็น $_ERRORS, $_FIELDS, $_LANGPDF ยกเว้นแต่ $_TABS จะระบุ Key ที่ไม่ต้องการ Encrypt ด้วย MD5

โครงสร้าง translations จากโมดูล ตัวอย่างเช่น fbconnect_psb\translations

global $_MODULE; 
$_MODULE = array(); 
$_MODULE['<{fbconnect_psb}prestashop>registration_fb_6335a00a08fde0fbb8f6d6630cdadd92'] = 'ข้อมูลส่วนบุคคล'; 
$_MODULE['<{fbconnect_psb}prestashop>registration_fb_b78a3223503896721cca1303f776159b'] = 'คำนำหน้า'; 

จะสังเกตุได้ว่า โครงสร้าง Translations ของ โมดูลนั้น จะมีตัวแปรที่แตกต่างออกไป ซึ่งระบบใน Prestashop เลือกใช้เป็นตัวแปรชื่อ $_MODULE โดยมีรายละเอียดดังนี้

$_MODULE['<{fbconnect_psb}prestashop>registration_fb_6335a00a08fde0fbb8f6d6630cdadd92'] = 'ข้อมูลส่วนบุคคล'; 

$_MODULE คือ ตัวแปรสำหรับเก็บภาษา

<{fbconnect_psb}prestashop>registration_fb_ คือ Key ของการแสดงผลของภาษาในแต่ละส่วน โดยจะมีส่วนประกอบย่อยดังนี้

·       {fbconnect_psb} ชื่อโมดูล

·       <prestashop> คือ Tag

·       registration_fb คือ Action หรือ template File(*.tpl) ของแต่ละหน้าจอของโมดูลนั้น ๆ

เมื่อ 3 ส่วนนี้ประกอบเข้าด้วยกัน จะรองรับ Module ที่มี Template หลาย ๆ หน้าจอได้ ด้วย translation ไฟล์เดียว

** ข้อสำคัญ ถึงแม้ว่าจะมีคำ ๆ เดียวกัน แต่ต่างกันระหว่าง Template จำเป็นจะต้องเขียน Key ที่แตกต่างกันด้วย

*** สำหรับ ไฟล์ Template (*.tpl) จะเห็นวิธีการเขียนการแสดงผลของข้อความเป็นดังนี้

{l s='Your personal information' mod='fbconnect_psb'}

หมายความว่า l(anguage) ที่มีข้อความ s(tring) ชื่อ Your personal information ในส่วนของ mod(ule) ชื่อว่า fbconnect_psb ซึ่งจะสัมพันธ์กับ en.php หรือ th.php ในคำอธิบายด้านบน

6335a00a08fde0fbb8f6d6630cdadd92 คือ MD5 ของข้อความ “ข้อมูลส่วนบุคคล”

'ข้อมูลส่วนบุคคล'คือ ข้อความที่ต้องการแสดงผล

โครงสร้าง lang จาก theme ตัวอย่างเช่น \themes\ap_office\lang ซึ่งเป็นตัวอย่างสุดท้าย

global $_LANG; 
$_LANG = array(); 

$_LANG['404_d0fbda9855d118740f1105334305c126'] = 'Page not found'; 
$_LANG['404_44b1d05764b093cb00c25b8228cb87d3'] = 'This page is not available'; 
$_LANG['addresses_d95cf4ab2cbf1dfb63f066b50558b07d'] = 'My account'; 
$_LANG['addresses_e45be0a0d4a0b62b15694c1a631e6e62'] = 'My addresses'; 

สำหรับ language ที่ได้เขียนผ่าน theme นั้น จะมีลักษณะ ตัวแปรใหม่ ซึ่งเราจะเห็นว่าใช้ตัวแปรชื่อ $_LANG โดยที่ตัวแปรนี้จะควบคุมการแสดงผลทั้งหมดของ THEME โดยมีรายละเอียดดังนี้

$_LANG['addresses_e45be0a0d4a0b62b15694c1a631e6e62'] = 'My addresses'; 

$_LANG คือตัวแปร

addresses_ คือ Action หรือ Template File(*.tpl) ในการกำหนดความสัมพันธ์ของการแสดงผลในหน้าจอ เช่นตัวอย่างนี้จะสัมพันธ์กับ addesses.tpl ซึ่งภายในไฟล์จะเขียนคำสั่งในการแสดงผลในตัวอย่างนี้

{l s='My addresses'} จะเห็นได้ว่าเป็น Language ย่อส่วนโดยไม่ต้องระบุ mod(ule) ต่อท้าย เพราะใช้ไฟล์ language โดยรวมของ theme ไปแล้ว

e45be0a0d4a0b62b15694c1a631e6e62 คือ MD5 ของ My addresses

'My addresses' คือ ค่าที่ต้องการแสดงข้อความผ่านหน้าจอต่าง ๆ

          สรุปโดยรวม จะเห็นได้ว่า การออกแบบ Prestashop นั้นได้ถูกออกแบบมาเพื่อรองรับ Multilingual หรือการทำเว็บไซต์หลายภาษามาเป็นอย่างดี อย่างไรก็ตามจะมี Language อื่น ๆ ที่ไม่ได้กล่าวถึง แต่ก็มีส่วนสำคัญคือ Language ใน Database แต่ที่ไม่กล่าวถึงเนื่องจาก ทุกท่านสามารถบันทึกผ่านหน้าจอของระบบได้เลย โดยที่ระบบจะมีให้เลือกบันทึกข้อความผ่าน language แต่ละส่วนด้วยเช่นกัน เพื่อให้ เนื้อหาที่แสดงในหน้าจอนั้นมีความครบถ้วนในทุก ๆ ภาษาที่ผู้เขียนต้องการจะสื่อ

หวังเป็นอย่างยิ่งว่า บทความนี้จะทำให้ทุกท่านเข้าใจใน กลไก การทำงานหลายภาษาของ Prastashop ได้เป็นอย่างดี หากมีข้อสงสัย ส่งข้อความสอบถามได้ครับ ยินดีต้อนรับทุกท่าน

[PrestaShop][EN]Let’s start to use PrestaShop Automatic Translations.

[Installation][PrestaShop] Using PrestaShop Translations with web hosting, it’s always found some problem in translation module as follows:

PHP message (some hosting)

Warning! Your hosting provider is using the Suhosin patch for PHP, which limits the maximum number of fields allowed in a form: 1000 สำหรับ suhosin.post.max_vars

1000 สำหรับ suhosin.request.max_vars

Please ask your hosting provider to increase the Suhosin limit to 3603 at least, or you will have to edit the translation files.

Future more, when you translate other languages you will always have many problems and you need to spend a lot of time to translate by yourselves, so I have developed a small application for translating both of translate individual and translate with google translation for easy to use it.

Finally, it’s free for used.

Let’s start to use PrestaShop Automatic Translations.

Download

https://drive.google.com/file/d/0B1_jeVY3PqQERTlsRUtwVkVQS2M/view?usp=sharing

[PrestaShop][EN] Describing more detail in structure of PrestaShop for people who want to write PrestaShop in Multilanguage Part 2

          The latest blog, you have known about structure in PrestaShop for using Multilanguage or dynamic language after that I will explain more information in this structure that how the structure is.  For understanding before you customize the PrestaShop by yourself

admin.php File from folder translations

$_LANGADM['AdminCartRulesd3b206d196cd6be3a2764c1fb90b200f'] = 'Delete selected';

Explaining the structure

$_LANGADM is a variable called Array

'AdminCartRulesd3b206d196cd6be3a2764c1fb90b200f' is the key of the Array it is a part of module and md5 string

d3b206d196cd6be3a2764c1fb90b200f is MD5 of string such as Delete selected = d3b206d196cd6be3a2764c1fb90b200f

‘Delete selected’; is value of the word or statement from Array

For example;

If you change the word from ‘Delete selected’ to ‘selected to delete’, the word on the screen display will be changed. Absolutely, if you want to translate other language you can do this.

For example: changing the language

$_LANGADM['AdminCartRulesd3b206d196cd6be3a2764c1fb90b200f'] = ' Sil seçili '; // turkish

P.S. It is more important, when you change value of key of the Array, you must not change md5 key that the key is ‘Delete selected’ encrypted.

On next paragraph, I will explain more detail for key md5 (read more ***)

a template file from modules, in this case, I choose blockuserinfo module. when you open folder blockuserinfo on ‘\modules\blockuserinfo’ you will look .tpl file at that folder, surely, filename .tpl is a PHP Smarty template that is on views folder or outside that folder.

For example: PHP Smarty Template

<p id="header_user_info">                         {l s='Welcome' mod='blockuserinfo'}                         {if $logged}                                      <a href="{$link->getPageLink('my-account', true)|escape:'html'}" title="{l s='View my customer account' mod='blockuserinfo'}" class="account" rel="nofollow"><span>{$cookie->customer_firstname} {$cookie->customer_lastname}</span></a>                                      <a href="{$link->getPageLink('index', true, NULL, "mylogout")|escape:'html'}" title="{l s='Log me out' mod='blockuserinfo'}" class="logout" rel="nofollow">{l s='Sign out' mod='blockuserinfo'}</a>                         {else}                                      <a href="{$link->getPageLink('my-account', true)|escape:'html'}" title="{l s='Log in to your customer account' mod='blockuserinfo'}" class="login" rel="nofollow">{l s='Sign in' mod='blockuserinfo'}</a>                         {/if}             </p>

In the structure .tpl, the file that contains tag for display Multilanguage on screen as follows;

{l s='Welcome' mod='blockuserinfo'}

{l s='View my customer account' mod='blockuserinfo'}

{l s='Log me out' mod='blockuserinfo'}

{l s='Log in to your customer account' mod='blockuserinfo'}

{l s='Sign in' mod='blockuserinfo'}

Describing:

{} is a tag for display from PHP smarty

l is a language

s is a string or sentence

mod is a module name

Normally, writing tag in smarty template I will always write in an English for standardization, so it’s meaning I have never written en.php file. Even though, some module write tag smarty not standardization I need to write en.php file too.

Be careful, writing “ l s=’String key’ from native language you must encrypt md5 from that language.

Next session, I will explain a relation of translations and module with .tpl and .php

Tags:

Admin, Introduction, Language, Module, Multilanguage, PHP, PrestaShop, Smarty, Translation, 

Writer:

WindowsDNA