Matrix - Versionsgeschichte

Ghillenb: /* Datenfluss zwischen Moodle und Matrix */

2024-05-07T10:25:07Z

Datenfluss zwischen Moodle und Matrix

← Nächstältere Version		Version vom 7. Mai 2024, 10:25 Uhr
Zeile 74:		Zeile 74:
	Das folgende Diagramm zeigt den Datenfluss zwischen Moodle und Matrix.		Das folgende Diagramm zeigt den Datenfluss zwischen Moodle und Matrix.

	[[File:Data flow diragram-communication(1).png\|~~900px~~]]		[[File:Data flow diragram-communication(1).png\|1000px]]

	==Rechte==		==Rechte==

Ghillenb: /* Datenfluss zwischen Moodle und Matrix */

2024-05-07T10:24:58Z

Datenfluss zwischen Moodle und Matrix

← Nächstältere Version		Version vom 7. Mai 2024, 10:24 Uhr
Zeile 74:		Zeile 74:
	Das folgende Diagramm zeigt den Datenfluss zwischen Moodle und Matrix.		Das folgende Diagramm zeigt den Datenfluss zwischen Moodle und Matrix.

	[[File:Data flow diragram-communication(1).png\|~~800px~~]]		[[File:Data flow diragram-communication(1).png\|900px]]

	==Rechte==		==Rechte==

Ghillenb: /* Matrix-Einstellungen (für Administrator/innen) */

2024-05-07T10:24:13Z

Matrix-Einstellungen (für Administrator/innen)

