| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
| kopano [2017/06/01 07:03] – Externe Bearbeitung 127.0.0.1 | kopano [2017/06/01 07:35] – angelegt lwsystems |
|---|
| | ====== Benno MailArchiv Plugin für Zarafa/Kopano ====== |
| | |
| | |
| Das Benno MailArchiv Plugin für Zarafa/Kopano bietet die Möglichkeit, innerhalb der Kopano Webapp auf die in Benno MailArchiv archivierten E-Mails zuzugreifen. Das Plugin integriert die Suche nach E-Mails nahtlos in die Kopano WebApp und DeskApp. | Das Benno MailArchiv Plugin für Zarafa/Kopano bietet die Möglichkeit, innerhalb der Kopano Webapp auf die in Benno MailArchiv archivierten E-Mails zuzugreifen. Das Plugin integriert die Suche nach E-Mails nahtlos in die Kopano WebApp und DeskApp. |
| |
| Systemvoraussetzungen: | Systemvoraussetzungen: |
| * Benno Core ab 2.2.5 / Benno Rest ab 2.2.5 | * Benno Core ab 2.2.5 / Benno Rest ab 2.2.5 |
| * ab Kopano Webapp 3.0 | * ab Kopano Webapp 3.0 |
| * ab Zarafa Webapp 2.0 | * ab Zarafa Webapp 2.0 |
| |
| Hinweis: | //Hinweis://Der Begriff "Kopano" kann synonym mit "Zarafa" verwendet werden. Die Informationen über dieses Plugin gelten also für die Kopano WebApp ab v3.0 und ebenso die Zarafa Webapp ab Version 2.0. |
| Der Begriff "Kopano" kann synonym mit "Zarafa" verwendet werden. Die Informationen über dieses Plugin gelten also für die Kopano WebApp ab v3.0 und ebenso die Zarafa Webapp ab Version 2.0. | |
| |
| |
| Installation: | ====== Installation ====== |
| 1) Entpacken Sie Kopano_Benno_*.tar.gz auf Ihrem Zarafa/Kopano-Server. Der darin enthaltene Ordner "benno" enthält das Benno MailArchiv Plugin für Zarafa/Kopano. | |
| 2) Der Ordner "benno" muss auf dem Kopano-Server in den Pfad "/usr/share/kopano-webapp/plugins/" verschoben werden (analog ".../zarafa-webapp/plugins/") | |
| 3) Sollte im "plugins"-Ordner bereits eine ältere Version des Benno MailArchiv Plugins für Zarafa/Kopano existieren, muss der alte "benno"-Plugin Ordner vor dem Verschieben gelöscht werden. | |
| 4) Der Ordnername "benno" darf nicht verändert werden, da das Plugin ansonsten nicht einwandfrei funktioniert. | |
| 5) Erforderlichenfalls müssen die Berechtigungen des Benno Plugins Order (benno/*) so angepasst werden, dass diese ausführbar sind. Grundsätzlich sollte das Plugin jedoch so funktionieren, wie es gepackt bzw. ausgeliefert wurde. | |
| |
| Aktivierung des installierten Plugins: | * Laden Sie die aktuelle Version des Benno MailArchiv Plugins für Zarafa/Kopano herunter:\\ https://www.benno-mailarchiv.de/download/plugin/ |
| 6) Aus der Zarafa/Kopano Webapp aus- und wieder einloggen. | * Entpacken Sie Kopano_Benno_*.tar.gz auf Ihrem Zarafa/Kopano-Server. Der darin enthaltene Ordner "benno" enthält das Benno MailArchiv Plugin für Zarafa/Kopano. |
| 7) In der Webapp unter Einstellungen -> Plugins das Plugin "Benno" aktivieren (die Seite bitte nach der Aufforderung neu laden). | * Der Ordner "benno" muss auf dem Kopano-Server in den Pfad "/usr/share/kopano-webapp/plugins/" verschoben werden (analog ".../zarafa-webapp/plugins/") |
| | * Sollte im "plugins"-Ordner bereits eine ältere Version des Benno MailArchiv Plugins für Zarafa/Kopano existieren, muss der alte "benno"-Plugin Ordner vor dem Verschieben gelöscht werden. |
| | * Der Ordnername "benno" darf nicht verändert werden, da das Plugin ansonsten nicht einwandfrei funktioniert. |
| | * Erforderlichenfalls müssen die Berechtigungen des Benno Plugins Order (benno/*) so angepasst werden, dass diese ausführbar sind. Grundsätzlich sollte das Plugin jedoch so funktionieren, wie es gepackt bzw. ausgeliefert wurde. |
| |
| Konfiguration des Zugangs zum Benno MailArchiv Server: | ===== Aktivierung des Plugins ===== |
| |
| Variante A: Globale, serverweite Konfiguration | * Aus der Zarafa/Kopano Webapp aus- und wieder einloggen. |
| A1) Im Ordner "benno" die Datei "settings.ini" mit einem Texteditor (bspw. vim, nano usw.) öffnen. | * In der Webapp unter Einstellungen -> Plugins das Plugin "Benno" aktivieren (die Seite bitte nach der Aufforderung neu laden). |
| A2) Die dort enthaltenen Standardwerte mit den passenden Werten für Ihr Netzwerk bzw. Ihren Benno MailArchiv Server eintragen. | |
| A3) Nach dem Ändern und Speichern der Datei aus der Zarafa/Kopano WebApp aus- und wieder einloggen. | |
| | ====== Konfiguration ====== |
| |
| Variante B: Benutzer-bezogene Konfiguration | ===== Variante A: Globale, serverweite Konfiguration ===== |
| B1) In der Zarafa/Kopano WebApp unter Einstellungen in der linken Leiste den (neuen) Menüpunkt "Benno" anklicken und dort bitte folgende Werte eintragen: | |
| |
| Serveradresse: Bspw. http(s)://<benno-hostname>/benno/rest.php (<benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen) | * Im Ordner "benno" die Datei "settings.ini" mit einem Texteditor (bspw. vim, nano usw.) öffnen. |
| Benno Container: Bspw. BennoContainer (Dies ist die Standardeinstellung. Sollten Sie mehrere Container in Benno MailArchiv konfiguriert haben, hier bitte den relevanten Containernamen eintragen. (In der aktuellen Version ist nur der hier angegebene Container nutzbar). | * Die dort enthaltenen Standardwerte mit den passenden Werten für Ihr Netzwerk bzw. Ihren Benno MailArchiv Server eintragen. |
| Einträge: Anzahl Treffer je Seite (nach eigenem Geschmack einstellbar). | * Nach dem Ändern und Speichern der Datei aus der Zarafa/Kopano WebApp aus- und wieder einloggen. |
| | |
| | ===== Variante B: Benutzer-bezogene Konfiguration ===== |
| | |
| | In der Zarafa/Kopano WebApp unter Einstellungen in der linken Leiste den (neuen) Menüpunkt "Benno" anklicken und dort bitte folgende Werte eintragen: |
| | |
| | * Serveradresse: Bspw. //%%http(s)://<benno-hostname>/benno/rest.php%%//\\ <benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen. |
| | * Benno Container: Bspw. //BennoContainer//\\ Dies ist die Standardeinstellung. Sollten Sie mehrere Container in Benno MailArchiv konfiguriert haben, hier bitte den relevanten Containernamen eintragen. (In der aktuellen Version ist nur der hier angegebene Container nutzbar). |
| | * Einträge: Anzahl Treffer je Seite\\ nach eigenem Geschmack einstellbar. |
| | |
| | ===== Hinweis zur Variante A: ===== |
| |
| Hinweis zur Variante A: | |
| Wenn ein Benutzer die Daten für Serveradresse usw. in seinen WebApp-Einstellungen manuell ändert (bzw. dort manuell welche hinzufügt), ist diese Änderung von der Priorität her höher als die systemweite Vorgabe aus der settings.ini. Die Daten aus der settings.ini haben dann für diesen Benutzer keine Gültigkeit mehr. | Wenn ein Benutzer die Daten für Serveradresse usw. in seinen WebApp-Einstellungen manuell ändert (bzw. dort manuell welche hinzufügt), ist diese Änderung von der Priorität her höher als die systemweite Vorgabe aus der settings.ini. Die Daten aus der settings.ini haben dann für diesen Benutzer keine Gültigkeit mehr. |
| |
| Hinweis zur Benutzer-Authentifizierung: | ====== Benutzer-Authentifizierung ====== |
| Der Benutzer in Benno MailArchiv muss die gleichen Zugangsdaten wie der Benutzer in Zarafa/Kopano haben. Loggt sich z.B. der Benutzer Meier mit den Anmeldedaten "meier:passwort" in Benno MailArchiv ein, müssen die gleichen Zugangsadaten auch für Zarafa/Kopano gültig sein (hier also "meier:passwort"). | Der Benutzer in Benno MailArchiv muss die gleichen Zugangsdaten wie der Benutzer in Zarafa/Kopano haben. Loggt sich z.B. der Benutzer Meier mit den Anmeldedaten "meier:passwort" in Benno MailArchiv ein, müssen die gleichen Zugangsadaten auch für Zarafa/Kopano gültig sein (hier also "meier:passwort"). |
| Soweit Benno MailArchiv und Zarafa/Kopano die gleiche Authentisierungsquelle (bspw. Microsoft ActiveDirectory, LDAP usw.) verwenden, ist dies automatisch gewährleistet. | Soweit Benno MailArchiv und Zarafa/Kopano die gleiche Authentisierungsquelle (bspw. Microsoft ActiveDirectory, LDAP usw.) verwenden, ist dies automatisch gewährleistet. |
| |
| Nutzung des Benno MailArchiv Plugins für Zarafa/Kopano: | ====== Nutzung in Zarafa/Kopano ====== |
| |
| In der waagerechten Menüleiste der Zarafa/Kopano WebApp am oberen Rand des Browserfensters taucht nun ergänzend zu den Menüpunkten HEUTE, MAIL, KALENDER, ... der zusätzliche Menüpunkt BENNO auf. Durch das Anklicken dieses Menüpunktes gelangt man in Suche nach E-mails über das Plugin. Es erscheint die Suchoberfläche des Plugins. Hier können Anwender nun in Benno MailArchiv suchen. Suchen werden durch klicken auf das Symbol "Lupe" oder einfach durch Druck der Enter-Taste gestartet. | In der waagerechten Menüleiste der Zarafa/Kopano WebApp am oberen Rand des Browserfensters taucht nun ergänzend zu den Menüpunkten HEUTE, MAIL, KALENDER, ... der zusätzliche Menüpunkt BENNO auf. Durch das Anklicken dieses Menüpunktes gelangt man in Suche nach E-mails über das Plugin. Es erscheint die Suchoberfläche des Plugins. Hier können Anwender nun in Benno MailArchiv suchen. Suchen werden durch klicken auf das Symbol "Lupe" oder einfach durch Druck der Enter-Taste gestartet. |
| |
| In den nächsten Versionen des Plugins werden folgende Features implementiert (zukünftige Erweiterungen): | ====== Zukünftige Erweiterungen ====== |
| - Konversationssuche | |
| - Containerwahl | In den nächsten Versionen des Plugins werden folgende Features implementiert: |
| - Suchen speichern | |
| | * Konversationssuche |
| | * Containerwahl |
| | * Suchen speichern |
| |
