How to add a new website translation to Piwik?

Here are the steps for Piwik admins to add a new website translation, and send content to be translated to translators. See the full procedure and help page for translators in: http://piwik.org/website-translations/

Requirements

Translators must be warned that translating the website is a major time investment, probably around 40 hours of work. When it is confirmed that translators are keen to translate the website in their language, we can proceed with the following technical steps.

Add the new language in Wordpress

(Matt to do the following steps)

  • Add DNS CNAME in piwik.org manager (for staging and production)
  • Add apache virtual hosts
  • Add language in WP admin > WPML Languages tab
  • Import WP language file: cd [...]/wp-includes/languages/ && wget http://svn.automattic.com/wordpress-i18n/el/trunk/messages/el.mo
  • Hide language from language switcher until the translation is finished
  • WPML>Pro translation, click Configure professional translation, click the new language and Save

Coordinate with translators, and send all content to be translated

(Noah to do the following steps)

  • From icanlocalize.com, login, then
    • Click on Piwik project, click the new language pair English > XY, select "Closed for bidding"
    • Click on My account > Private translators, create a new invitation for the translator to join the Piwik project
  • From WP, send the content to be translated to the translator
    • WPML> String translation: Click display all results, select all strings, click "Send selected strings to Icanlocalize". These are the strings for the WP theme, and the FAQ entries.
    • WPML> Pro translation. Here we want to select only blog posts and website pages that need to be translated (some of the posts and pages must stay in English only). The simplest way to do this is to only show documents that are already "Completed" or "In Progress" in German.
      • Select Translation status: Completed, and Display. Select all posts and pages, and click "Translate selected documents"
      • Select Translation status: In progress, and Display. Select all posts and pages, and click "Translate selected documents"

For example, only the following blog posts must be translated for new languages: 

Piwik.org website now available in German!
Piwik is Sourceforge Project of the Month!
Piwik wins Best of open source enterprise software (Web Analytics)
100,000 Downloads Milestone!
Piwik Consulting: Find paid support, custom plugin development from approved Piwik consultants
Sourceforge offers Piwik to 150,000 Open Source projects!

For website pages, most pages must be translated, but some should never be translated, for example (NOTE: this is not the complete list) 

Website translations
Legacy Javascript Tracking API [deprecated]
Piwik Changelog 
Search results   
Piwik in the media
etc.
  • Once the translator accepts the icanlocalize invitation, they will apply for the Piwik project, for their languages. We can accept the application, and the translator should be good to go with the help page from http://piwik.org/website-translations/