Localization / Translation Guide

Language File Structure

CPanel/WHM Interface Translation

/usr/local/jetapps/var/www/jetbackup5/docroot/app/lang/en/{SECTION.json}

/usr/local/jetapps/var/www/jetbackup5/docroot/app/lang/override/xx/

Step 1 - Copying the Language Files

The "en" folder contains the default English language files for JetBackup and each file corresponds to a section in the JetBackup WHM interface. These files will be used as a starting point for translating JetBackup.

• To begin translating JetBackup, copy all the files inside the English folder to the "/override/xx" folder.
• Rename "xx" with your preferred language code.

Step 2 - Start Translating

• Once you have your override folder set up, you may start translating each section in your language folder by editing the associated {SECTION}.json file.

For example, to translate the JetBackup Dashboard to Spanish:

Here is an example snippet:

{
   "Total Accounts" : "Cuentas Totales",
   "Total Jobs" : "Trabajos Totales",
   "Total Backups" : "Copias de Seguridad Totales",
   "Jobs Running" : "Trabajos en Ejecución",
   "New Alerts" : "Nuevas Alertas",
   "Total Accounts Usage (%s)" : "Uso Total de Cuentas (%s)"
}

Time

You can change the date format showing on the WHM GUI by editing /usr/local/jetapps/var/www/jetbackup5/docroot/app/lang/en/date.json. To view the available format click on https://momentjs.com/docs/#/displaying/

date: {
            /** See the moment date format documentation: https://momentjs.com/docs/#/displaying/ **/
            short: "D MMM YYYY",
            shorttime: "D MMM YYYY hh:mm A",
            long: "ddd, MMM D, YYYY",
            longtime: "ddd, MMM D, YYYY, hh:mm A"
         }

DirectAdmin Panel Translation

/usr/local/directadmin/plugins/jetbackup5/images/app/lang/en/{SECTION.json}
/usr/local/directadmin/plugins/jetbackup5/images/app/lang/override/xx/

Step 1 - Copying the Language Files

The "en" folder contains the default English language files for JetBackup and each file corresponds to a section in the JetBackup DirectAdmin interface.

• To begin translating JetBackup, copy all the files inside the English folder to the "/override/xx" folder.
• Rename "xx" with your preferred language code.

Step 2 - Setting Permissions

• Your override folder in /usr/local/jetapps/var/www/jetbackup5/docroot/app/lang/ should be owned by root:root and permissions should be 644 for files, 755 for Directories.
• Your override folder in /usr/local/directadmin/plugins/jetbackup5/images/app/lang/ should be owned by diradmin:diradmin and permissions should be 644 for files, 755 for Directories.

Step 3 - Start Translating

Once permissions have been set, you may start translating each section in your language folder by editing the associated {SECTION}.json file.

For example, to translate the JetBackup Dashboard to Spanish:

Step 4 - Changing the Language in DirectAdmin

After translating the files, you will need to ensure the panel language for DirectAdmin is set properly. This can be done on a per-user or global basis.

• To change the language on a per-user basis, perform the following steps:

** You may replace the "admin" text in the below path with the user account you'd like to edit.

1. Depending on the user type, edit these configuration files.

   • Users: /usr/local/directadmin/data/users/admin/user.conf
   • Resellers: /usr/local/directadmin/data/users/admin/reseller.conf

2. Add language=xx to the conf file and save your changes.
3. Restart the JetBackup5 and DirectAdmin services.

• To change the language on a global basis, perform the following steps:

1. Open the file /usr/local/directadmin/conf/directadmin.conf in your preferred text editor.
2. Add language=xx to the file and save your changes.
3. Restart the JetBackup5 and DirectAdmin services.

Here is an example snippet from dashboard.json after translating to Spanish:

{
   "Total Accounts" : "Cuentas Totales",
   "Total Jobs" : "Trabajos Totales",
   "Total Backups" : "Copias de Seguridad Totales",
   "Jobs Running" : "Trabajos en Ejecución",
   "New Alerts" : "Nuevas Alertas",
   "Total Accounts Usage (%s)" : "Uso Total de Cuentas (%s)"
}