Change the user interface text of a Magellan website

Magellan user guide

Magellan websites have default user interface text, such as the text used by the configuration popup, that library administrators can edit to suit a website's needs. If there is any text on your Magellan website that you want to change, check the language resource files that Magellan uses to populate this text.

The language resources files are located in the \assets\resources\{language} folder of the Magellan engine. The language that website visitors use for their browser determines which language folder and resource file is used. For multiple language Magellan sites, a user can also manually select the desired language from the dropdown menu on the top right of the site.

  1. Publish a Magellan website.

  2. Download the output, unzip it, then open it.

  3. Go to assets > resources folder > {language}.

  4. Create a copy of the required language file.

  5. Go to your Magellan Themes folder.

  6. In the content folder, create a language subfolder. Give it the same name as the language subfolder in assets > resources folder > {language}.

  7. Place the copy of the language file into the language subfolder.

  8. Open the copy of the language file.

  9. For each element, add the language text as required.

  10. (Optional) Repeat these steps for each language and each of your Magellan themes.

Variables and placeholders for language resource files

The Magellan language resource files have variables and placeholders that you can use for various elements

Element

Placeholder

Description

search_loading_message

{percent}

This placeholder is replaced by the percentage of search results that Magellan has loaded. The percentage updates as more results load.

Example usage: Searching... {percent}%

search_loading_message

{count}

This placeholder is replaced by the number of search results that Magellan has loaded. The count updates as more results load.

Example usage: Searching... {count} results found

search_loading_message

{total}

This placeholder is replaced by the maximum number of search results shown per result page (The value of searchResultSize in themeconfig.json).

Example usage: Found {count}/{total}