next »

[alby]

Multilanguage CMSMS 1.X - Changelog

version 1.1.1  (29 Aug 2007):
- Improved patch of CMSMS MLE 1.02
- Update files to CMSMS 1.1.1


version 1.1.2  (05 Sep 2007):
- Update files to CMSMS 1.1.2
- For a quickly switch language insert flags list in:
  listcontent
  editcontent
  edithtmlblobs


version 1.1.3.1  (22 Sep 2007):
- Update files to CMSMS 1.1.3.1
- Update function.lang.php with same code of GetURL() of official release
- 05 Oct 2007: join in forge and a big thank you to katon for all work done 


version 1.1.4.1  (08 Oct 2007):
- Update files to CMSMS 1.1.4.1
- Add index.debug.php for debug in production site without change in config.php.
  For security, it's advisable that you rename to new "strange" newfilename.php that you know.
  You can check debug page while site works, substitute in url address index.php with newfilename.php


version 1.2  (19 Oct 2007):
- Update to CMSMS 1.2
- Bugfix: content block not working in prev releases because I forgot a modify from 1.1.2 
- Defined a $force_mle_default variable for force initial language
- Add function.concat_lang.php plugin


version 1.2.1  (28 Nov 2007):
- Update to CMSMS 1.2.1 + patch modifier.cms_date_format.php
- few bugfix
- mod_rewrite htaccess (doc/htaccess.txt) for CMSMS MLE (thanks to josin)
- separated backend/frontend cookies
- more logical define initial frontend lang
- add text and parent in config_lang
- new smarty $parent_lang vs DEPRECATED $currlang
- improved lang plugin:
  - add class parameter
  - add text parameter (request)
  - add urlparam parameter (request)
- Link content type multilingual: field url and target for each language (request)
- Visual tutorials
- EXTENDED version: add languages to metadata and description field


version 1.2.2  (03 Dec 2007):
- Update to CMSMS 1.2.2
- Enhanced freedom for language url. READ comment and example in config_lang.php.alby.label
- Improved User Interface (from 1.2.1):
  - View relative lang flag in add content/link/global content
  - Disable link of relative lang flag in edit content/link/global content


version 1.2.3  (03 Jan 2008):
- Update to CMSMS 1.2.3
- Little cosmetic changed


version 1.2.4  (31 Mar 2008):
- Update to CMSMS 1.2.4
- Display DEFAULT_LANG content (and/or content block="XXX" and/or global content) if content (and/or content block="XXX" and/or global content) in current language is empty (request)


version 1.2.4b  (13 Apr 2008):
- Display DEFAULT_LANG content was broken in MLE 1.2.4
- Display DEFAULT_LANG content is not default now (old behaviour) but you can enable the new behaviour with new param view_default in content and global content tag
- Add to cookies path/domain/secure
- Wiedmann patches for lang plugin
- Correct initial language selection


version 1.2.5  (18 May 2008):
- Update to CMSMS 1.2.5
- For display menu/content/GCB from DEFAULT_LANG if current lang is not ready use now a new global variable in config_lang: $default_lang_fallback. Remove old optional param view_default in 1.2.4b (Wiedmann).
- function lang: if config_lang is disabled you have official behavior
- ADODBLite UTF8
- Initial works on transform to UTF8


version 1.3  (7 Jun 2008):
Update to 1.3
Remove all flags (install apart, view multilang-flags)
Options are in DB preferences and not in config_lang.php file
Opacity for icons flag for no current langs
Minor change layout in admin
Bugfix: revert GetURL for W3C failure, set default content for Default Page


version 1.3.1  (25 Jun 2008):
Update to 1.3.1


Alby

[alby]

Mini Howto MLE - Installation/Upgrade

A) You have CMSMS MLE 1.02 installed and working
B) You don't have CMSMS or CMSMS MLE installed
C) You have CMSMS installed and working
D) You have CMSMS MLE 1.1.X/1.2.X/1.3.X and working (upgrade)



CASE A:
1. BACKUP
2. Download cmsms-mle-XXXX.tar.gz from FORGE
3. Upgrade with uncompress-overwrite MLE 1.02 file (see user doc also)
4. Edit config_lang.php.alby with your languages (see examples in file) and rename to config_lang.php (overwrite old config_lang)
5. Check if your site work


CASE B:
0. View Visual tutorials
1. Download cmsms-mle-XXXX.tar.gz from FORGE
2. DON'T RENAME config_lang.php.alby:
  - Installed like a normal CMSMS (see user doc also)
