Languages

From Zen Cart(tm) Wiki
Revision as of 23:46, 1 December 2005 by Dwno (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

{{Template::menuBarCustomising}}


Introduction

Translations are done on a volounteer basis, so the quality and even installation instructions may vary.
You are always welcome to help improve a translation, by either making your suggestions known to the author of the translation or by making your wanted changes yourself.


Installing a language pack

  1. Download the language pack
  2. Upload the files and directories to your server
  3. Go to Admin > Localization > Languages and click the "new language" button, then fill in the details and make sure you put the correct directory in "Directory" with proper case - 'English' is not the same as 'english'.


Make sure that the files and directories are uploaded to the appropriate places, which are:

  • includes/languages/<your language>.php
  • includes/languages/<your language>/
  • admin/includes/languages/<your language>.php
  • admin/includes/languages/<your language>/
  • includes/templates/template_default/buttons/<your language>/


Creating a new translation

Read this FAQ entry to learn how to properly edit text definitions.


The following files and directories with subdirectories should all be translated and included in the language pack

  • includes/languages/<your language>.php
  • includes/languages/<your language>/
  • admin/includes/languages/<your language>.php
  • admin/includes/languages/<your language>/
  • includes/templates/template_default/buttons/<your language>/


Additionally but not required, there's the SQL file

install/mysql_zencart.sql

which contains text that will appear on certain admin pages.
This means that the admin area isn't 100% multi-lingual, but this will most likely be dealt with in a future version of Zen Cart.


The zen-cart.com download area isn't working at the moment, but the team are working on a new support site.
Meanwhile, there seems to be no organised way of uploading your translations, so untill the new support site is done, feel free to contact dwno if you need server space for your translation.
(If anyone else have a better solution, let's hear it. ;-))


Updating an older translation

If a language pack is out of date, you can easily make it up to date by following a few steps.


When updating a language pack, you need to go through each consecutive Zen Cart version - that means, don't jump directly from 1.2.3 to 1.2.6, but update from 1.2.3 to 1.2.4 first, then from 1.2.4 to 1.2.5 and then from 1.2.5 to 1.2.6.


  1. Download the Zen Cart version that matches the translation, and the Zen Cart version immediately following that version.
  2. Open the changelog for the version you're currently updating to, which is available in the 'docs' directory in your Zen Cart directory.
  3. First, look under "Changed Files" for any changes done to files below /includes/languages/ and /admin/includes/languages/ and use a comparison program, like WinMerge or similar, to compare the differences between the old and new english versions of those files. That way you can find out what changes has been made sinced the last version, and then apply those changes to your own translation.
  4. Look under "Deleted Files" in the changelog, and if there are any language files listed, delete them from your translation as appropriate.
  5. Look under "New Files" in the changelog, and translate any language files listed there then add them to your translation.
  6. Repeat from step 1 untill you've reached the latest Zen Cart version.


List of known language packs

Also see the download area for a lot of old translations.

If you know of any language packs not mentioned here, please add them to this list in alphabetical order and remember to provide a download link.



Wanted translations

Feel free to add any languages you would want to have for Zen Cart here.