← Nächstältere Version		Version vom 7. Mai 2024, 10:24 Uhr
Zeile 30:		Zeile 30:

	=== Matrix-Einstellungen (für Administrator/innen)===		=== Matrix-Einstellungen (für Administrator/innen)===
	~~The~~ Matrix ~~communication provider allows~~ Moodle ~~LMS courses to have an associated room in a~~ [https://element.io/ Matrix Element] ~~instance~~. ~~It also provides user management by synchronising participants in a course with the associated~~ Matrix ~~Element room~~.		Der Matrix-Kommunikationsprovider ermöglicht es, in Moodle-Kursen eine zugehörige [https://element.io/ Matrix Element]-Instanz für die Kommunikation im Kurs bereitzustellen. Er bietet auch eine Nutzerverwaltung, indem er Teilnehmer/innen eines Kurses mit dem zugehörigen Matrix-Raum synchronisiert.

	~~Currently, the integration supports the~~ [https://github.com/matrix-org/synapse Synapse] ~~homeserver for setting up the provider service, and the~~ [https://element.io/ Matrix Element] ~~messaging client for accessing the room~~. ~~To configure your~~ Moodle ~~LMS instance with Matrix you will need the following~~:		Derzeit unterstützt die Integration den [https://github.com/matrix-org/synapse Synapse]-Homeserver zur Einrichtung des Providers und den [https://element.io/ Matrix Element]-Messaging-Client zum Zugriff auf den Raum. Um Matrix in Ihre Moodle-Site zu integrieren, benötigen Sie Folgendes:

	* URL ~~of the~~ Synapse ~~homeserver~~		* die URL des Synapse-Homeservers
	* API ~~access token for a~~ Synapse ~~admin user~~		* das API-Zugriffstoken für einen Synapse-Administratornutzer
	* URL ~~of an~~ Element ~~web server to use~~		* die URL eines Element-Web-Servers

			[[File:HomeserverURL.png\|700px]]

	~~[[File:HomeserverURL~~.~~png\|alt=Configuring~~ Matrix ~~provider\|700x700px]]~~		Gehen Sie auf die Seite ''Website-Administration > Plugins > Kommunikation > Kommunikationsprovider verwalten''. Aktivieren Sie Matrix, indem Sie auf das zugehörigen Auge-Symbol klicken.

	~~To configure your Moodle LMS instance to use the~~ Matrix ~~provider~~:		Auf der Seite ''Website-Administration > Plugins > Kommunikation > Matrix'' können Sie folgende Einstellungen vornehmen:
			*'''Homeserver-URL''' - Tragen Sie hier die URL Ihres Synapse-Servers ein.
	~~#Enter the URL of your Synapse server in the~~ 'Homeserver URL' ~~field (matrixhomeserverurl)~~		*'''Zugriffstoken''' - Tragen Sie hier das Synapse-Server API Zugriffstoken ein.
	~~#Enter the Synapse server API Access token in the~~ '~~Access token~~' ~~field (matrixaccesstoken). See~~ 'Synapse API ~~access token generation' below~~.		*'''Element-Web-URL''' - Tragen Sie hier die URL des Element-Webservers ein.
	~~#Enter the URL of the Element web server in the~~ 'Element ~~web~~ URL' ~~field (matrixelementurl)~~		*Klicken Sie abschließend auf den Button ''Änderungen speichern''.
	~~#Click Save changes~~.

			==== Synapse API Zugriffs-Token generieren (für Administrator/innen) ====
			Um ein Synapse-Server API Zugriffstoken für Ihre Moodle-Site zu generieren, benötigen Sie Zugriff auf ein Terminal und die Anmeldedaten (Anmeldename, Kennwort) eines Admin-Nutzerkontos für Ihren Synapse-Server.

			Geben Sie Folgendes im Terminal ein:
			<pre>
			curl -XPOST -d '{"type":"m.login.password", "username":"@admin:synapse", "password":"secretpass"}' "https://synapse:8008/_matrix/client/r0/login"
			</pre>
			*Dabei ist username:
			<pre>
			@<user name on home server>:<home server domain>
			</pre>
			*password ist das Kennwort des Admin-Nutzerkontos.

	~~==== Synapse API access token generation (for site administrators) ====~~		Der erzeugte Ausdruck sieht ungefähr so aus:
	~~To generate an API access token for Moodle LMS, you need access to a terminal and use an existing username and password for the admin of your Synapse server instance.~~		<pre>

	* The username will need to be formatted as follows: '''@<username_on_homeserver>:<homeserver_domain>'''
	* Password is the admin user's regular password.


	~~To generate an access token to be used with Moodle LMS, enter the following into a terminal~~:~~<pre>~~
	~~curl -XPOST -d '{"type":"m.login.password", "user":"@admin:synapse", "password":"secretpass"}' "https://synapse:8008/_matrix/client/r0/login"~~
	~~</pre>~~
	~~The returned value will look something like this:~~<pre>
	{"user_id":"@admin:synapse","access_token":"syt_YWRtaW4_OQNsHwWoObhseRAWmUCs_2T29if","home_server":"synapse","device_id":"JPAIBCQCSB"}		{"user_id":"@admin:synapse","access_token":"syt_YWRtaW4_OQNsHwWoObhseRAWmUCs_2T29if","home_server":"synapse","device_id":"JPAIBCQCSB"}
	</pre>		</pre>
	~~The ''~~access_token~~'' field is the API access token to use~~ in ~~the~~ Moodle ~~LMS~~ Matrix ~~communication provider settings~~.		Das access_token Feld ist das Zugriffstoken, dass in Moodle in den Matrix-Einstellungen eingetragen werden muss.

	==== ~~Data flow between~~ Moodle ~~LMS and~~ Matrix ====		==== Datenfluss zwischen Moodle und Matrix ====
	*~~The current implementation uses the~~ Moodle ~~Course Communication settings to set the room name and room topic for the~~ Matrix ~~room~~. ~~If those fields are empty~~, ~~the course name is used as the room name and the room topic is kept empty~~.		*Die aktuelle Implementierung verwendet die Kommunikationseinstellungen im Moodle-Kurs, um den Raumnamen und das Raumthema für den Matrix-Raum festzulegen. Wenn diese Felder leer sind, wird der Kursname als Raumname verwendet und das Raumthema bleibt leer.
	*Matrix ~~usernames are generated using~~ Moodle ~~usernames and are necessary for adding~~ Matrix ~~users to a room~~.		*Matrix-Nutzernamen werden aus den Moodle-Nutzernamen generiert und sind erforderlich, um Matrix-Nutzer/innen in einen Matrix-Raum einzutragen.
	*~~Users are only created~~ in Matrix ~~if they have not been created yet~~, ~~or no mapping to that user is recorded with~~ Moodle ~~LMS~~.		*Nutzer/innen werden in Matrix nur dann angelegt, wenn sie noch nicht erstellt wurden oder keine Zuordnung zu einem Moodle-Nutzerkonto existiert.

			Das folgende Diagramm zeigt den Datenfluss zwischen Moodle und Matrix.

	~~The following diagram shows the flow of data between Moodle LMS and Matrix.~~		[[File:Data flow diragram-communication(1).png\|800px]]
	[[File:Data flow diragram-communication(1).png\|~~alt=Data flow diragram-communication\|left\|frame\|Data flow diragram-communication~~]]

	==Rechte==		==Rechte==

Ghillenb am 7. Mai 2024 um 10:06 Uhr

2024-05-07T10:06:08Z

← Nächstältere Version		Version vom 7. Mai 2024, 10:06 Uhr
Zeile 1:		Zeile 1:
	{{Kommunikation}}		{{Kommunikation}}
	[https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https://element.io/download Element].

	~~Moodle HQ itself uses~~ Matrix ~~heavily for internal communication~~, ~~as well as for the~~ [https://matrix.to/#/~~#community:moodle~~.~~com Moodle Community chat rooms~~].		[https://de.wikipedia.org/wiki/Matrix_(Protokoll) Matrix] ist eine offene Kommunikationsplattform vergleichbar mit MS Teams, Slack, Telegram und WhatsApp. Siehe [https://matrix.org matrix.org] für detaillierte Informationen. Die Plattform unterstützt nicht nur Textnachrichten, Bilder und Dateiaustausch, sondern bietet auch volle Audio- und Videokonferenzfunktionen. Im Gegensatz zu anderen Plattformen gibt es viele Clients, die Sie verwenden können, aber der beliebteste ist [https://element.io/download Element].

	~~Anyone can just create a free account on matrix.org (you will get an address like '''@yourname~~:matrix.~~org'''), but because it is open source, you can also run your own private Matrix server for your organisation, then everyone will have accounts like '''@yourname~~:~~yourdomain~~.com~~'''. Any user on any domain can send messages to any other Matrix domain (similar to how email works)~~.		Moodle HQ selbst verwendet Matrix für die interne Kommunikation und für die [https://matrix.to/#/#community:moodle.com Moodle Community-Chaträume].

	~~=== Configuring Matrix in a course~~ (~~for teachers~~) ~~===~~		Jeder kann einfach ein kostenloses Konto auf matrix.org erstellen (Sie erhalten eine Adresse wie '''@deinname:matrix.org'''), aber da die Plattform Open Source ist, können Sie auch Ihren eigenen privaten Matrix-Server für Ihre Organisation aufsetzen. Dann haben alle Nutzer/innen Konten wie '''@deinname:deinedomain.com'''. Alle Nutzer/innen aus jeder Domain können Nachrichten an jede andere Matrix-Domain senden (ähnlich wie bei E-Mails).
	~~Once the Moodle admin has configured your Moodle site to connect to a~~ Matrix ~~server, teachers will have the option to select~~ Matrix ~~as a provider in courses~~.

	~~Choosing~~ Matrix ~~from the communication configuration in the course will prompt you to enter~~ in ~~a room name and room topic. Some values are provider specific and will vary between providers. The screenshot below demonstrates a typical Matrix room configuration for a course~~.		=== Matrix-Einstellungen im Kurs (für Trainer/innen) ===
			Sobald die Moodle-Administration den Matrix-Kommunikationsprovider systemweit konfiguriert hat, können Trainer/innen Matrix als Kommunikationsprovider in ihrem Kurs auszuwählen.

	~~[[File:MatrixProvider~~.~~png\|alt=Course communication settings for~~ Matrix~~\|700x700px]]~~		Wenn Sie Matrix als Kommunikationsprovider im Kurs auswählen, müssen Sie einen Raumnamen und ein Thema angeben. Einige Einstellungen sind Provider-spezifisch. Der untenstehende Screenshot zeigt eine typische Matrix-Raumkonfiguration für einen Kurs.

	~~==== Room name ====~~		[[File:MatrixProvider.png\|700px]]
	~~Providing a room name is optional. If no room name is entered the course name will be used~~.

	==== ~~Room topic~~ ====		==== Raumname ====
	~~The room topic is also~~ optional ~~and effectively works as a description for the room~~. ~~As explained above~~, ~~Matrix has its own set of individual settings and room topic is one of them~~.		Die Angabe eines Namens ist optional. Wenn Sie das Feld leer lassen, wird der Kursname verwendet.

	==== ~~Room moderators~~ ====		==== Raumthema====
	~~Room moderators will have elevated privileges in~~ Matrix ~~rooms. There is a hierarchy that is determined by the roles assigned in Moodle~~. ~~In order of privilege, they are:~~		Diese Angabe ist ebenfalls optional und dient der Beschreibung des Raums. Wie oben erklärt hat Matrix seine eigenen Einstellungen und das Raumthema ist eine davon.

	~~#Admin~~		==== Matrix-Moderator/in ====
	~~#Managers, teachers, non~~-~~editing teachers~~		Matrix-Moderator/innen haben erweiterte Rechte in Matrix-Räumens. Es gibt eien Hierarchie basierend auf den Rollen in Moodle. Dazu gehören in absteigender Reihenfolge:
	~~#Students~~

	~~Teachers~~, ~~non-editing teachers and managers will automatically have the moderator capability in the Matrix room. This role (communication~~/~~matrix:moderator) can be changed in the ''Define role'' settings in Site administration.~~		#Administrator/innen
			#Manager/innen, Trainer/innen mit und ohne Bearbeitungsrecht
			#Teilnehmer/innen

	===~~Configuring~~ Matrix (~~for site administrators~~)===		Manager/innen, Trainer/innen mit und ohne Bearbeitungsrecht werden automatisch zu Moderator/innen im Matrix-Raum. Das kann über das Recht ([[Capabilities/communication/matrix:moderator\|communication/matrix:moderator]]) in den Rolleneinstellungen geändert werden.

			=== Matrix-Einstellungen (für Administrator/innen)===
	The Matrix communication provider allows Moodle LMS courses to have an associated room in a [https://element.io/ Matrix Element] instance. It also provides user management by synchronising participants in a course with the associated Matrix Element room.		The Matrix communication provider allows Moodle LMS courses to have an associated room in a [https://element.io/ Matrix Element] instance. It also provides user management by synchronising participants in a course with the associated Matrix Element room.

Ghillenb am 7. Mai 2024 um 09:27 Uhr

2024-05-07T09:27:28Z

← Nächstältere Version		Version vom 7. Mai 2024, 09:27 Uhr
Zeile 1:		Zeile 1:
	{{~~Communication~~}}		{{Kommunikation}}
	[https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https://element.io/download Element].		[https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https://element.io/download Element].

Ghillenb: Die Seite wurde neu angelegt: „{{Communication}} [https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https…“

2024-05-07T09:27:10Z

Die Seite wurde neu angelegt: „{{Communication}} [https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https…“

Neue Seite

{{Communication}}
[https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix] is an open and federated messaging platform that compares well against MS Teams, Slack, Telegram and WhatsApp. See [https://matrix.org matrix.org] for all the details. It not only supports typical text messages, images and files, but also has full audio and video conference calling. Unlike other platforms, there are many clients you can use, but the most popular one is [https://element.io/download Element].

Moodle HQ itself uses Matrix heavily for internal communication, as well as for the [https://matrix.to/#/#community:moodle.com Moodle Community chat rooms].

Anyone can just create a free account on matrix.org (you will get an address like '''@yourname:matrix.org'''), but because it is open source, you can also run your own private Matrix server for your organisation, then everyone will have accounts like '''@yourname:yourdomain.com'''. Any user on any domain can send messages to any other Matrix domain (similar to how email works).

=== Configuring Matrix in a course (for teachers) ===
Once the Moodle admin has configured your Moodle site to connect to a Matrix server, teachers will have the option to select Matrix as a provider in courses.

Choosing Matrix from the communication configuration in the course will prompt you to enter in a room name and room topic. Some values are provider specific and will vary between providers. The screenshot below demonstrates a typical Matrix room configuration for a course.

[[File:MatrixProvider.png|alt=Course communication settings for Matrix|700x700px]]

==== Room name ====
Providing a room name is optional. If no room name is entered the course name will be used.

==== Room topic ====
The room topic is also optional and effectively works as a description for the room. As explained above, Matrix has its own set of individual settings and room topic is one of them.

==== Room moderators ====
Room moderators will have elevated privileges in Matrix rooms. There is a hierarchy that is determined by the roles assigned in Moodle. In order of privilege, they are:

#Admin
#Managers, teachers, non-editing teachers
#Students

Teachers, non-editing teachers and managers will automatically have the moderator capability in the Matrix room. This role (communication/matrix:moderator) can be changed in the ''Define role'' settings in Site administration.

===Configuring Matrix (for site administrators)===
The Matrix communication provider allows Moodle LMS courses to have an associated room in a [https://element.io/ Matrix Element] instance. It also provides user management by synchronising participants in a course with the associated Matrix Element room.

Currently, the integration supports the [https://github.com/matrix-org/synapse Synapse] homeserver for setting up the provider service, and the [https://element.io/ Matrix Element] messaging client for accessing the room. To configure your Moodle LMS instance with Matrix you will need the following:

* URL of the Synapse homeserver
* API access token for a Synapse admin user
* URL of an Element web server to use

[[File:HomeserverURL.png|alt=Configuring Matrix provider|700x700px]]

To configure your Moodle LMS instance to use the Matrix provider:

#Enter the URL of your Synapse server in the 'Homeserver URL' field (matrixhomeserverurl)
#Enter the Synapse server API Access token in the 'Access token' field (matrixaccesstoken). See 'Synapse API access token generation' below.
#Enter the URL of the Element web server in the 'Element web URL' field (matrixelementurl)
#Click Save changes.

==== Synapse API access token generation (for site administrators) ====
To generate an API access token for Moodle LMS, you need access to a terminal and use an existing username and password for the admin of your Synapse server instance.

* The username will need to be formatted as follows: '''@<username_on_homeserver>:<homeserver_domain>'''
* Password is the admin user's regular password.

To generate an access token to be used with Moodle LMS, enter the following into a terminal:<pre>
curl -XPOST -d '{"type":"m.login.password", "user":"@admin:synapse", "password":"secretpass"}' "https://synapse:8008/_matrix/client/r0/login"
</pre>
The returned value will look something like this:<pre>
{"user_id":"@admin:synapse","access_token":"syt_YWRtaW4_OQNsHwWoObhseRAWmUCs_2T29if","home_server":"synapse","device_id":"JPAIBCQCSB"}
</pre>
The ''access_token'' field is the API access token to use in the Moodle LMS Matrix communication provider settings.

==== Data flow between Moodle LMS and Matrix ====
*The current implementation uses the Moodle Course Communication settings to set the room name and room topic for the Matrix room. If those fields are empty, the course name is used as the room name and the room topic is kept empty.
*Matrix usernames are generated using Moodle usernames and are necessary for adding Matrix users to a room.
*Users are only created in Matrix if they have not been created yet, or no mapping to that user is recorded with Moodle LMS.

The following diagram shows the flow of data between Moodle LMS and Matrix.
[[File:Data flow diragram-communication(1).png|alt=Data flow diragram-communication|left|frame|Data flow diragram-communication]]

==Rechte==
*[[Capabilities/communication/matrix:moderator| Matrix moderator]].

[[en:Matrix]]
[[es:Matrix]]