Language Settings
Manage the language bundles and activate the desired ones. Mumara supports multiple languages, allowing you to localize the application interface for your team and users. This page lets you view available language packs, install new languages, and manage which languages are active in your installation.
Navigate to Tools → Languages to manage language settings.
Language List
The main page displays all available language packs with their installation status and management options.
Controls
| Control | Description |
|---|---|
| UPLOAD LANGUAGE | Button to upload a custom language pack file - use this to add languages not included in the default list or to upload customized translations |
| Show entries | Dropdown to control how many languages are displayed per page - useful when browsing through the full list of available languages |
| Search | Find specific languages by typing keywords - searches across language names and codes to quickly locate a particular language |
Table Columns
| Column | Description |
|---|---|
| Language | The name of the language (e.g., Arabic, French, German) - the default language displays a "DEFAULT" badge next to its name indicating it's the system-wide default |
| Code | The ISO language code used internally (e.g., "en" for English, "fr" for French, "zh-CN" for Chinese Simplified) - these codes follow standard language code conventions |
| Author | The creator of the language pack - shows "Mumara" for official language packs provided by Mumara, or displays the author name for custom uploaded translations |
| Installation | Shows the current status of the language pack - "INSTALLED" (green badge) means the language is ready to use, "NOT INSTALLED" (gray badge) means the language files need to be downloaded first |
| Actions | Provides management options that vary based on installation status - shows a download icon for languages that aren't installed, or a three-dot menu for installed languages |
Installation Status
Languages have two possible states:
| Status | Badge Color | Meaning |
|---|---|---|
| INSTALLED | Green | The language pack is installed and ready to use - users can select this language in their preferences |
| NOT INSTALLED | Gray | The language pack is available but not yet downloaded - click the download icon to install it |
Default Language Badge
The system default language shows a "DEFAULT" badge next to its name. This is the language used when:
- A user hasn't selected a preferred language
- A requested language is unavailable
- New user accounts are created
Installing Languages
Install from Available List
To install a language that shows "NOT INSTALLED":
- Locate the language in the list
- Click the download icon in the Actions column
- Wait for the language pack to download and install
- The status changes to "INSTALLED" when complete
Upload Custom Language Pack
To add a custom or modified language pack:
- Click the UPLOAD LANGUAGE button
- Select your language pack file (typically a ZIP file containing translation files)
- Upload the file
- The language appears in the list once uploaded
- Install it if needed
Managing Installed Languages
For languages that are already installed, click the three-dot Actions menu to access management options:
Actions Menu
| Action | Description |
|---|---|
| Duplicate Language | Creates a copy of the language pack that you can customize - useful when you want to create a modified version of an existing translation without altering the original |
| Export | Downloads the language pack files to your computer - allows you to edit translations locally or back up your customizations |
Available Languages
Mumara provides official language packs for many languages. The list includes but is not limited to:
| Language | Code |
|---|---|
| Arabic | ar |
| Chinese (Simplified) | zh-CN |
| English - US | en |
| French | fr |
| German | de |
| Hindi | hi |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Norwegian | no |
| And more... |
New languages may be added over time. Check the Languages page periodically for newly available translations.
Using Languages
User Language Selection
Once languages are installed, users can select their preferred language from their profile settings. The interface will display in their chosen language.
Administrator Default
The default language setting affects:
- The login page language
- New user accounts
- Fallback when a user's preferred language isn't available
- System-generated messages and notifications
Custom Language Packs
Creating Custom Translations
If you need to customize translations or create a language pack for a language not available:
- Copy an existing language - Start with an installed language as a template
- Translate the strings - Modify the translation values in each file
- Package the files - Create a ZIP file with the correct folder structure
- Upload to Mumara - Use the UPLOAD LANGUAGE button
Language Pack Structure
Language packs contain PHP files with translation arrays:
{language_code}/
├── auth.php
├── pagination.php
├── validation.php
├── messages.php
└── ... (many more files)
Each file contains an array of key-value pairs where keys are translation identifiers and values are the translated strings.
Best Practices
Language Management
- Install only needed languages - Keep your installation clean by only installing languages your users actually need
- Keep languages updated - Check for updates periodically to get the latest translations
- Test after installation - Verify translations display correctly after installing a new language
For Multi-Language Deployments
- Set an appropriate default - Choose a default language that makes sense for most of your users
- Document available languages - Let users know which languages are available
- Provide fallback - Ensure the default language has complete translations
Custom Translations
- Backup originals - Before modifying, save original translation files
- Test thoroughly - Check translations in context to ensure they make sense
- Maintain consistency - Use consistent terminology throughout translations
- Update carefully - Custom changes may be overwritten when updating language packs
Troubleshooting
Language Won't Install
Possible causes:
- Network connectivity issues preventing download
- Insufficient disk space
- File permission issues
Solutions:
- Check your server's internet connectivity
- Verify adequate disk space is available
- Check that the storage directories have write permissions
Translations Not Displaying
Possible causes:
- Language not properly installed
- Cache needs to be cleared
- Missing translation files
Solutions:
- Verify the language shows "INSTALLED" status
- Clear the application cache
- Re-install the language pack
Custom Upload Fails
Possible causes:
- Incorrect file format or structure
- File too large
- Invalid translation syntax in files
Solutions:
- Ensure the upload is a properly structured ZIP file
- Check upload size limits in PHP settings
- Verify PHP array syntax in translation files
Language Missing from User Options
Possible causes:
- Language is not installed
- Language was uninstalled
Solutions:
- Check the Languages page to confirm installation status
- Install or re-install the language
Next Steps
- Application Settings - Configure default language settings
- Staff Management - Manage user language preferences
- Manage Users - Configure client language options