3. STOP: Check if your site work - It's a NORMAL CMSMS MONOLANGUAGE!
4. Now transform in MLE:
  - read README.FIRST file in root directory
  - if you want use icons flag, download icons flag from FORGE, create lang folder in root/images and uncompress in lang folder
  - edit config_lang.php.alby with your languages (see examples in file) and rename to config_lang.php
  - apply sql queries (see README.FIRST file or video tutorial)
5. NOW: Check if your site work in MLE mode


CASE C:
0. View Visual tutorials
1. BACKUP
2. Download cmsms-mle-XXXX.tar.gz (or diff-mle-vs-cmsms-XXXX.tar.gz if you have last release) from FORGE
3. DON'T RENAME config_lang.php.alby:
  - upgrade like a normal CMSMS and enter in admin area for ugrade your modules (see user doc also)
4. STOP: Check if your site work - It's a NORMAL CMSMS MONOLANGUAGE!
5. Now transform in MLE:
  - read README.FIRST file in root directory
  - if you want use icons flag, download icons flag from FORGE, create lang folder in root/images and uncompress in lang folder
  - edit config_lang.php.alby with your languages (see examples in file) and rename to config_lang.php
  - apply sql queries (see README.FIRST file or video tutorial)
6. NOW: Check if your site work in MLE mode


CASE D:
0. View Visual tutorials
1. BACKUP
2. Search in forum for "Known issues and fixes" topic for your CMSMS version
3. Download cmsms-mle-XXXX.tar.gz from FORGE
4. Look to Changelog of this version for info (prev post)
5. Upgrade with uncompress-overwrite file (see user doc also)
6. Check if your site work



OTHER:
- Question: "For the sql querys, I was able to make the change for number I. in the README.FIRST file but i am confused on what to for number II. and III."
- Answers:
  - Read this post
  - View Visual tutorials
  - Read "Installation and Trouble Shooting" doc (thanks to neelesh)

- Question: "There are a tricks for use one template and many languages"
- Answer: Follow from this topic, there are some trick


Alby

[alby]

Tips and Tricks - #1

I am not sure about 'locale'=>'xx_XX', Is this correct?


In Unix environment create a php file with this code (or if you have a shell access use:  locale -a  command):

Code:

<?php
$output = shell_exec('locale -a');
echo $output;
?>

send on server and go with your browser.
Check the locale strings. Choose locale string with utf8 if you use utf8.

In Windows environment, see this link for your locale string



- pixelenvy found a pretty exhaustive list of locale string.

- It's important that use locale languages contained in CMSMS translations (look in [cmsms_root]/admin/lang and [cmsms_root]modules/MODULE/lang) or post a request in Translations forum for your language inclusion.



Alby

[alby]

Tips and Tricks - #2

Can I switch from one language to another?

{lang} plugin (use in page template or content page) print language flag icons and relative link for language toggling.
There is a optional parameter "spacer" for flags separation or html layout
From 1.2.1 version there is a optional parameter "text" for display textual language switch (you MUST set the output text in config_lang.php lang array)

The img source tags of flag icons are defined in config_lang.php lang array
Language flag icons are in  [cmsms_root]/admin/images/lang  and  [cmsms_root]/images/lang

If not present check for new flags here

I choose png type for less problems in pdf conversion



Alby

[alby]

Tips and Tricks - #3

Are there languages tags/variables that I can use in page template or content page?

- Variable {$lang} is assigned to current locale language (ex. en_US, it_IT)
  Use this for general purpose.
  For example:
  smarty language parameter (ex: calling module):  lang="$lang"
  smarty language category (ex: News category):  category="General-$lang"
  language stylesheet (ex: style language dependant):  <div class="class-{$lang}">
  View in later Tips for this



- Variable {$currlang} (from 1.2.1 version USE {$parent_lang}) is assigned to parent locale language (ex. en, it)
  Use this in header DTD and metadata.
  For example, in template:
 

Code:

  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{$parent_lang}" lang="{$parent_lang}">
  <head>
    <meta http-equiv="Content-Language" content="{$parent_lang}" />
  </head>
 

  if current language is it_XX result:
 

Code:

  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="it" lang="it">
  <head>
    <meta http-equiv="Content-Language" content="it" />
  </head>
 

  and if current language is en_XX result:
 

Code:

  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta http-equiv="Content-Language" content="en" />
  </head>
 

