Admin UI Translation

Admin Multi-Language Support

Prior to v2.1.0 very little of the Admin Interface would “display” in a language other than English.

Admin Configuration Menu Translations Since v1.5.5 it was possible to define translations in language packs for the Admin “Configuration” menu using a few override conventions:

//For example, in admin/includes/languages/spanish/lang.configuration.php

define('CFGTITLE_STORE_NAME', 'Nombre de la Tienda');
define('CFGDESC_STORE_NAME', 'El nombre de mi tienda');
define('CFG_GRP_TITLE_MY_STORE', 'Mi Tienda');

Now with v2.1.0 this is expanded to more areas:

For product_types:

The product_type type_name can be defined using 'PRODUCT_TYPE_NAME_FOR_HANDLER_' followed by the product_type’s uppercase type_name

Example for French:

    'PRODUCT_TYPE_NAME_FOR_HANDLER_PRODUCT' => 'Produit - Général',
    'PRODUCT_TYPE_NAME_FOR_HANDLER_PRODUCT_MUSIC' => 'Produit - Musique',
    'PRODUCT_TYPE_NAME_FOR_HANDLER_DOCUMENT_GENERAL' => 'Document - Général',
    'PRODUCT_TYPE_NAME_FOR_HANDLER_DOCUMENT_PRODUCT' => 'Document - Produit',
    'PRODUCT_TYPE_NAME_FOR_HANDLER_PRODUCT_FREE_SHIPPING' => 'Produit - Envoi Gratuit',

And for Product Type layout/configuration settings (found in product_type_layout table’s configuration_title and configuration_description fields): 'PRODUCT_TYPE_LAYOUT_TITLE_FOR_' followed by uppercase configuration_key 'PRODUCT_TYPE_LAYOUT_DESC_FOR_' followed by uppercase configuration_key

French examples:

    'PRODUCT_TYPE_LAYOUT_TITLE_FOR_SHOW_PRODUCT_INFO_MODEL' => 'Afficher le modèle',
    'PRODUCT_TYPE_LAYOUT_DESC_FOR_SHOW_PRODUCT_INFO_MODEL' => 'Afficher le numéro de modèle dans les informations de produit 0= off 1= on',
    'PRODUCT_TYPE_LAYOUT_TITLE_FOR_SHOW_PRODUCT_INFO_WEIGHT' => 'Afficher le poids',
    'PRODUCT_TYPE_LAYOUT_DESC_FOR_SHOW_PRODUCT_INFO_WEIGHT' => 'Afficher le poids dans les informations de produit 0= off 1= on',
    'PRODUCT_TYPE_LAYOUT_TITLE_FOR_SHOW_PRODUCT_INFO_MANUFACTURER' => 'Afficher le fabricant',
    'PRODUCT_TYPE_LAYOUT_DESC_FOR_SHOW_PRODUCT_INFO_MANUFACTURER' => 'Afficher le nom du fabricant dans les informations de produit 0= off 1= on',
(and there are a few dozen more possible entries that can be translated this way)

For Plugins listed in the Plugin Manager In your plugin’s language file, add a define: 'ADMIN_PLUGIN_MANAGER_DESCRIPTION_FOR_' followed by the uppercase english Description

French examples:

    'ADMIN_PLUGIN_MANAGER_DESCRIPTION_FOR_DISPLAYLOGS' => 'Affiche et gère les fichiers journaux de Zen Cart.',
    'ADMIN_PLUGIN_MANAGER_DESCRIPTION_FOR_POSM' => 'Ce plugin permet à votre site d\'attribuer des niveaux de stock et des numéros de modèle à vos produits en fonction de combinaisons produit-attributs (également appelées « variantes de produit » ou « stock par attributs »).',

Translations Added When Installing A Language Pack

When a Language is added to the Admin via the Languages page, not only do you specify the “directory name” where the language-pack files are to be found, but Zen Cart also makes copies of a LOT of database-records to support that language. It copies the English version of products, categories, and other things, and then you are free to edit those names/descriptions to translate them into your other language. Be sure to check out the Order Statuses page. And check out any plugins that allow multiple languages, such as POSM.