Customize the translation of individual language text strings throughout your domain from within your Skilljar dashboard's language packs page. In this article, we'll describe each group of strings and the pages they correspond to.
| For more information, check out our Skilljar Academy course, Customizing Course Platform Text. |
Overview
The languages page in the Skilljar dashboard allows you to customize individual language strings and their translations. The pages that can be customized include Catalog Pages, Courses and Lessons, Student Profile, Sign in/Sign Up, and much more. You also have the option of changing custom elements, such as tags and sign-up fields.
The full list of customizable strings can be found on your Skilljar dashboard's languages page or by selecting Theming and then Languages. Each will include the English base text of the string as well as the base text of the language it's to be translated into.
You can also read more about the language packs offered by Skilljar at Localization and Language Packs.
Notes:
- Changes in your language page will only affect the hard-coded strings throughout your training site, so this won't make any changes to your Course or Lesson content.
- If there is custom CSS within your Theming, it will override any changes made within the Languages page.
- Changes on the language page will instantly update your training portal. If you'd like to add Language Packs to your Skilljar training portals, contact our Account Management team.
Overriding strings within a language pack
To override individual strings within a language pack, replace the existing string with the new override string in the Override Text field and select update to apply the change.
Bulk overriding a language pack using CSV
Override the language strings at once by downloading and editing the Comma-separated values (UTF-8 encoded CSV) file of the language pack. The pack will include all of the English base text and string details, as well as any existing overrides.
- Open the language pack you want to manage in your dashboard.
- Select Manage Language Packs and then Import Language Pack.
- In the pop-up window, select Download Language Pack Override File. This will download a CSV of the pack in a spreadsheet format.
- If you already have the CSV downloaded, you can skip this step.
- Add the new override string in the Override Text field. Do not edit any other fields as this may cause an error. This file should be encoded in UTF-8
- Select Manage Language Packs and then Import Language Pack.
- In the pop-up window, drag or browse your device for your CSV file.
- Once the file is added, a validation will run, and will return as a success, partial success, or failure (see below for more details). If the file validation failed, please fix any errors and try again.
- Select Apply Override to finalize the override.
CSV file validation
When a CSV override file is added, we’ll run a validation scam checking for correct headers and columns, and determine if the file was a success, partial success, or failure.
The override can only be applied if the file validation returns as a success or partial success. If it fails, you’ll be notified of any errors, which should be corrected before trying again.
A secondary validation will also run after you’ve applied the override, scanning each row individually. This scan will confirm that aspects such as headers, string ID, and base text matches the language pack format correctly.
Success
A file is a success when all of the validation criteria are met.
Partial Success
The file is a partial success when some of the rows have met the validation criteria, but not all. Only the successful rows will be overridden. The result notification will list any rows with errors that weren’t able to be overridden. You can fix these in the CSV file and try again.
Fail
A file will fail validation when it doesn’t meet any of the validation criteria. The notification will list any errors that must be corrected.
Styling
In addition to plain text, you can add the following HTML tags to the Override Text field to style the replaced base text.
- <strong>
- <b>
- <i>
- <em>
- <br/>
Targeted Pages
Access
Description: Account creation for users invited to the platform via Skilljar Dashboard.
Example URL: training.YourDomain.com/accounts/invite/123
Notes: Base Text for text input fields are found in “Sign Up Page” section
Catalog Page
Description: Domain landing page which houses all courses published to a specific domain.
Example URL: training.YourDomain.com
Certificates
Description: Certificate Verification now has a table with all relevant Verification data below the Certificate PDF)
Example:
Courses and Lessons
Description: Overview and detail pages for all lessons and courses on a domain.
Example URL: training.YourDomain.com/example-course
Payments
Description: Displays order details prior to purchase.
Example URL: https://accounts.skilljar.com/purchase/123
Purchasing & Ordering
Description: Purchase Checkout page.
Example URL: training.YourDomain.com/example-paid-course
Sign In / Sign Up
Description: Account creation and sign in.
Example URL: https://accounts.skilljar.com/auth
Student Profile
Description: Edit account information and view course registration history.
Example URL: https://accounts.skilljar.com/accounts/profile/
For additional assistance, please reach out to your Customer Success Manager, Implementation Manager, or support@skilljar.com.