Translation

What do the colors of the translation icons mean?

There are currently three colors used

• Red – no translation was done
• Yellow – translation was done by a robot
• Green – translation was done by human (or approved by one)

Administration / Installation

What are the colors in the administrative interface?

Three background colors are used

• Green – this language is active and all users will see it
• Yellow – only users with translation capability can see this language (this is disabled once anonymous translation is available)
• Blank – language won’t appear on widgets

What is the dragging of languages for?

You may drag the languages in order to set the order in which they appear in the widget, you can use the sorting links below which will sort the languages and put the default language first. Dragging also is used to select the default language.

Why should I allow anonymous translation?

Wiki has proven itself quite a valid model on the Internet. More people have good intentions than bad intentions and that can be harnessed to get your message out to more people. Future versions will give more focus on preventing spammers from defacing sites

I have installed the plugin – nothing happens

By default, automatic translation is on and it should be kicking in. If its off, and you don’t have enough privileges to translate, nothing will happen.

Please be reminded of the following “rules of thumb”

1. A language marked as viewable will have its flag shown inside the widget.
2. A language marked for editing will allow a translator (anyone marked in the ‘who can translate’ section) to manually edit the page. i.e. the translate check-box will appear in the widget.
3. Enabling automatic translation will automatically translate a page (without requiring entering edit mode) for EVERYONE viewing the page regardless of the their role. However it will only take place for languages marked as editable.

Also – please take extra care to validate your html, adding extra tags that are unclosed in the template may lead to our parser breaking. Use the w3c validator service for more details. If everything is setup correctly and still nothing happens, please contact us.

I have installed the plugin – nothing happens – themes related

The plugin works on one theme yet seems to fail on another. This might be caused by themes which don’t include the wp_head and/or wp_foot functions so the transposh.js file is not being included, try to include it manually by modifying your theme

How to restore a backup

Until the feature is integrated into the plugin, you’ll have to recover your key from us, just leave a comment on this page and we’ll provide you with the required information

Do you know about any Transposh friendly hosting providers?

Yes, MISolutionz.com provides hosting service and have been using transposh themselves, if your current provider is touting the “high cpu” mantra, you may consider switching.

Modifications

My target language does not appear on the list of languages

You can edit the constants.php and add a line to the languages array, or just contact us to add your language

I am using the flag interface and would like to change the flag used for some language

In the languages array in the constants.php file change the two letter ISO code used for that flag

For example, to change the flag for the English language from the stars and stripes to the union jack find the following line

'en' => 'English,English,us,en_US',

And change it to:

'en' => 'English,English,gb,en_US',

Note that this works out of the box only in the non css version of the widget, to make this work in the css version you will have to modify the image used

How can I add the plugin interface without using the sidebar widget?

Just add the following line to your template:

<?php if(function_exists("transposh_widget")) { transposh_widget(); }?> 

If you want to use a widget style other than the default style and title, you can use something like:

<?php if(function_exists("transposh_widget")) { transposh_widget(array(), array('title' => 'Translation', 'widget_file' => 'flags/tpw_flags.php')); }?> 

I want my own css image with less flags

This is on our todo list

Known issues

I am getting the following error (syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR )

Please make sure you are using PHP5 and up, PHP4 is not supported

I am getting blank pages when visiting translated pages

This error is mostly caused by a low php memory limit settings, please increase your php memory limit

The plugin is too slow/consumes too many resources/my hosting provider wants to kill me/page speed results are low

A lot of effort has gone into the optimization of our plugin, however, there are some actions that you might need to take

• We strongly recommend using a local memory caching plugin, such as APC, using this php extension will dramatically reduce the load on your mysql server.
• We also recommend installing a wordpress caching plugin such as WP-Super-Cache

If you can’t do any of this, a better hosting is recommended, we don’t link to any here because nobody has offered us any payment yet

Plugins

please see our plugin compatibility matrix on our development wiki, feel free to contribute to it.

Plugin support: php speedy (http://aciddrop.com/php-speedy/)

Users of php speedy will have to deactivate it, add “transposh.js” in the ignore list, click on “Test configuration” then reactivate it.

Plugin support: Google-Sitemaps-XML

Currently the plugin is able to add the multilingual urls to the sitemap, and you need to add the following line at the sitemap-core.php, add-url function (line 1509 at version 3.2.2 right after the AddElement)
do_action('sm_addurl', $page);
We hope that future versions will include this by default, and for now you can get the patched file from our site.
After a change of languages used, you are welcomed to trigger a new sitemap buildup.

Update 27/3/12: Please note that version 4 beta supports Transposh by default, no need to do anything.

Plugin support: WP-Super-Cache

The support for wp-super-cache includes the invalidation of cached pages after a translation is made, which should reduce the issue with incorrect pages being displayed and redundant calls to the machine translation agent. After a change in the widget layout or the language list you are still expected to invalidate your cache.

Development

I have a feature to suggest

The correct place for that would be our development site