Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Translating User tours from Moodle.net: Difference between revisions

From MoodleDocs
(Added {{Translation}})
(Expanded the text and added many screen dumps)
Line 2: Line 2:
You  can easily translate the [https://docs.moodle.org/31/en/User_tours User tours] from [https://moodle.net/mod/data/view.php?id=17 Moodle.net], but you will need to follow these steps:
You  can easily translate the [https://docs.moodle.org/31/en/User_tours User tours] from [https://moodle.net/mod/data/view.php?id=17 Moodle.net], but you will need to follow these steps:
* You must first install the [https://moodle.org/plugins/local_usertours User Tours additional plugin]. See the [https://docs.moodle.org/31/en/User_tours User Tours Documentation].
* You must first install the [https://moodle.org/plugins/local_usertours User Tours additional plugin]. See the [https://docs.moodle.org/31/en/User_tours User Tours Documentation].
* Download one English language user tour .json file from the [https://moodle.net/mod/data/view.php?id=17 Moodle.net user tours database].
** After you install the plugin, you will see 'User tours' in ' Administration  ► Site administration  ► Appearance  ► User tours '
* Edit the steps, one at a time, replacing the English language strings with your translation.
 
[[File:User tours in admin block.png|200px]]
 
* Obviously, there will be no user tours to display initially:
 
[[File:User tours nothing to display.png|400px]]
 
*Click on the ' Tour repository ' link. You will see several pages with many available user tours in different languages, for various Moodle branches:
 
[[File:User tours available for download.png|400px]]
 
* Click on the one you want to translate
* Check the details and click on the orange-coloured link to download the *.json file:
 
[[File:User_tours_details.png|400px]]
 
* Take a note of where the downloaded file was saved.
* Go back to    ' Administration  ► Site administration  ► Appearance  ► User tours '
* Click on the ' Import tour ' link:
 
[[File:User tour configuration file import.png|400px]]
 
* Drag and drop the *.json file and click on the ' Save changes ' button.
* You wil then see all the steps of your newly imported tour:
[[File:User tour for Quizzes Moodle 3t.png|400px]]
 
* You can now edit the steps of the user tour in order to translate it into your language.
** Note in the following screen image that some strings inside a blue rectangle already appear as translated; that is because those language strings are part your [https://docs.moodle.org/31/en/Language_packs language pack] and had been properly translated at [https://lang.moodle.org/ AMOS]. Otherwise, please contact [https://lang.moodle.org/local/amos/credits.php your language pack maintainer].
** The string you can now translate is the one enclosed in a green rectangle:
 
[[File:User tour for Dashboard 31.png|400px]]
 
* Edit the remainding steps, one at a time, replacing the English language strings with your translation.
* Check that your edited (translated) file works as intended.
* Check that your edited (translated) file works as intended.
* Export the tour.
* Export the tour.

Revision as of 19:12, 30 June 2016

You can easily translate the User tours from Moodle.net, but you will need to follow these steps:

User tours in admin block.png

  • Obviously, there will be no user tours to display initially:

User tours nothing to display.png

  • Click on the ' Tour repository ' link. You will see several pages with many available user tours in different languages, for various Moodle branches:

User tours available for download.png

  • Click on the one you want to translate
  • Check the details and click on the orange-coloured link to download the *.json file:

User tours details.png

  • Take a note of where the downloaded file was saved.
  • Go back to ' Administration ► Site administration ► Appearance ► User tours '
  • Click on the ' Import tour ' link:

User tour configuration file import.png

  • Drag and drop the *.json file and click on the ' Save changes ' button.
  • You wil then see all the steps of your newly imported tour:

User tour for Quizzes Moodle 3t.png

  • You can now edit the steps of the user tour in order to translate it into your language.
    • Note in the following screen image that some strings inside a blue rectangle already appear as translated; that is because those language strings are part your language pack and had been properly translated at AMOS. Otherwise, please contact your language pack maintainer.
    • The string you can now translate is the one enclosed in a green rectangle:

User tour for Dashboard 31.png

  • Edit the remainding steps, one at a time, replacing the English language strings with your translation.
  • Check that your edited (translated) file works as intended.
  • Export the tour.
  • The exported file is your translation.
  • Submit it to the Moodle.net user tours database.
  • Please translate the User Tools Moodle documentation too.