The Joomla! Forum ™



Forum rules


Forum Rules
Absolute Beginner's Guide to Joomla! <-- please read before posting, this means YOU.
Forum Post Assistant - If you are serious about wanting help, you will use this tool to help you post.



Post new topic Reply to topic  [ 7 posts ] 
Author Message
PostPosted: Thu Dec 01, 2011 9:16 pm 
User avatar
Joomla! Enthusiast
Joomla! Enthusiast

Joined: Fri Aug 04, 2006 11:28 am
Posts: 142
Hi,

I'm confused, i thought admin ini files needed to go to:
/administrator/language/nl-NL/nl-NL.com_mycom.ini

and site ini files to:
/language/nl-NL/nl-NL.com_mycom.ini

But now I also see site files go to:
/components/com_mycom/language/nl-NL/nl-NL.com_mycom.ini

and a new file go to:
/language/nl-NL/nl-NL.ini

So now there are 3 places to put my extensions language files ?
Pls can someone tell me the official way for Joomla 1.7


Last edited by Alfred on Fri Dec 02, 2011 6:17 pm, edited 1 time in total.

Top
 Profile  
 
PostPosted: Fri Dec 02, 2011 6:56 am 
User avatar
Joomla! Master
Joomla! Master

Joined: Fri Aug 12, 2005 3:47 pm
Posts: 16630
Location: **Translation Matters**
Alfred wrote:
Hi,

I'm confused, i thought admin ini files needed to go to:
/administrator/language/nl-NL/nl-NL.com_mycom.ini

and site ini files to:
/language/nl-NL/nl-NL.com_mycom.ini

But now I also see site files go to:
/components/com_mycom/language/nl-NL/nl-NL.com_mycom.ini

and a new file go to:
/language/nl-NL/nl-NL.ini

So now there are 3 places to put my extensions language files ?
Pls can someone tell me the official way for Joomla 1.7

Not sure what you mean by
Quote:
and a new file go to:
/language/nl-NL/nl-NL.ini

Since 1.6 there are 2 ways to install language files for an extension.
One can use one or the other or a combination of both.

The 1.5 way will install the files in the CORE language folders (ROOT/administrator/language/ and ROOT/language/ ).
The new way —since 1.6— includes the files in a "language" folder installed at the root of the extension.

Therefore an extension can include a language folder with a .sys.ini different from the one installed in joomla core language folders (this last one not being included in that language folder but in root or any other folder not installed).
This let's display 2 different descriptions: one from the language folder is used as a message displayed when install has been done, the other is used for "normal" operation, i.e. when the extension is edited in back-end.
This can be extremely useful when installing also uses some scripts and requires a different value for the description.

Therefore, the xml would include since 1.6

Code:
<files>
<[...]
<folder>language</folder>  // This folder HAS to include the right subfolders, i.e. language/en-GB/ ... language/fr-FR/
<filename>whatever</filename>
[...]
</files>

and/or then (1.5 way):

Code:
<languages folder="joomlacorelanguagefolders"> // if using another language folder for cleanliness (any folder name will fit)
<language tag="en-GB">en-GB/en-GB.whatever.ini</language> // or
<language tag="en-GB">en-GB.whatever.ini</language> if no tagged subfolder
<language tag="en-GB">en-GB/en-GB.whatever.sys.ini</language> // or
<language tag="en-GB">en-GB.whatever.sys.ini</language> if no tagged subfolder
</languages>

OR simply in root

Code:
<languages>
<language tag="en-GB">en-GB.whatever.ini</language>
<language tag="en-GB">en-GB.whatever.sys.ini</language>
</languages>


When installing or upgrading the extension, it is the sys.ini file present in the extension root language folder which will display the result of the install from the description key/value.
Therefafter, if present, the sys.ini as well as the ini installed in CORE language folder will have priority over the files present in the root language folder of the extension.

Note:
One advantage of installing the files in the extension "language" folder is that these are not touched when updating a language pack.
The other advantage is that this folder can include multiple languages (en-GB always, fr-FR, it-IT, etc.) not requiring the user to install the corresponding language pack. This is handy as they are available if, later on, a user installs the corresponding pack.

_________________
Jean-Marie Simonet / infograf · http://www.info-graf.fr
Multilanguage in 2.5: http://help.joomla.org/files/EN-GB_multilang_tutorial.pdf
---------------------------------
Joomla Translation Coordination Team • Joomla! Production Working Group


Top
 Profile  
 
PostPosted: Fri Dec 02, 2011 2:12 pm 
User avatar
Joomla! Enthusiast
Joomla! Enthusiast

Joined: Fri Aug 04, 2006 11:28 am
Posts: 142
infograf768 wrote:
Not sure what you mean by
Quote:
and a new file go to:
/language/nl-NL/nl-NL.ini


In the Joomla 1.6 Component Tutorial, they now create a seperate ini file with a different naming convention (nl-NL.ini) in the /language/nl-NL folder just to hold the translations for install.

http://docs.joomla.org/Developing_a_Model-View-Controller_%28MVC%29_Component_for_Joomla!1.6_-_Part_08

I don't see the requirement for this 3rd location.


Top
 Profile  
 
PostPosted: Fri Dec 02, 2011 5:39 pm 
User avatar
Joomla! Master
Joomla! Master

Joined: Fri Aug 12, 2005 3:47 pm
Posts: 16630
Location: **Translation Matters**
It was a mistake.
I corrected the wiki and added the tutorial above. ;)

_________________
Jean-Marie Simonet / infograf · http://www.info-graf.fr
Multilanguage in 2.5: http://help.joomla.org/files/EN-GB_multilang_tutorial.pdf
---------------------------------
Joomla Translation Coordination Team • Joomla! Production Working Group


Top
 Profile  
 
PostPosted: Fri Dec 02, 2011 6:16 pm 
User avatar
Joomla! Enthusiast
Joomla! Enthusiast

Joined: Fri Aug 04, 2006 11:28 am
Posts: 142
Merci beaucoup


Top
 Profile  
 
PostPosted: Fri May 04, 2012 1:15 pm 
User avatar
Joomla! Intern
Joomla! Intern

Joined: Wed Sep 21, 2005 12:06 pm
Posts: 56
Location: Frederick, MD
I know this is an old thread but I need a little clarification please.

Quote:
The new way —since 1.6— includes the files in a "language" folder installed at the root of the extension.


By "root of the extension", do you mean the root of the front end (site/components/com_mycomponent/language) or do you mean root of the admin part of the component (site/administrator/components/com_mycomponent/language) or both?

_________________
~ Scott

The key to success is sincerity. Once you learn how to fake that you've got it made.


Top
 Profile  
 
PostPosted: Fri May 04, 2012 2:17 pm 
User avatar
Joomla! Master
Joomla! Master

Joined: Fri Aug 12, 2005 3:47 pm
Posts: 16630
Location: **Translation Matters**
Both.

_________________
Jean-Marie Simonet / infograf · http://www.info-graf.fr
Multilanguage in 2.5: http://help.joomla.org/files/EN-GB_multilang_tutorial.pdf
---------------------------------
Joomla Translation Coordination Team • Joomla! Production Working Group


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 7 posts ] 



Who is online

Users browsing this forum: No registered users and 10 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Jump to:  
Powered by phpBB® Forum Software © phpBB Group