Geführte Touren: Unterschied zwischen den Versionen

Aktuelle Version vom 28. Januar 2020, 10:14 Uhr

Einführung

Geführte Touren sind Schritt-für-Schritt-Anleitungen in verschiedenen Bereichen von Moodle. Adminsitrator/innen können neue Touren anlegen oder von der Seite Moodle.net/tours importieren. Der Filter Mehrsprachiger Inhalt ermöglichst es, dass Touren in verschiedenen Sprachen angezeigt werden. Eine Demonstration dieser Funktionalität sehen Sie in diesem Screencast.

Geführte Touren

Wie wird eine geführte Tour aufgesetzt?

Als Administrator/in haben Sie Zugriff auf die Seite Einstellungen > Website-Administration > Darstellung > Geführte Touren.
Auf dieser Seite werden alle vorhandenen geführten Touren angezeigt. Standardmäßig sehen Sie je eine eine Tour zum Boost Design für Administrator/innen und für Trainer/innen. Hier können Sie eine neue Tour anlegen oder importieren und auf die Touren-Datenbank zugreifen.

Bei jeder Tour können Sie auf den Namen oder auf das Vorschau-Symbol klicken, um die einzelnen Schritte der Tour zu sehen.
Jede Tour kann durch Klicken auf das Auge-Symbol aktiviert oder deaktiviert werden.

Neue Funktionalität
in Moodle 3.8!

Sie können eine Tour durch Klicken auf das Symbol duplizieren und anschließend anpassen.

Hinweis: Sie können für eine Moodle-Seite mehrere Touren anlegen, aber es darf immer noch eine Tor pro Moodle-Seite aktiviert sein.

Hinter jedem Tournamen finden Sie entsprechende Symbole, um die Tour anzusehen , zu bearbeiten , zu exportieren oder zu löschen .
Geführte Touren werden auf allen Seiten angezeigt, deren URL zum Pfad passt, der in den Einstellungen der Tour angegeben wurde, zum Beispiel:

my/% - Dashboard
/course/view.php?id=2 - Kurs mit der ID = 2
/mod/forum/view.php% - Liste aller Diskussionsthemen eines Forums
/user/profile.php% - Nutzerprofilseite

Zu jeder Tour werden Schritte angegeben, die in den Einstellungen der Tour bearbeitet werden können:

Platzierung: Gibt an, wo der Schritt angezeigt wird (oberhalb, unterhalb, rechts, links von der Stelle, um die es geht)
Anzeigen, wenn Ziel nicht gefunden: Gibt an, ob ein Schritt angezeigt wird oder nicht (Standardeinstellung: Nein), falls die Stelle, um die es geht, nicht gefunden werden kann.
Mit Hervorhebung anzeigen: Gibt an, ob der Schritt besonders hervorgehoben wird oder nicht (Standardeinstellung: Nein).
Bei Klick ausführen: Wenn diese Option auf Ja gesetzt ist, dann wird die Tour erst fortgesetzt, wenn die Person im aktuellen Schritt an der angegebenen Stelle klickt (Standardeinstellung: Nein).

Hinweis: Wenn Sie möchten, dass die Nutzer/innen während der Tour ein Formular ausfüllen, dann setzen Sie die Einstellung Mit Hervorhebung anzeigen auf Nein.

Sie können in den Einstellungen der Tour wählen, für welche Rollen und Designs die Tour angezeigt wird.

Wie füge ich Schritte in eine Tour ein?

Auf der Übersichtsseite Einstellungen > Website-Administration > Darstellung > Geführte Touren klicken Sie auf den Namen der Tour oder auf das Bearbeiten-Symbol hinter dem Namen.
Hier sehen Sie einige Schritte einer geführten Tour durch das Dashboard:

Um einen Schritt in eine Tour einzufügen, klicken Sie auf den Link Neuer Schritt.
Wählen Sie als erstes einen Zieltyp aus: Das ist die Stelle auf der Moodle-Seite, an der der Schritt angezeigt werden soll. Wenn die Stelle ein Block ist, dann wählen Sie die Option Block aus und wählen dann im Auswahlmenü Block den konkreten Blocktyp aus. Wenn die Stelle ein bestimmter CSS-Bereich ist, dann wählen Sie als Zieltyp die Option Auswahl aus und tragen dann im Textfeld CSS Selector die genaue CSS-Bezeichnung ein (siehe Beispiele unten). Wenn es keine spezifische Stelle auf der Seite gibt, an der der Schritt angezeigt werden soll, dann wählen Sie die Option In der Seitenmitte anzeigen.
Geben Sie für den Schritt einen Titel an und tragen Sie im Textbereich Inhalt eine passende Beschreibung ein.
Im Bereich Optionen wählen Sie weitere Einstellungen:

Platzierung - wo soll die Beschreibung angezeigt werden.
Anzeigen, wenn Ziel nicht gefunden
Mit Hervorhebung anzeigen
Bei Klick ausführen

Klicken Sie abschließend auf den Button Änderungen speichern.

Wie funktionieren geführte Touren?

Wenn eine geführte Tour angelegt und aktiviert ist, kann es losgehen. Sobald Nutzer/innen die entsprechende Moodle-Seite danach zum ersten Mal aufrufen, startet die Tour mit dem ersten Schritt. Zu jedem Schritt wird der Titel und der Inhalt (die Beschreibung) angezeigt sowie drei Buttons:

Zurück - führt zum vorhergehenden Schritt der Tour
Weiter - führt zum nächsten Schritt der Tour
Tour-Ende - beendet die Tour.

Wenn Nutzer/innen eine Tour wiederholen wollen, können Sie unten auf der Moodle-Seite auf den Link Tour erneut starten klicken.

Filter

Wenn Sie eine geführte Tour aufsetzen, können Sie in den Einstellungen festlegen, in welchem Kontext die Tour angezeigt wird. Sie können filtern nach

Rolle
Design

und

Kursbereich
Kurs
Kursformat

Hilfe für CSS Selektoren

Wenn Sie als Zieltyp eines Schrittes CSS Selektoren verwenden wollen, dann sind Browser-Entwicklerwerkzeuge sehr hilfreich, um die passenden Selektoren zu finden:

Beispiel für einen einfachen CSS Selektor

Hier finden Sie ein Beispiel für einen Schritt mit CSS Selektor als Zieltyp.

Diese Einstellungen führen zu folgender Darstellung in der geführten Tour:

Woher wissen wir, dass der CSS Selektor für das Nutzermenü

.usermenu

ist? Das finden wir heraus, wenn wir den HTML Inspector im Firefox verwenden (siehe unten).

Weitere einfache Beispiele für CSS Selektoren

.breadcrumb - das sind die Links in der Navigationsleiste oben auf jeder Moodle-Seite. Sie zeigen an, wo in Moodle Sie sich gerade befinden und helfen Ihnen, schnell auf übergeordnete Seite zu gelangen.
.userpicture - das ist das Nutzerbild, das an verschiedenen Stellen in Moodle angezeigt wird (in Kursteilnehmerlisten, bei Forumsbeiträgen, in Bewertungsübersichten, usw.)
[value="Customise this page"] - fügen Sie neue Blöcke auf der Moodle-Seite hinzu, indem Sie hier klicken.

Mehrsprachigkeit

Wenn Ihre Moodle-Site mehrsprachig ist, dann können Sie diese Mehrsprachigkeit auch bei geführten Touren nutzen. Verwenden Sie dazu die mehrsprachige Formatierung in den Titeln und Beschreibungen der einzelnen Schritte der Tour. Detaillierte Informationen zu dieser Formatierung finden Sie im Artikel Mehrsprachiger Inhalt.

Vergessen Sie nicht, diesen Filter auf der Seite Einstellungen > Website-Administration > Plugins > Filter > Übersicht zu aktivieren, bevor Sie mehrsprachige geführte Touren anlegen oder importieren. Andernfalls sehen die Nutzer/innen alle Texte in allen Sprachen.

Geführte Touren übersetzen

Siehe Entwicklerdokumentation (englisch).

Anmerkung zum Tastaturfokus bei geführten Touren (Tabstopps)

Wenn Sie Ihre geführte Tour mit der Tastatur testen, kann es manchmal passieren, dass es an Stellen, an denen es nur einen Tabstopp geben sollte, zwei Tabstopps gibt. Z.B. haben Sie diesen HTML-Code

    <div class="my-link">
        <a href="https://moodle.org/">Example link</a>
    </div>