Alby

[alby]

Tips and Tricks - #4

I don't want to display empty menu items if current language is not ready!

- In MenuManager template add this check: {if !empty($node->menutext)}

For example, with this simple menu (I add in red code):

{if $count > 0}
<ul>
{foreach from=$nodelist item=node}
{if !empty($node->menutext)}

{if $node->current == true}
<li><span class="currentpage">{$node->menutext}</span></li>

{else}
<li><a href="{$node->url}"{if $node->accesskey != ''} accesskey="{$node->accesskey}"{/if}{if $node->tabindex != ''} tabindex="{$node->tabindex}"{/if}{if $node->titleattribute != ''} title="{$node->titleattribute}"{/if}{if $node->target ne ""} target="{$node->target}"{/if}>{$node->menutext}</a></li>

{/if}

{/if}
{/foreach}
</ul>
{/if}

Alby

[manurevah]

i encountered a small issue with pages using GET values while the rest of the site is using pretty URLs, after banging my head against the edge of a sharp table numerous times i figured something out that works for me so hereis:

i have 2 templates that are identical except for {lang}, for the pages that ignore pretty urls and use GET variables i use {lang2}, a usertag and here are the contents to that

$myid=$_GET['myid'];  //Alby: it's  $_GET['lid'];
$page=$_GET['page'];

echo '
<a href="/index.php/?page='.$page.'&hl=fr&lid='.$myid.'">
<img alt="fr_FR" style="border: 0pt none ;" src="images/lang/fr_FR.png"/>
</a>
<a href="/index.php/?page='.$page.'&hl=en&lid='.$myid.'">
<img alt="en_US" style="border: 0pt none ;" src="images/lang/en_US.png"/>
</a>';

in this case i use $myid to do my thing, and $page used to define the page we are on.


--------------------------------------------------------------------
 I have modify this post for keep a CLEAN topic (Alby)
--------------------------------------------------------------------
1. You can try this also:  {lang2  lid="XXX"}
In this method, page is automatic and lid is fixed (XXX), page dependant ($page_alias) or GET dependant ($smarty.get.lid)
Work in WHOLE site (if pretty url are disabled) because lid can be empty

UDT lang2 code:

global $gCms;
global $hls;

$contentops =& $gCms->GetContentOperations();
$contentobj = $contentops->LoadContentFromId( $gCms->variables['content_id'] );
$alias = $contentobj->Alias();

$url = $gCms->config['root_url'].DIRECTORY_SEPARATOR.'index.php?'.$gCms->config['query_var'].'='.$alias;
if (! empty($params['lid'])) $url .= '&amp;lid='. $params['lid'];
if (isset($hls))
{
   foreach($hls as $key=>$mle)
   {
      echo '<a href="'. $url .'&amp;hl='. $key .'">'. $mle['flag'] .'</a>';
   }
}

2. FROM 1.2.1 version in lang tag there is urlparam parameter
use {lang urlparam="&amp;lid=XXXX"}

[neelesh]

Hi All,

I have created a document for the installation and some basic troubleshooting of CMSMS MLE ver 1.2.

You can view the document Installation and Trouble Shooting

Or you may aslo have a look at http://forum.cmsmadesimple.org/index.php/topic,16458.0.html

Thanks,
Neelesh

[alby]

Tips and Tricks - #5

Can I use different news to every language site?

For News module you can use this method:

Create one category for every languages. For example:
Home-en_US, Home-it_IT, Home-fr_FR, Home-nl_NL

In template call news module:
{news category="Home-$lang" .....other params....}



Alby

[alby]

Tips and Tricks - #6

Can I use different item (style/image/...) to every language site?

Look to #3, you can use $lang smarty variable for personalized your layout for every language.


Example: I want apply a different style css body and image background for every language:

In stylesheet:

/* This is the common code */
body {
   text-align: left;
   font-family: Verdana, Arial, sans-serif;
   background-color: #9734C3;
   background-attachment: fixed;
   background-repeat: repeat-x;
   background-position: center bottom;
}

/* This is the français and english code: different image, font-size and line-height */
#body-fr_FR {
   background-image: url(/images/bg-fr.gif);
   font-size: 75%;
   line-height: 1.4em;
}
#body-en_US {
   background-image: url(/images/bg-en.gif);
   font-size: 78%;
   line-height: 1.5em;
}

In template:

........
<body id="body-{$lang}">

........

</body>
</html>

