Translating Hard Coded buttons and text

We added the possibility for cloud and on-prem customers to translate also buttons and text. We understand that this is a feature that a lot of our customers appreciate and decided to provide this service. Below you will find the ways this can be accomplished.

Through Excel sheet

We can send you an Excel sheet where you fill in the buttons and text you want to translate + the translation. We change the translation.json file for you and upload it to your cloud server. 

Through translation.json file

You can request this file to us, perform the translation and send it back. We will test and upload it to your server. Below is an ex. of what you will receive. This can be edited, opening in Notepad++ (Windows) or TextEdit (mac).

How to apply translations changes for customers with on premise deployment

Installer installation

The transaltion.json file can be found on your server on the following path

C:/Newired/tomcat/webapps/newired/WEB-INF/classes/launcher/package/translations.json

Use the method above and save to your server with the same name and format.

How to translate
To add new language into translation.json add a new key for example:
```
[
{
"language": "en_US",
"translations": {
"handle_title": "Help?",
..
}
},
{
"language": "it_IT",
"translations": {
"handle_title": "Assistenza?",
..
    }

Docker installation

1. Check Running Containers
   List Docker containers to find your portal's ID using the command: docker ps.

2. Copy overlay.zip
  Use the command docker cp <container_id>:/opt/Newired/apps/overlay.zip to copy the overlay.zip from the container to your local environment, replacing `<container_id>` with your portal's actual ID.

3. Edit `translations.json

1. Unzip overlay.zip
2. Update the translations in translations.json to your desired text. For example the handle title has key handle_title.
3. Zip the folder back into overlay.zip

4. Update Docker Compose
   In your docker-compose.yml add the volume mapping  - ./data/apps/overlay.zip:/opt/Newired/apps/overlay.zip under the portal service:  
   

yaml
   services:
     portal:
       volumes:
         - ./data/apps/overlay.zip:/opt/Newired/apps/overlay.zip

5. Redeploy
   Run the command `docker-compose up -d` to apply the changes.