26 December, 2011

PayPlans Language file Tips

Today, we are here to talk about PayPlans language file queries, problems which users usually come across while dealing with language file. After lot of observations, we feel people either get confused with how to make changes in components language file or how to use Non-English language files for PayPlans. Sometimes admin make changes in main language file of PayPlans, which later creates issue.

Here through this blog post, we will try to clear out all your confusions and mistakes regarding PayPlans language files. The things which we are going to discuss now, will help you not only with PayPlans but might help you in all general language files.

PayPlans by default is available in English language. Now let's start discussing issues and their solutions one by one :

CASE 1 : If I want to change text of any string in language file of PayPlans, then what to do?

  • Should I directly make change in PayPlans respective language file? ˣ

If you directly make change in PayPlans language file, then when you install the upgrade version of PayPlans, PayPlans language file in upgraded version will overwrite your changes. Hence, you will lose all the language file changes you made earlier.

  • Should I follow some other approach like language overriding? ހ

Yes, the best approach is to use language override concept. Here you have to create another file which is an override language file. Now, lines which you want to change in PayPlans, copy those strings in this override file and write text as you desire for those strings and save it. This way your changes will not be affected at all on installing upgraded version of PayPlans.

How and where to make this override file?

Your Answer lies in documentation of changing text in Language file.

CASE 2 : Is PayPlans available in other languages also like French, Spanish, etc? If yes, then where can i find PayPlans language files in different languages and how to utilize them?

Solution : Follow steps :

( You need to first install language pack for the language in which you want your site and make it default from language manager. )

1. You can find PayPlans language files (which includes language files for frontend, admin and  additional plug-ins) in other languages at Transifex.

2. Just login at transifex (if you have account on Transifex or if not, you can sign up for free) and among available languages, choose your desired language team and download PayPlans language files. Downloading will cost you nothing.

3. With proper naming (as per naming convention used in language pack) of downloaded language file, copy and paste it in respective language pack folder.

4. Suppose if you are using french language, then copy and paste PayPlans admin-french language file (fr_FR) in ROOT // administrator // languages // fr-FR and copy and paste PayPlans frontend french language file in ROOT // languages // fr-FR.

CASE 3 : (From translator point of view) I updated (for example) french language file of PayPlans. Though frontend french language file of PayPlans is able to load properly but admin french language file of PayPlans is not loading. I am not able to see effects of french file in PayPlans admin, it is still in English. Why?

Solutions and tips : If such an issue occurs for any of the language file, then first ask a question to yourself - Whether I made any mistake in language file? You might get an answer - No.

But here you need to cross verify your language file (in your case french language file of PayPlans-admin). Here are some of our observations about the places where people usually made mistakes :

  • Check for double "equals to", if you have mistakenly used "equals to" two times continuously i.e. "==". You must have not used double equals to.

payplans-double-equals-to1


  • Text should lie in between two double quotes. Sometimes we forget to put text in between the 2 double quotes and thats why that particular text will not be able to show its effect on the site.

payplans-textinquotes


  • People usually start text with double quote but forget or miss to end text with double quote. Make sure to close text for every string with double quote otherwise language file will not be loaded at your end.

payplans-end-double-quote


  • Space should not be provided at the start of any string otherwise language file will not be loaded and you will not be able to see the effect of this language file.


  • "_QQ_" should be used only when you want to display double quotes. Don't use "_QQ_" in place of starting and ending double quotes which are used to define a string.  Let's take an example :
  1. Putting double quotes at the start and end of text in each string is necessary to load that text.

payplans-quotes

Result of string in above screenshot will be : It will display -> Create a New Instance of Application

2.  Now, if you replace starting and ending double quotes with "_QQ_", then it will not load the text written between them. Starting and ending double quotes are necessary to display text.

payplans-withqq

Result of above screenshot : It will not display the text -> Create a New Instance of Application

3.  If you want to display double quotes also, then first use starting and ending doubles quotes to load the written text and then use "_QQ_" to display double quotes.

payplans-quoteswithqq

Result of string in above screenshot will be : It will display -> "Create a New Instance of Application"

We tried to put some of the tips regarding language file through this post. If you want to go deeper into joomla language files and their formats, you can refer below mentioned links :

http://docs.joomla.org/Specification_of_language_files

http://docs.joomla.org/Making_a_Language_Pack_for_Joomla_1.6

http://docs.kunena.org/index.php/Joomla_1.6_quote_language_files

http://www.ostraining.com/blog/joomla/translating-and-modifying-joomlas-language-files-using-language-overrides/

blog comments powered by Disqus