Example: I want to have a different html img tag for every language:

- Prepare a img for every language and rename to something-locale (ex: header-en_US.png, header-nl_NL.png)
- In template:

Code:

<img src="header-{$lang}.png" />

Alby

[alby]

Tips and Tricks - #7

Can I display different text to every language site?

Yes for simple text in template or in module/tag with a calling param (check help if exist).

In mle folder there is a subdirecory lang. In this folder there are language files for whole site.
If not exist your locale.php file, copy from en_US.php to your locale file (ex: en_AU.php); open and add a new row in all your language files of your site (view example in file):

Code:

/*  'key'  =>  'string of your text',  */
'my_text_template' => 'translation_of_my_text_template_in_this_locale',
'you_are_here' => 'translation_of_you_are_here_in_this_locale',

best practices:
- for 'key' use normal, lower and no space character, it's a small string that remember your text;
- for 'string of your text' pay attention to your encode/charset (use a tool online, for example UTF-8) or transform your text in html entity (search in google for this or here there is a table conversion);

Tomorrow.................. I think for a complete db tool 


After use in template or in calling module/tag with {$mle_translation.key}:
Text in template:

.......
{$mle_translation.my_text_template}
.......

Calling module/tag:

{breadcrumbs starttext=`$mle_translation.you_are_here`}

Alby

[alby]

Tips and Tricks - #8

I have a problem with mysql with utf-8!

To fix this, you must changed mysql tables to use 165 for varchars.
moorezilla post here this tips.

Alby

[alby]

Tips and Tricks - #9

I want to display "default language" page if current language page is not ready (empty content)!


a. You want redirect to DEFAULT_LANG page. You can use a UDT:

1a. In Extensions > User Defined Tags create, click on Add User Defined Tag
2a. In Name: redirect_lang
      In Code:

Code:

global $gCms;
global $hls, $hl;

if ( (! empty($params['lang'])) && (array_key_exists($hls, $params['lang'])) )
$hl = $params['lang'];
else
$hl = DEFAULT_LANG;

if (! empty($params['to'])) $alias = $params['to'];
else
{
$pageinfo =& $gCms->variables['pageinfo'];
$alias = $pageinfo->content_id;
}


$config = &$gCms->GetConfig();
$contentops =& $gCms->GetContentOperations();
$contentobj = $contentops->LoadContentFromAlias( $alias );


if($config['assume_mod_rewrite'])
{
if($config['use_hierarchy'] == true) $_end_url_part = $contentobj->HierarchyPath().(isset($config['page_extension'])?$config['page_extension']:'.html');
else $_end_url_part = $alias .(isset($config['page_extension'])?$config['page_extension']:'.html');
$link_url = $config['root_url'].'/'.$hl.'/'.$_end_url_part;
}
else
{
if(isset($_SERVER['PHP_SELF']) && $config['internal_pretty_urls'] == true)
{
if($config['use_hierarchy'] == true) $_end_url_part = $contentobj->HierarchyPath().(isset($config['page_extension'])?$config['page_extension']:'.html');
else $_end_url_part = $alias .(isset($config['page_extension'])?$config['page_extension']:'.html');
$link_url = $config['root_url'].'/index.php/'.$hl.'/'.$_end_url_part;
}
else
{
$link_url = $config['root_url'].'/index.php?'.$config['query_var'].'='.$alias.'&hl='.$hl;
}
}
redirect($link_url);

3a. In your template substitute this code:

Code:

{content}

with:

Code:

{content assign='maincontent'}
{if $maincontent eq ''}{redirect_lang}{else}{$maincontent}{/if}

Optional parameters:
lang: overwrite DEFAULT_LANG of config_lang.php (default value). Ex: lang='es'
to: overwrite same page redirect (default value). It's a alias name page. Ex: to='new-page'




b. You want display DEFAULT_LANG (menu/content/content block="XXX"/global content) if other languages are not ready. (In 1.2.4 is broken!, in 1.2.4b are included with a param: view_default=1). From 1.2.5 you must set $default_lang_fallback to true in config_lang.php. From 1.3 set in Site Admin > Global Settings.



Alby

[alby]

Tips and Tricks - #10

How do "opacity" for no current lang icons flag!

Add in style of flag of languages array in config_lang.php a string (default:  opacity:1;).
If you set another string to replace, go to Site Admin > Global Settings and set this string.
Automaticaly opacity percent is 50, if you set another percent set always in Site Admin > Global Settings

Alby