From 8bc9f30459e42bce748d09f93d358803da130b8e Mon Sep 17 00:00:00 2001 From: Philipp Lang Date: Thu, 15 Jun 2023 16:58:52 +0200 Subject: [PATCH] update docs --- doc/page/firststeps/first.md | 2 +- doc/page/mail/index.md | 15 ++++++++++ doc/page/mail/maildispatcher.md | 23 +++++++++++++++ doc/page/mail/mailgateway.md | 51 +++++++++++++++++++++++++++++++++ 4 files changed, 90 insertions(+), 1 deletion(-) create mode 100644 doc/page/mail/index.md create mode 100644 doc/page/mail/maildispatcher.md create mode 100644 doc/page/mail/mailgateway.md diff --git a/doc/page/firststeps/first.md b/doc/page/firststeps/first.md index 47d11fbc..04475a13 100644 --- a/doc/page/firststeps/first.md +++ b/doc/page/firststeps/first.md @@ -38,7 +38,7 @@ Für einige Prozesse benötigt Adrema die Standard-Gruppierungsnummer. Dies ist {% include imgcap.html img='init-default-groupid' caption="Standard-Gruppierungsnummer" %} -## 4. Initialisierung starten +## Initialisierung starten Danach führt Adrema im Hintergrund selbstständig einen ersten Abgleich durch. Dies kann je nach Datenmenge einige Minuten bis Stunden dauern. diff --git a/doc/page/mail/index.md b/doc/page/mail/index.md new file mode 100644 index 00000000..bc200d32 --- /dev/null +++ b/doc/page/mail/index.md @@ -0,0 +1,15 @@ +--- +layout: page +title: Mailverteiler +has_children: true +nav_order: 2 +--- + +# Mailverteiler + +Mit der Adrema kannst du E-Mail-Verteiler (also E-Mail-Adressen, die an sämtliche andere E-Mail-Adressen weiterleiten, sowas wie "eltern@stamm-bipi.de") verwalten. + +Dabei werden E-Mail-Adressen anhand von Filter-Regeln automatisch in Verteiler aufgenommen oder entfernt bzw aktuell gehalten. Die Verteiler-Verwaltung ist damit Adrema-intern möglich. + +Auf den folgenden Seiten erkläre ich dir, wie du eine Verbindung mit deinem bestehenden E-Mail-System herstellst, danach Verteiler anlegst und diese aktuell hälst. + diff --git a/doc/page/mail/maildispatcher.md b/doc/page/mail/maildispatcher.md new file mode 100644 index 00000000..f22aff2f --- /dev/null +++ b/doc/page/mail/maildispatcher.md @@ -0,0 +1,23 @@ +--- +layout: page +title: Verteiler verwalten +parent: Mailverteiler +nav_order: 2 +--- + +# Verteiler verwalten + +Wähle als Name den Namen der E-Mail-Adresse des Verteilers (das ist alles was vor dem "@" Zeichen steht). Es wird empfohlen, hier nur Kleinbuchstaben und "-" zu verwenden. + +Wähle danach die Verbindung aus. Es wird für den Verteiler die Domain dieser Verbindung verwendet. + +Wenn du also eine Verbindung mit der Domain "bipi.de" angelegt hast, einen Verteiler mit dieser Verbindung erstellst und dabei als Namen "leute" vergibst, so würde sich daraus die E-Mail-Adresse + +leute@bipi.de + +ergeben. + +Wähle als nächstes die Kriterien aus, nach denen Mitglieder in den Verteiler aufgenommen werden sollen. Du erhälst darunter eine Vorschau der Mitglieder, so wie sie im Verteiler stehen würden. Dies ist natürlich nur eine Momentaufnahme. + +Mitglieder ohne E-Mail-Adressen werden nicht hinzugefügt. + diff --git a/doc/page/mail/mailgateway.md b/doc/page/mail/mailgateway.md new file mode 100644 index 00000000..78eaf745 --- /dev/null +++ b/doc/page/mail/mailgateway.md @@ -0,0 +1,51 @@ +--- +layout: page +title: Verbindungen verwalten +parent: Mailverteiler +nav_order: 1 +--- + + +# E-Mail-Verbindung anlegen + +Die Adrema selbst leitet keine E-Mails weiter, sondern regelt nur, wer mit welcher E-Mail-Adresse Mitglied in einem bereits bestehendem Verteiler ist. + +Um also die E-Mail-Verteiler-Funktion nutzen zu können, musst du vorher eine Verbindung zu einem bestehenden E-Mail-System herstellen. + +## Unterstützte Systeme + +### Lokal + +Dies ist genau genommen kein Verteiler-System, sondern lediglich eine Datenbank, die intern gepflegt wird. + +Wähle dies, wenn du einen eigene E-Mail-Server betreibst (Postfix, Qmail, o.ä.). + +### Mailman (3.0) + +Mailman ist ein Programm, mit dem man Mailinglisten verwalten kann. Es unterstützt eine Vielzahl von Typen von Mailinglisten, wie z.B. allgemeine Diskussionslisten aber auch reine Informationslisten für Veröffentlichungen. + +{: .info } +Es werden von AdReMa keine neuen Verteiler erstellt oder entfernt. Es werden nur die Mitglieder eines bestehenden Verteilers verwaltet. Du musst die E-Mail-Verteiler also vorher in Mailman angelegt haben, damit die AdReMa diese verwalten kann. + +[Zur Dokumentation vom Mailman](https://list.org/) + +Wenn bei deiner Stammes-Domain Mailman zum Einsatz kommt, kannst du dich mit deinem bestehenden Mailman-System verbinden. + +## Mailingliste erstellen + +Gehe hierzu auf "Einstellungen -> E-Mail-Verbindungen" und wähle "Neue Verbindung". + +Fülle nun die folgenden Felder aus: + +* Bezeichnung: frei wählbarer Name - technisch keine Bedeutung +* Domain: Domain der E-Mail-Adressen. Alle angelegten Verteiler, die diese Verbindung nutzen haben eine E-Mail-Adresse mit dieser Domain +* Typ: Wähle hier das System aus (siehe oben) + +### Zusatzeinstellungen bei Lokal + +Bei lokalen Verteilern sind keine weiteren Einstellungen erforderlich. Diese werden hingegen in deinem existierenden Mailserver (Postfix, Qmail, etc) konfiguriert. + +### Zusatzeinstellungen bei Mailman + +Trage hier die URL, Benutzer und Passwort für die Mailman-Schnittstelle ein. Diese hast du entweder beim Einrichten von Mailman selbst konfiguriert, oder dein Hoster wird diese Daten bereitstellen. +