String Overrides
- Ezra Wolfe (DLC - Disabled) (Unlicensed)
- Gina Buoncristiano
- Scott Hoppe
String overrides allow a user with the site admin role to change a "string" of text. For example "Take course" can be changed to "Continue."
Warning!
A string override will change the string everywhere on the site and may have unintended consequences. Please fully test changes on your test site, including course relationship parent pages.
In order for a string to be changed, the text string must match exactly, including capitalization.
EthosCE uses CSS to transform various text in all caps. This means that the text you see onscreen may have a different capitalization than the actual text in the browser. Most text in EthosCE uses sentence case, meaning the first letter is uppercase and the others are lowercase. If there is a question as to the actual case, the "view source" function of your browser will show the actual, untransformed text.
String overrides will not match a partial string. For example a search string of "course" will not be matched for "Take course." Or, a search string of "Take course" will not match, "To begin, click 'Take course.'"
To override a string in EthosCE:
Log in as user with the site admin role.
Click the wrench to open the admin menu.
Click "Configuration."
Click "String overrides."
Enter the text to be replaced in the first empty "Original" field.
Enter the replacement text in the "Replacement" field."
Click "Save configuration."
Troubleshooting string overrides
Ensure the string matches exactly. If there is any additional text added or text missing, the string will not be matched. Check for empty spaces before or after the search string.
Some strings in EthosCE are dynamically generated. For example "Please login or register to take this course" contains links and must be specially constructed. For more information on replacing dynamically generated string see the examples below or contact EthosCE support.
Basic examples
Original text | Replacement |
|---|---|
Course description | Overview |
Faculty & Credentials | Contributors |
Postal code | ZIP/Postal code |
Dynamic string examples
Original text | Replacement |
|---|---|
Please !login or !register to take this course. | Please !login to Enroll |
Return to %title | Return to course |
Thank you for shopping at [store:name]. While logged in, you may continue shopping or <a href="[uc_order:url]">view your current order status</a> and order history. | Thank you for shopping with us. While logged in, you may continue shopping or <a href="[uc_order:url]">view your current order status</a> and order history. |
This course opens on %date. | This activity opens on %date. |
Enter your @s username. | Enter your username. |
Start @quiz | Start |
You were awarded <span class="course-credit-awarded-credit">@credits</span> <span class="course-credit-awarded-title">!title</span> @creditp. | Credit has been awarded. |
Changing course to Activity
In this example the term "Course" is replaced with "Activity"
Original text | Replacement |
|---|---|
Bookmark course | Bookmark activity |
Course | Activity |
Course closed | Activity closed |
Course complete | Activity complete |
Course credit awarded ID | Activity credit awarded ID |
Course credit awarded log | Activity credit awarded log |
Course credit log | Activity credit log |
Course description | Activity description |
Course expires | Activity expires |
Course expires: | Activity expires: |
Course format & instructions | Activity format & instructions |
Course home | Activity home |
Course instructions | Activity instructions |
Course not open | Activity not open |
Course opens | Activity opens |
Course opens: | Activity opens: |
Course progress | Activity progress |
Course summary | Activity summary |
Courses | Activities |
Find a course… | Find an activity… |
Here are the courses you have purchased: | Here are the activities you have purchased: |
Please !login or !register to take this course. | Please !login or !register to take this activity. |
Register/Take course | Register/Take activity |
Resume course | Resume activity |
Return to course | Return to activity |
Return to Course Home | Return to activity |
Return to the course to view course details and material. | Return to the activity to view activity details and material. |
Review course | Review Activity |
Start course | Continue |
Signup to !title confirmed. A confirmation email will be sent shortly containing further information about this %node_type. | Signup for !title confirmed. An email will be sent shortly. |
Take course | Continue |
Thank you for participating in this course. | Thank you for participating in this activity. |
This course closed on %date. | This activity closed on %date. |
This course opens on %date. | This activity can be completed beginning on %date. |
This course requires an access code to enroll. | This activity requires an access code. |
Unbookmark course | Unbookmark activity |
You have already purchased this course. | You have already purchased this activity. |
Tips and tricks
The "replacement" text in string overrides will accept CSS and HTML.
Original | Replacement | Explaination |
|---|---|---|
Payment required | <a href="#footer" class="course-take-course-link">Purchase info</a> | The text is transformed into a link that looks like a button. |
Please !login or !register to take this course. | Please <strong>!login or !register</strong> to take this course. | The "login or register" links are made bold. |
Customers can add their own CSS using the global CSS field. In that way a site administrator could create a custom CSS definition and apply a selector to a string using string replacements.
If you have any additional string overrides you think other EthosCE administrators would benefit from, please open a ticket and let us know.