und nutzen den CSS-Selektor .my-link für Ihre Tour-Schritte, dann gibt es zwei Tabstopps für den einen Link. Das liegt daran, dass das Zielobjekt der Tour immer in einem Tabstopp eingebaut ist.

Um dies zu verhindern, müssen Sie das Zielobjekt der Tour mit .my-link a auf den Link selbst gelegt werden. Gleiches gilt für ähnliche Situationen.

Teilen von geführten Touren

Wir hoffen sehr, dass Sie einige nützliche geführte Touren erstellen, die Nutzer/innen durch Ihre Moodle-Site führen. Wir möchten Sie ermutigen und auffordern, Ihre Touren mit anderen zu teilen.

Für diesen Zweck haben wir eine Moodle.net Tour Datenbank angelegt, in der Sie Ihre Touren hochladen oder Anregungen von anderen Touren mitnehmen können.

Diese Arbeit wurde finanziell unterstützt und gesponsert von der Dublin City University.

Rechte

Es gibt eine Fähigkeit zur Verwaltung von geführten Touren:

Capabilities/tool/usertours:managetours

Sie ist für die Rolle Manager/in auf erlauben gesetzt.

Siehe auch

JSONLint - a JSON validator nützlich zur Prüfung einer JSON Datei

@@ Zeile 1: / Zeile 1: @@
 {{Darstellung}}
