🌐 Translations

The Translation Manager allows you to easily customize or localize the application’s language without touching code. This is especially useful if you’re serving customers or employees in different regions or prefer using the system in your native language.

---

🔤 How It Works

Your POS system comes with built-in multilingual support. All static text used in the application (menus, labels, buttons, etc.) is managed through a language file stored in your system.

You can add, edit, or remove translations through the user-friendly interface provided in the admin panel — no code or JSON editing needed.

---

📂 Language Files Structure

Each supported language has its own directory under the lang/ folder. Inside, it contains multiple files grouped by function (like auth.php, messages.php, etc.).

Example folder structure:

/resources/lang
  /en
    auth.php
    messages.php
    ...
  /es
    auth.php
    messages.php
    ...

When you update a translation key via the admin interface, the changes are saved to these files automatically.

---

⚙️ Managing Translations

To access:

1. Navigate to: Settings > Translations

2. You’ll see a list of all translatable keys, grouped by categories or modules (e.g., POS, Dashboard, Reports).

3. Use the language dropdown to select your target language.

4. Edit any value inline and click Save to apply.

---

➕ Adding a New Language

Want to translate the app into a completely new language?

1. Go to Settings > Translations

2. Click “Add New Language”

3. Enter the language code (e.g., fr for French) and name.

4. The system will auto-generate a new language directory with default keys copied from English.

Then, just start translating key-by-key through the interface.

---

🔄 Syncing Keys

If you update the system and new translation keys are added:

• Use the “Sync Keys” button to automatically scan and add any new or missing keys to all language files.

• This ensures your translation list stays up to date even after feature upgrades.

---

✅ Best Practices

Task	Recommendation
Primary Language Editing	Prefer to edit via admin UI instead of files
Adding Languages	Use ISO codes (e.g., en, es, de)
Backup Before Edits	Export translations before bulk changes
After Updates	Always run “Sync Keys”

---

🛠️ Troubleshooting

• Missing or untranslated keys?

  • Run the Sync Keys function from the translations section.

• Special characters not displaying properly?

  • Ensure your files are UTF-8 encoded.

• Language doesn’t switch on the frontend?

  • Check if the selected language is active/enabled in settings.