Creating a new translation for Crowd

1. Copy the crowd-webapp/WEB-INF/lib/crowd-language-<version>.jar file from your Crowd application directory into a temporary directory.

   1
   2
   donna:lib dmcgahan$ cp crowd-language-1.5.1.jar ~/Desktop/crowd-language/.
   

2. Expand the JAR in the temporary directory.

   1
   2
   donna:crowd-language dmcgahan$ jar -xvf crowd-language-1.5.1.jar 
     created: META-INF/
    inflated: META-INF/MANIFEST.MF
     created: com/
     created: com/atlassian/
     created: com/atlassian/crowd/
     created: com/atlassian/crowd/console/
     created: com/atlassian/crowd/console/action/
     created: com/atlassian/crowd/security/
     created: com/atlassian/crowd/security/demo/
     created: com/atlassian/crowd/security/demo/action/
     created: com/atlassian/crowd/openid/
     created: com/atlassian/crowd/openid/client/
     created: com/atlassian/crowd/openid/client/action/
     created: com/atlassian/crowd/openid/server/
     created: com/atlassian/crowd/openid/server/action/
    inflated: com/atlassian/crowd/console/action/BaseAction.properties
    inflated: com/atlassian/crowd/security/demo/action/BaseAction.properties
    inflated: com/atlassian/crowd/openid/client/action/BaseAction.properties
    inflated: com/atlassian/crowd/openid/server/action/BaseAction.properties
     created: META-INF/maven/
     created: META-INF/maven/com.atlassian.crowd/
     created: META-INF/maven/com.atlassian.crowd/crowd-language/
    inflated: META-INF/maven/com.atlassian.crowd/crowd-language/pom.xml
    inflated: META-INF/maven/com.atlassian.crowd/crowd-language/pom.properties
   

3. Once expanded, remove the original crowd-language-<version>.jar file from this temporary directory.

   1
   2
   donna:crowd-language dmcgahan$ rm crowd-language-1.5.1.jar 
   donna:crowd-language dmcgahan$ ll
   total 0
   drwxr-xr-x   4 dmcgahan  staff  136 Oct 15 16:27 .
   drwx------  16 dmcgahan  staff  544 Oct 15 16:25 ..
   drwxr-xr-x   4 dmcgahan  staff  136 Oct 15 16:27 META-INF
   drwxr-xr-x   3 dmcgahan  staff  102 Oct 15 16:27 com
   

4. In the temporary directory, modify each of the BaseAction.properties files with the new attribute translation. Apologies for my rough translation!

   1
   2
   console.welcome                Bienvenue à la foule console d'administration
   

5. If creating a new language translation for Crowd, you will need to rename each BaseAction.properties file in the temporary directory using the following format (e.g. for French, BaseAction_fr_FR.properties):

   1
   2
   BaseAction_<two-letter-language-code>_<two-letter-countrycode>.properties
   

   For more information on these codes please review the Locale javadoc. When finished the contents of your directories properties files should look similar to the following example (for our French translation):

   1
   2
   ./com/atlassian/crowd/console/action/BaseAction_fr_FR.properties
   ./com/atlassian/crowd/openid/client/action/BaseAction_fr_FR.properties
   ./com/atlassian/crowd/openid/server/action/BaseAction_fr_FR.properties
   ./com/atlassian/crowd/security/demo/action/BaseAction_fr_FR.properties
   

6. From within your temporary directory, create a new JAR for your translation:

   1
   2
   donna:crowd-language dmcgahan$ jar -cvf crowd-language-<version>_<language-code>_<country-code>.jar *
   

   So for our French translation example:

   1
   2
   donna:crowd-language dmcgahan$ jar -cvf crowd-language-1.5.1_fr_FR.jar *
   

7. Place your new translation JAR in the crowd-webapp/WEB-INF/lib directory of Crowd and restart.

8. To set your locale for testing, simply add "-Duser.language=<language-code> -Duser.country=<country-code>" to JAVA_OPTS in Crowd's apache-tomcat/bin/setenv.sh:

   1
   2
   JAVA_OPTS="-Xms128m -Xmx256m -XX:MaxPermSize=256m -Dfile.encoding=UTF-8 -Duser.language=fr -Duser.country=FR"
   export JAVA_OPTS
   

   or setenv.bat file:

   1
   2
   set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx256m -Dfile.encoding=UTF-8 -Duser.language=fr -Duser.country=FR
   rem Checks if the JAVA_HOME has a space in it (can cause issues)
   SET _marker=%JAVA_HOME: =%
   IF NOT "%_marker%" == "%JAVA_HOME%" ECHO JAVA_HOME "%JAVA_HOME%" contains spaces. Please change to a location without spaces if this causes problems.
   

9. If you create a new language translation for Crowd that may be useful to others, please submit your translation to the Atlassian Plugin Exchange.