Translation with custom translation file fails for certain words in Magento

Question

I'm developing a custom module for my Magento installation (version 1.6.2.0). I registered a translation file for the module in the config.xml and started to add German translations. The module adds some new behavior to the Magento back end.

While doing the translation I noticed a strange behavior of Magento. Certain words don't get translated by Magento although a translation is provided in the module's csv file.

When I change the key to a different value, the translation works as expected, so Magento seems to see and read the cvs file.

At the moment I notice this behavior for the keys "City" and "Store".

Content of the csv file:

"City","Stadt"
"City1","Stadt"

I use the following line to translate the strings.

Mage::helper('mymodule')->__('City') // returns "City"

When I change the key to "City1" every thing works as expected.

  Mage::helper('mymodule')->__('City1') // returns "Stadt"

After this I searched the German translation csv files (provided by the German Magento Community) for a translation for the key "City" and found one in the "adminhtml module".

  Mage::helper('adminhtml')->__('City') // returns "Stadt"

So this also works as expected.

I don't know what I'm doing wrong. As I said the same behavior occurs for the string "Store".

Any ideas on this?

Do you have a translate section in the configuration (config.xml) of mymodule? Magento usually falls back to other modules, if it cannot find an appropiate translation within the configured csv, so that could be the problem. — Florian
Yes I have such a section in the config file of the module otherwise the translation shouldn't work with the key City1 either. But that's not the case with City1 the translation works. — Flo

Flo Flo · Accepted Answer · 2012-06-14T13:58:40

Finally I solved the translation problem. The reason was a wrong configuration in the config.xml. I found it out by debugging the code where Magento reads in the translation files. When this happens there's a parameter called scope which is read from one of the XML elements of the config.xml file.

This element should normally have the name of the module, e.g. <MyCompany_MyModule>. In the tutorial I followed to configure the translation, this XML-element was named <translations> which was wrong.

I guess that this might have been correct for an earlier version of Magento. What made it hard to find out was that the errors only occur for keys which were also defined in other modules's translation files. Keys which were only defined in my translation file worked as expected.

An correct configuration should look like this.

<frontend>
   ...
    <translate>
        <modules>
            <MyCompany_MyModule>
                <files>
                    <default>MyCompany_MyModule.csv</default>
                </files>
            </MyCompany_MyModule>
        </modules>
    </translate>
  ...
</frontend>
<adminhtml>
  ...
    <translate>
        <modules>
            <MyCompany_MyModule>
                <files>
                    <default>MyCompany_MyModule.csv</default>
                </files>
            </MyCompany_MyModule>
        </modules>
    </translate>
    ...
 </adminhtml>

Translation with custom translation file fails for certain words in Magento

2 Answers