Skip to main content

Translation Management Guide for AdFox

Overview​

AdFox now features an enhanced translation management system, enabling administrators to add, manage, and edit language translations directly from the admin panel. This guide outlines the process for managing translations and setting the default language for your platform.

Managing Translations​

Accessing Language Settings​

To begin, navigate to the Languages section found under Settings in the admin panel. Here you'll see the default language (English) and options to add or manage additional languages.

Adding a New Language​

  1. Create Language: Click on the Create Language button to add a new language to your platform.
    • Language Title: Enter the full name of the language, e.g., "Spanish".
    • Language Code: Enter the ISO language code, e.g., "es" for Spanish.
    • Country Code: (If applicable) Select the country code from the dropdown list to specify regional dialects.
    • Is Visible: Toggle this option to enable or disable the visibility of this language on your platform.
    • Click Create to add the new language or Create & create another to add multiple languages.

Managing Language Content​

After adding a new language to AdFox, managing its translations is straightforward and intuitive. Here's how to navigate this feature:

  1. Access Language Management: From the Languages section under Settings, find the list of available languages. Each language entry provides an option to Manage translations.

  2. Manage Translations:

    • Click Manage translations next to the language you wish to edit. This will take you to the translation editor for that specific language, such as "Edit translation for English (US)".
    • The editor lists all text strings used throughout AdFox. Each string has a unique key and a text box for entering the corresponding translation.

  3. Key Points to Keep in Mind:

    • Avoid System Variables: Be cautious not to translate terms starting with :, as these denote system variables. For example, translating "Greeting :username" should ensure ":username" remains unchanged to dynamically insert the user's name.
    • Special Characters Warning: Avoid using special characters like ", ', \, and ``` in translations. These characters can interfere with the system's functionality.
    • Auto-Save Feature: Translations are saved automatically. After entering your translation, click outside the text box to trigger the save action. A confirmation or visual cue typically indicates successful saving.

  4. Editing Translations: Proceed to translate each key into the target language. The intuitive interface allows for easy navigation through categories and strings, ensuring a comprehensive translation process.

Reviewing and Applying Translations​

After editing, review your translations to ensure accuracy and context appropriateness. Given the auto-save functionality, changes are immediately applied, but it's good practice to navigate through your platform to see translations in action and make adjustments as needed.

Setting the Default Language​

  1. Navigate to General settings under the Settings menu.
  2. In the Default Language section, select the language you wish to set as the default for your platform.
  3. Save your changes to apply the new default language.

Conclusion​

With AdFox's updated translation management system, administrators can effortlessly add new languages and manage translations directly from the admin panel, streamlining the process of creating a multi-lingual platform. This approach eliminates the need for manual file edits, simplifying language management and ensuring a global reach for your AdFox platform.