-{{Neu}}
-{{Zum Überarbeiten}}
+==Einführung==
+Geführte Touren sind Schritt-für-Schritt-Anleitungen in verschiedenen Bereichen von Moodle. Adminsitrator/innen können neue Touren anlegen oder von der Seite [https://moodle.net/mod/data/view.php?id=17 Moodle.net/tours] importieren. Der Filter [[Mehrsprachiger Inhalt]] ermöglichst es, dass Touren in verschiedenen Sprachen angezeigt werden. Eine Demonstration dieser Funktionalität sehen Sie in diesem [https://youtu.be/hhLVvyP3DU0 Screencast].
-Geführte Touren sind Schritt-für-Schritt-Anleitungen in verschiedenen Bereichen von Moodle. Adminsitrator/innen können neue Touren anlegen oder von der Seite [https://moodle.net/mod/data/view.php?id=17 Moodle.net/tours] importieren. Der Filter [[Mehrsprachiger Inhalt]] ermöglichst es, dass Touren in verschiedenen Sprachen angezeigt werden. Eine Demonstration dieser Funktionalität sehen Sie in diesem [https://youtu.be/hhLVvyP3DU0 Screencast].
+{{MediaPlayer | url = https://youtu.be/hhLVvyP3DU0 | desc = Geführte Touren}}
 ==Wie wird eine geführte Tour aufgesetzt?==
@@ Zeile 12: / Zeile 12: @@
 [[Image:touren.png|600px]]
-*For each of your existing tours, you can click either directly on its name or on its View action icon to view its current listed steps
+*Bei jeder Tour können Sie auf den Namen oder auf das Vorschau-Symbol [[Image:preview.svg|16px|baseline]] klicken, um die einzelnen Schritte der Tour zu sehen.
-*Each tour can be individually enabled or disabled as required in its settings page.
+*Jede Tour kann durch Klicken auf das Auge-Symbol aktiviert [[Image:show.svg|16px|baseline]] oder deaktiviert [[Image:hide.svg|16px|baseline]] werden.
-'''Note:''' ''You can have multiple tours created for the same page destination, but  you should only have one per page enabled at one time.''
+{{Neu}}*Sie können eine Tour durch Klicken auf das Symbol [[Image:copy.svg|16px|baseline]] duplizieren und anschließend anpassen.
-*Icons against each tour allow you to view, edit, export or delete it.
+'''Hinweis''': Sie können für eine Moodle-Seite mehrere Touren anlegen, aber es darf immer noch eine Tor pro Moodle-Seite aktiviert sein.
-*Tours will be displayed on any page whose URL matches the specified path value, for instance:
+* Hinter jedem Tournamen finden Sie entsprechende Symbole, um die Tour anzusehen [[Image:preview.svg|16px|baseline]], zu bearbeiten [[Image:settings.svg|16px|baseline]], zu exportieren [[Image:export.svg|16px|baseline]] oder zu löschen [[Image:delete.svg|16px|baseline]].
-#/my/% - to match the Dashboard
+*Geführte Touren werden auf allen Seiten angezeigt, deren URL zum Pfad passt, der in den Einstellungen der Tour angegeben wurde, zum Beispiel:
-#/course/view.php?id=2 - to match a specific course
+#''my/%'' - Dashboard
-#/mod/forum/view.php% - to match the forum discussion list
+#''/course/view.php?id=2'' - Kurs mit der ID = 2
-#/user/profile.php% - to match the user profile page
+#''/mod/forum/view.php%'' - Liste aller Diskussionsthemen eines Forums
-*Each tour will be configured with default step settings which you can edit in the settings page:
+#''/user/profile.php%'' - Nutzerprofilseite
-*Placement: Top, Bottom (Default), Left, Right. This determines where the step shows relative to its matching block or CSS selector on the page.
+*Zu jeder Tour werden Schritte angegeben, die in den Einstellungen der Tour bearbeitet werden können:
-*Show if target not found: No (Default), Yes. This determines whether the step is shown or not when the target has not been found.
+#''Platzierung'': Gibt an, wo der Schritt angezeigt wird (oberhalb, unterhalb, rechts, links von der Stelle, um die es geht)
-*Show with backdrop: No (Default), Yes. If yes, the step appears surrounded by a darkened backdrop to emphasis its content and location.
+#''Anzeigen, wenn Ziel nicht gefunden'': Gibt an, ob ein Schritt angezeigt wird oder nicht (Standardeinstellung: ''Nein''), falls die Stelle, um die es geht, nicht gefunden werden kann.
-*Move on click: No (Default), Yes. If yes, the tour continues to the next step when the user clicks within the block or area targeted by the current step.
+#''Mit Hervorhebung anzeigen'': Gibt an, ob der Schritt besonders hervorgehoben wird oder nicht (Standardeinstellung: ''Nein'').
-'''Note:''' ''If you want users to be able to fill in forms as they work through the tour, then don't use a backdrop.''
+#''Bei Klick ausführen'': Wenn diese Option auf ''Ja'' gesetzt ist, dann wird die Tour erst fortgesetzt, wenn die Person im aktuellen Schritt an der angegebenen Stelle klickt (Standardeinstellung: ''Nein'').
-*Tour filters allow you to choose the role(s) and theme(s) for which the tour will be displayed.
+'''Hinweis''': Wenn Sie möchten, dass die Nutzer/innen während der Tour ein Formular ausfüllen, dann setzen Sie die Einstellung ''Mit Hervorhebung anzeigen'' auf ''Nein''.
+*Sie können in den Einstellungen der Tour wählen, für welche Rollen und Designs die Tour angezeigt wird.
 ==Wie füge ich Schritte in eine Tour ein?==
-* Either click directly on its name or on its View action icon to view the currently listed steps.
+*Auf der Übersichtsseite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration >  Darstellung > Geführte Touren'' klicken Sie auf den Namen der Tour oder auf das Bearbeiten-Symbol [[Image:settings.svg|16px|baseline]] hinter dem Namen.
-*Here are the initial steps for a sample tour for the Dashboard page:
+*Hier sehen Sie einige Schritte einer geführten Tour durch das [[Dashboard]]:
-[[File:usertour steps page.png|thumb|600px|center]]
+[[Image:dashboardtour.png|600px]]
-*Click on the 'New step' link and select what you want to highlight:
+*Um einen Schritt in eine Tour einzufügen, klicken Sie auf den Link ''Neuer Schritt''.
-#Block - to display next to a matching block on the page. Select the block you want from the dropdown.
+*Wählen Sie als erstes einen ''Zieltyp'' aus: Das ist die Stelle auf der Moodle-Seite, an der der Schritt angezeigt werden soll. Wenn die Stelle ein Block ist, dann wählen Sie die Option ''Block'' aus und wählen dann im Auswahlmenü ''Block'' den konkreten Blocktyp aus. Wenn die Stelle ein bestimmter CSS-Bereich ist, dann wählen Sie als Zieltyp die Option ''Auswahl'' aus und tragen dann im Textfeld ''CSS Selector'' die genaue CSS-Bezeichnung ein (siehe Beispiele unten). Wenn es keine spezifische Stelle auf der Seite gibt, an der der Schritt angezeigt werden soll, dann wählen Sie die Option ''In der Seitenmitte anzeigen''.
-#CSS Selector - to display next to a matching selector on the page. Type in the relevant selector. (See examples below.)
+*Geben Sie für den Schritt einen ''Titel'' an und tragen Sie im Textbereich ''Inhalt'' eine passende Beschreibung ein.
-#Display in the middle of the page
+*Im Bereich ''Optionen'' wählen Sie weitere Einstellungen:
-*Add the title and content
+:*''Platzierung'' - wo soll die Beschreibung angezeigt werden.
-*For all types, select whether to display the step with a darkened backdrop
+:*''Anzeigen, wenn Ziel nicht gefunden''
-*For blocks or selectors, select the Placement option for where to place the display
+:*''Mit Hervorhebung anzeigen''
-*For blocks or selectors, select whether to display the step if its target isn’t found
+:*''Bei Klick ausführen''
-*For blocks or selectors, select whether to move on click, ie move to next step when target is clicked
+*Klicken Sie abschließend auf den Button ''Änderungen speichern''.
-*Click on 'Save changes'
 ==Wie funktionieren geführte Touren?==
-[[File:usertours01.png|thumb|600px|center]]
+[[Image:usertours01.png|600px]]
-Once a user tour has been created and enabled, the first time that any user views a page which matches that user tour’s page (path) settings, the user tour will automatically start to display, starting with the first step. Each tour step will display its title and content, along with three button options:
-*Prev - to return to the previous step in the tour
+Wenn eine geführte Tour angelegt und aktiviert ist, kann es losgehen. Sobald Nutzer/innen die entsprechende Moodle-Seite danach zum ersten Mal aufrufen, startet die Tour mit dem ersten Schritt. Zu jedem Schritt wird der Titel und der Inhalt (die Beschreibung) angezeigt sowie drei Buttons:
-*Next - to go to the next step in the tour
+*''Zurück'' - führt zum vorhergehenden Schritt der Tour
-*End Tour - to exit out of the tour completely
+*''Weiter'' - führt zum nächsten Schritt der Tour
-Any time a user wishes to re-run the page's tour, they can click on the "Reset user tour on this page" link at the bottom of the page.
+*''Tour-Ende'' - beendet die Tour.
+Wenn Nutzer/innen eine Tour wiederholen wollen, können Sie unten auf der Moodle-Seite auf den Link ''Tour erneut starten'' klicken.
+==Filter==
+Wenn Sie eine geführte Tour aufsetzen, können Sie in den Einstellungen festlegen, in welchem Kontext die Tour angezeigt wird. Sie können filtern nach
+*Rolle
+*Design
+und
+*Kursbereich
+*Kurs
+*Kursformat
 ==Hilfe für CSS Selektoren==
-If you wish to use CSS selectors as part of your user tour, your browser's developer tools will be very useful in helping you create these selectors:
+Wenn Sie als Zieltyp eines Schrittes CSS Selektoren verwenden wollen, dann sind Browser-Entwicklerwerkzeuge sehr hilfreich, um die passenden Selektoren zu finden:
 *[https://developer.chrome.com/devtools#dom-and-styles Google Chrome]
 *[https://developer.mozilla.org/en-US/docs/Tools/DOM_Property_Viewer Mozilla Firefox]
@@ Zeile 60: / Zeile 70: @@
 ===Beispiel für einen einfachen CSS Selektor===
+Hier finden Sie ein Beispiel für einen Schritt mit CSS Selektor als Zieltyp.
-[[File:CSS_selector_for_user_picture_in_a_user_tour.png|400px]]
+[[Image:usertours02.png|600px]]
-The settings above will produce this in the user tour:
+Diese Einstellungen führen zu folgender Darstellung in der geführten Tour:
-[[File:user picture chosen by CSS selector in a user tour.png|400px]]
+[[Image:usertours03.png|600px]]
-* How did we know that .userpicture would select just the Moodle user picture?
+Woher wissen wir, dass der CSS Selektor für das Nutzermenü<pre>.usermenu</pre> ist? Das finden wir heraus, wenn wir den HTML Inspector im Firefox verwenden (siehe unten).
-* By looking at the page with an HTML inspector in Firefox, as described in the 'Help with CSS selectors' section below.
 ===Weitere einfache Beispiele für CSS Selektoren===
- '''.breadcrumb''' These site links (known as breadcrumbs) will always show where you are in the site and how to return to a main page, such as your Dashboard or your course main page.
+*''.breadcrumb'' - das sind die Links in der Navigationsleiste oben auf jeder Moodle-Seite. Sie zeigen an, wo in Moodle Sie sich gerade befinden und helfen Ihnen, schnell auf übergeordnete Seite zu gelangen.
+*''.userpicture'' - das ist das Nutzerbild, das an verschiedenen Stellen in Moodle angezeigt wird (in Kursteilnehmerlisten, bei Forumsbeiträgen, in Bewertungsübersichten, usw.)
- '''.usermenu'''  This is the user menu. It contains links to your Dashboard, Messages, Profile, and your Preferences.
+*''[value="Customise this page"]'' - fügen Sie neue Blöcke auf der Moodle-Seite hinzu, indem Sie hier klicken.
- '''[value="Customise this page"]'''  Add your own blocks of content by clicking here!
 ==Mehrsprachigkeit==
+Wenn Ihre Moodle-Site mehrsprachig ist, dann können Sie diese Mehrsprachigkeit auch bei geführten Touren nutzen. Verwenden Sie dazu die mehrsprachige Formatierung in den Titeln und Beschreibungen der einzelnen Schritte der Tour. Detaillierte Informationen zu dieser Formatierung finden Sie im Artikel [[Mehrsprachiger Inhalt]].
-If your Moodle site is already set up or intending to be enabled for multi-lingual usage, tours are completely compatible with this requirement. Using the multi-lang filter formatting, each tour step’s titles and content, displayed to the user, can be edited to cater for multi-lingual requirements. Please see [[Multi-language_content_filter]] for further detailed instructions on how to enable, format and submit multi-lingual strings for your Moodle site.
+Vergessen Sie nicht, diesen Filter auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Plugins > Filter > Übersicht'' zu aktivieren, '''bevor''' Sie mehrsprachige geführte Touren anlegen oder importieren. Andernfalls sehen die Nutzer/innen alle Texte in allen Sprachen.
-Please remember to go to '' Dashboard ► Site administration ► Plugins ► Filters ► Manage filters '' in order to enable the [[Multi-language_content_filter]] before importing any multi-language user tours into your site, or the users will see ALL the texts in ALL the languages simultaneously, as the following image illustrates:
+==Geführte Touren übersetzen==
+Siehe [https://docs.moodle.org/dev/Translating_User_tours_from_Moodle.net Entwicklerdokumentation] (englisch).
-[[File:Multilang user tour when multilang filter NOT properly configured.png|300px]]
-When properly configured, a multi-language user tour will be automatically displayed in the user's preferred language, as seen in the following Dashboard tours starting pages in Spanish, English and French (in the same server):
-[[File:Multilang user tour in Spanish.png|300px]]
+==Anmerkung zum Tastaturfokus bei geführten Touren (Tabstopps)==
+Wenn  Sie Ihre geführte Tour mit der Tastatur testen, kann es manchmal passieren, dass es an Stellen, an denen es nur einen Tabstopp geben sollte, zwei Tabstopps gibt. Z.B. haben Sie diesen HTML-Code
-[[File:Multilang user tour in English.png|300px]]
+<pre>
+    <div class="my-link">
+        <a href="https://moodle.org/">Example link</a>
+    </div>
+</pre>
-[[File:Multilang user tour in French.png|300px]]
+und nutzen den CSS-Selektor <tt>.my-link</tt> für Ihre Tour-Schritte, dann gibt es zwei Tabstopps für den einen Link. Das liegt daran, dass das Zielobjekt der Tour immer in einem Tabstopp eingebaut ist.
-==Geführte Touren übersetzen==
+Um dies zu verhindern, müssen Sie das Zielobjekt der Tour mit <tt>.my-link a</tt> auf den Link selbst gelegt werden. Gleiches gilt für ähnliche Situationen.
-Siehe [https://docs.moodle.org/dev/Translating_User_tours_from_Moodle.net Entwicklerdokumentation] (englisch).
 ==Teilen von geführten Touren==

Documentation